--- title: Gemini Generate Content url: https://runapi.ai/zh-CN/docs/api/gemini/generate-content.md canonical: https://runapi.ai/zh-CN/docs/api/gemini/generate-content locale: zh-CN --- # Gemini Generate Content ## 概览 使用兼容模型和对应协议的请求、响应结构调用 RunAPI 的 Gemini 兼容 Generate Content operation。 ### 快速开始 1. 创建 API Key，并将其设置为 RUNAPI_API_KEY。 2. 选择兼容模型，然后发送文档所列的路径参数和 JSON 请求体。 3. 读取此 operation 展示的 JSON 响应或服务器发送事件，并处理协议错误。 ## 端点 POST /v1beta/models/{model}:generateContent 基础 URL: https://runapi.ai Contract 版本: v1 首选身份验证: x-goog-api-key: YOUR_API_TOKEN ## 身份验证载体 RunAPI 接受下列每种载体；生成的示例使用该协议的首选请求头。 - `Authorization: Bearer YOUR_API_TOKEN` - `x-api-key: YOUR_API_TOKEN` - `x-goog-api-key: YOUR_API_TOKEN` (首选) - `?key=YOUR_API_TOKEN` ## 兼容模型 打开模型页可查看当前价格、限流和商业使用详情。 - [claude-fable-5](/models/claude) - [claude-sonnet-5](/models/claude) - [claude-opus-5](/models/claude) - [claude-opus-4-8](/models/claude) - [claude-opus-4-7](/models/claude) - [claude-opus-4-6](/models/claude) - [claude-sonnet-4-6](/models/claude) - [claude-opus-4-5-20251101](/models/claude) - [claude-sonnet-4-5-20250929](/models/claude) - [claude-haiku-4-5-20251001](/models/claude) - [claude-opus-4-1-20250805](/models/claude) - [gpt-5.5](/models/gpt) - [gpt-5.5-pro](/models/gpt) - [gpt-5.4](/models/gpt) - [gpt-5.4-mini](/models/gpt) - [gpt-5.4-nano](/models/gpt) - [gpt-5.4-pro](/models/gpt) - [gpt-5.3-codex](/models/gpt) - [gpt-5.3-codex-spark](/models/gpt) - [gpt-5.2](/models/gpt) - [gpt-5.2-pro](/models/gpt) - [gpt-5.6-luna](/models/gpt) - [gpt-5.6-sol](/models/gpt) - [gpt-5.6-terra](/models/gpt) - [gemini-3.5-flash](/models/gemini) - [gemini-3.1-pro-preview](/models/gemini) - [gemini-3-flash-preview](/models/gemini) - [gemini-2.5-pro](/models/gemini) - [gemini-2.5-flash](/models/gemini) - [deepseek-v4-pro](/models/deepseek) - [deepseek-v4-flash](/models/deepseek) - [glm-5.2](/models/glm) - [glm-5.1](/models/glm) - [glm-5-turbo](/models/glm) - [glm-5](/models/glm) - [glm-4.7](/models/glm) - [glm-4.6](/models/glm) - [glm-4.5](/models/glm) - [glm-4.5-air](/models/glm) - [kimi-k3](/models/kimi) - [kimi-k2.7-code](/models/kimi) - [kimi-k2.6](/models/kimi) - [kimi-k2.5](/models/kimi) - [MiniMax-M3](/models/minimax) - [MiniMax-M2.7](/models/minimax) - [MiniMax-M2.7-highspeed](/models/minimax) - [MiniMax-M2.5](/models/minimax) - [MiniMax-M2.5-highspeed](/models/minimax) - [MiniMax-M2.1](/models/minimax) - [MiniMax-M2](/models/minimax) - [grok-4.5](/models/grok) - [grok-4.3](/models/grok) ## 请求 Contract 这里只列出同时具有公共协议与 RunAPI 支持证据的字段；其他 JSON 请求体字段会原样传递。 ### JSON 请求体 必填: `contents` ```json { "contents": { "description": "Conversation content in Gemini Content and Part format.", "type": "array" }, "generationConfig": { "description": "Gemini generation configuration for the request.", "type": "object" }, "systemInstruction": { "description": "System instructions represented as Gemini Content.", "type": "object" }, "tools": { "description": "Tools the model may call.", "type": "array" } } ``` ### 路径参数 必填: `model` ```json { "model": { "description": "RunAPI model identifier placed in the wire path.", "type": "string" } } ``` ### 请求示例 ```json { "contents": [ { "parts": [ { "text": "Say hello in one sentence." } ], "role": "user" } ] } ``` ## 同步响应 HTTP 200 ### Schema ```json { "additionalProperties": true, "properties": { "candidates": { "items": { "additionalProperties": true, "properties": { "content": { "additionalProperties": true, "properties": { "parts": { "type": "array" }, "role": { "type": "string" } }, "type": "object" }, "finishReason": { "type": "string" }, "index": { "type": "integer" } }, "type": "object" }, "type": "array" }, "modelVersion": { "type": "string" }, "responseId": { "type": "string" }, "usageMetadata": { "additionalProperties": true, "properties": { "candidatesTokenCount": { "type": "integer" }, "promptTokenCount": { "type": "integer" }, "totalTokenCount": { "type": "integer" } }, "type": "object" } }, "type": "object" } ``` ### 示例 ```json { "candidates": [ { "content": { "parts": [ { "text": "Hello! How can I help today?" } ], "role": "model" }, "finishReason": "STOP", "index": 0 } ], "modelVersion": "gemini-3.5-flash", "responseId": "resp_example", "usageMetadata": { "candidatesTokenCount": 8, "promptTokenCount": 12, "totalTokenCount": 20 } } ``` ## 协议错误：invalid_request HTTP 400 ### Schema ```json { "additionalProperties": true, "properties": { "error": { "additionalProperties": true, "properties": { "code": { "type": "integer" }, "message": { "type": "string" }, "status": { "type": "string" } }, "required": [ "code", "message", "status" ], "type": "object" } }, "required": [ "error" ], "type": "object" } ``` ### 示例 ```json { "error": { "code": 400, "message": "contents is required", "status": "INVALID_ARGUMENT" } } ``` ## Usage ### Schema ```json { "additionalProperties": true, "properties": { "candidatesTokenCount": { "type": "integer" }, "promptTokenCount": { "type": "integer" }, "totalTokenCount": { "type": "integer" } }, "type": "object" } ``` ### 示例 ```json { "candidatesTokenCount": 8, "promptTokenCount": 12, "totalTokenCount": 20 } ``` ## 生成的代码示例 每个 cURL、JavaScript 和 Python 示例都会发送此 Contract 中经过验证的请求，无需协议专用 SDK。 ### curl ```curl curl -X POST https://runapi.ai/v1beta/models/gemini-3.5-flash:generateContent \ -H x-goog-api-key:\ YOUR_API_TOKEN \ -H Content-Type:\ application/json \ -d \{\"contents\":\[\{\"role\":\"user\",\"parts\":\[\{\"text\":\"Say\ hello\ in\ one\ sentence.\"\}\]\}\]\} ``` ### javascript ```javascript const response = await fetch("https://runapi.ai/v1beta/models/gemini-3.5-flash:generateContent", { method: "POST", headers: { "x-goog-api-key": "YOUR_API_TOKEN", "Content-Type": "application/json" }, body: JSON.stringify({ "contents": [ { "role": "user", "parts": [ { "text": "Say hello in one sentence." } ] } ] }) }); if (!response.ok) throw new Error(`HTTP ${response.status}`); const data = await response.json(); console.log(data); ``` ### python #### 安装 ```bash pip install requests ``` ```python import requests response = requests.post( "https://runapi.ai/v1beta/models/gemini-3.5-flash:generateContent", headers={"x-goog-api-key": "YOUR_API_TOKEN", "Content-Type": "application/json"}, json={"contents": [{"role": "user", "parts": [{"text": "Say hello in one sentence."}]}]} ) response.raise_for_status() print(response.json()) ``` ## 相关指南 - [API 身份验证](/docs/guides/authentication) - [快速开始](/docs/guides/llm-api/quickstart)