Gemini
Gemini Generate Content 文本与工具调用模型聚合说明
Gemini 文本能力使用 Gemini 原生 generateContent 协议。不要把 OpenAI 的 messages 写入 Gemini 原生接口；Gemini 使用 contents[].parts[]。
接口路径
| 方法 | 路径 | 用途 |
|---|---|---|
| POST | /v1beta/models/{model}:generateContent | Gemini v1beta 内容生成 |
| POST | /v1/models/{model}:generateContent | Gemini v1 内容生成，OpenAPI schema 中存在 v1 路径 |
| GET | /v1beta/models | Gemini 原生模型列表 |
| GET | /v1beta/openai/models | Gemini 兼容 OpenAI 风格模型列表 |
请求结构
{
"contents": [
{
"role": "user",
"parts": [
{ "text": "请用一句话介绍 Routescope API。" }
]
}
]
}curl -X POST "https://api.routescope.ai/v1beta/models/gpt-4o-mini:generateContent" \ -H "Content-Type: application/json" \ -d '{ "contents": [ { "parts": [ { "text": "写一首四句的中文短诗，主题是城市夜雨。" } ] } ], "generationConfig": { "temperature": 0.7, "maxOutputTokens": 100000 } }'{
"candidates": [],
"usageMetadata": {},
"modelVersion": "string"
}Authorization
BearerAuth
模型 relay 接口鉴权。请求头：Authorization: Bearer 。
In: header
Path Parameters
Gemini 模型名。
Request Body
application/json
输入内容数组，用于承载用户、模型或工具之间的一轮或多轮消息。每个元素是一个 Content 对象，通常包含 role 与 parts：role 表示消息来源，常用 user、model，单轮用户输入可省略；parts 是内容片段数组，可包含 text 文本、inlineData/inline_data Base64 媒体数据（需提供 mime_type 与 data）、functionCall、functionResponse、executableCode 或 codeExecutionResult。适用于文本对话、图片/音频/视频/文档理解、函数调用和多模态生成等场景。数组长度及媒体大小以上游模型和业务配置限制为准。
Gemini 系统指令。
生成配置，例如温度、topK、topP、最大输出长度。
安全策略设置。 safetySettings 列表。范围：数组长度以上游或业务配置为准。
Gemini 工具定义。 工具定义列表。范围：数组长度和 schema 复杂度以上游限制为准。
Response Body
application/json
模型选择表
| 模型 ID | 能力类型 | 适用场景 |
|---|---|---|
gemini-2.5-flash-lite | 内容生成 | 轻量内容生成 |
gemini-2.5-flash | 内容生成 | 低延迟内容生成 |
gemini-2.5-pro | 内容生成 | 复杂文本任务 |
gemini-3.1-flash-lite-preview | 内容生成 | 预览轻量模型 |
gemini-3.1-pro-preview | 内容生成 | 预览 Pro 模型 |
gemini-3-flash-preview | 内容生成 | 预览 Flash 模型 |
gemini-2.5-computer-use-preview-10-2025 | 工具调用 | Computer use / 工具调用场景 |
gemini-3.1-pro-preview-customtools | 工具调用 | 自定义工具调用场景 |
通用参数
| 字段 | 类型 | 必选 | 说明 |
|---|---|---|---|
contents | array | 是 | Gemini 内容数组，文本放在 parts[].text。 |
systemInstruction | object | 否 | 系统指令。 |
generationConfig | object | 否 | 生成配置。 |
safetySettings | array | 否 | 安全策略设置。 |
tools | array | 否 | Gemini 工具定义。 |
模型差异参数
| 字段 | 适用模型 | 差异说明 |
|---|---|---|
路径中的 {model} | 全部 Gemini 模型 | 直接把目标模型 ID 放入路径。 |
tools | gemini-2.5-computer-use-preview-10-2025、gemini-3.1-pro-preview-customtools | 用途为工具调用；普通内容生成模型不要默认携带工具定义。 |
生成配置支持情况 | 全部 | 未统一列出逐模型专属默认值；以接口返回或页面实际展示为准。 |
示例代码
curl "https://api.routescope.ai/v1beta/models/gemini-2.5-flash:generateContent" \
-H "Authorization: Bearer $ROUTESCOPE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"contents": [
{
"role": "user",
"parts": [{ "text": "请用一句话介绍 Routescope API。" }]
}
]
}'响应结构
Gemini 原生响应包含 candidates、content.parts 和 usageMetadata 等字段。不要复用 OpenAI 的 choices[].message 响应结构。
最后更新于