统一模型接入与用量管理 立即注册
蓝天
原站参考文档

以下为胜算云公开资料。文中的原站账号、地址、定价和专有服务不属于蓝天;蓝天可用模型以当前 sub2api 配置为准。接入蓝天请先查看 快速开始。

查看原文

Google (Gemini) 兼容 API

兼容 Google Gemini generateContent / streamGenerateContent 接口,可直接用 Google AI SDK 接入胜算云调用 Gemini 全系列模型。

BASE URLhttps://router.shengsuanyun.com/api
认证方式Authorization: Bearer YOUR_API_KEY

端点列表

← 上一页
Anthropic 兼容 API
下一页 →
模型联网接口

接口参考

以下为原文协议定义与示例,原站地址不代表蓝天已开通对应能力。蓝天接入地址和模型以本地配置为准。

蓝天 API 密钥
POST/v1/models/{model}:generateContent生成内容

使用 Gemini 模型生成内容。支持纯文本、多模态输入(图片、音频、视频、PDF)、工具调用、JSON 模式输出等多种功能,与Google ai studio官方接口相同,更新不及时可参考官方文档。

请求参数

参数位置 / 类型说明
model必填path / string当前仅支持Gemini系列模型,包括图像生成模型,后续会兼容胜算云平台所有模型

"google/gemini-3-pro-preview" | "google/gemini-2.5-flash"

keyquery / stringGoogle AI Studio API Key(认证方式1:Query 参数)。从 https://aistudio.google.com/apikey 获取
altquery / string响应格式: - json: 标准 JSON 响应(默认) - sse: Server-Sent Events 流式响应

"json" | "sse"

请求体 · 必填

application/json
字段类型说明
contents必填array对话内容列表,按时间顺序排列。每条消息包含角色和内容部分(parts)
展开结构

对话内容列表,按时间顺序排列。每条消息包含角色和内容部分(parts)

array

数组元素

Gemini%20Chat%20%E8%AF%B7%E6%B1%82%E4%BD%93-Content

systemInstructionobject
展开结构
字段类型说明
rolestring消息角色: - user: 用户发送的消息 - model: 模型(Gemini)的回复 注意:systemInstruction 中不需要指定 role

可选值:"user" · "model"

parts必填array内容部分列表。一条消息可以包含多个部分(文本、图片、音频、视频、函数调用等)
展开结构

内容部分列表。一条消息可以包含多个部分(文本、图片、音频、视频、函数调用等)

array

数组元素

Gemini%20Chat%20%E8%AF%B7%E6%B1%82%E4%BD%93-Part

generationConfigobject
展开结构
字段类型说明
temperaturenumber采样温度,控制输出的随机性。 - 0.0: 几乎确定性输出 - 1.0: 默认值,平衡创造性和一致性 - 2.0: 最大值,输出更随机 使用场景:创意写作用高温度,数据分析用低温度
topPnumberNucleus sampling 参数。模型会从累积概率达到 topP 的最小 token 集合中采样
topKnumberTop-K sampling 参数。模型只从概率最高的 K 个 token 中采样
maxOutputTokensinteger模型生成响应的最大 token 数量。不同模型有不同的上限: - gemini-1.5-pro: 8192 - gemini-1.5-flash: 8192 - gemini-2.0-flash-exp: 8192
candidateCountinteger生成的候选响应数量。通常设为 1,设置更大值会增加成本
stopSequencesarray自定义停止序列。当模型生成这些字符串之一时,会立即停止生成
展开结构

自定义停止序列。当模型生成这些字符串之一时,会立即停止生成

array

数组元素

string

responseMimeTypestring响应的 MIME 类型。 - text/plain: 纯文本(默认) - application/json: JSON 格式(需配合 responseSchema 使用)

可选值:"text/plain" · "application/json"

responseSchemaobjectJSON Schema 格式的响应结构定义。当 responseMimeType 为 application/json 时使用,强制模型输出符合指定格式的 JSON
展开结构

JSON Schema 格式的响应结构定义。当 responseMimeType 为 application/json 时使用,强制模型输出符合指定格式的 JSON

字段类型说明
presencePenaltynumber存在惩罚。正值会降低已出现 token 的概率,鼓励模型谈论新话题
frequencyPenaltynumber频率惩罚。正值会根据 token 出现频率降低其概率,减少重复内容
responseLogprobsboolean是否返回 logprobs(对数概率)。用于分析模型的置信度
logprobsinteger返回的 top logprobs 数量(每个 token 位置返回概率最高的 N 个候选)
seedinteger随机种子。设置相同的种子可以获得更一致的输出(但不保证完全确定性)
responseModalitiesarray响应模态。指定模型输出的类型
展开结构

响应模态。指定模型输出的类型

array

数组元素

string · "TEXT" | "IMAGE" | "AUDIO"

thinkingConfigGemini%20Chat%20%E8%AF%B7%E6%B1%82%E4%BD%93-ThinkingConfig思考配置。启用后,模型会展示内部推理过程
safetySettingsarray安全设置,用于控制内容过滤的严格程度。可以针对不同类别的有害内容设置不同的阈值
展开结构

安全设置,用于控制内容过滤的严格程度。可以针对不同类别的有害内容设置不同的阈值

array

数组元素

Gemini%20Chat%20%E8%AF%B7%E6%B1%82%E4%BD%93-ChatSafetySettings

toolsarray可用工具列表。支持函数调用、Google 搜索、代码执行等多种工具
展开结构

可用工具列表。支持函数调用、Google 搜索、代码执行等多种工具

array

数组元素

Gemini%20Chat%20%E8%AF%B7%E6%B1%82%E4%BD%93-ChatTool

toolConfigobject
展开结构
字段类型说明
functionCallingConfigGemini%20Chat%20%E8%AF%B7%E6%B1%82%E4%BD%93-FunctionCallingConfig函数调用配置
cachedContentstring缓存内容的名称。使用上下文缓存功能可以减少重复内容的处理,降低延迟和成本
{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "你好,Gemini!请介绍一下你自己。"
        }
      ]
    }
  ]
}

请求示例

参考地址:https://router.shengsuanyun.com。路径参数与凭据需替换;非 JSON 请求体需按对应格式准备。

curl -X POST 'https://router.shengsuanyun.com/v1/models/{model}:generateContent' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  --data '{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "你好,Gemini!请介绍一下你自己。"
        }
      ]
    }
  ]
}'

响应

200 成功响应 - 返回模型生成的内容

application/json

Gemini%20Chat%20%E5%93%8D%E5%BA%94

{
  "candidates": [
    {
      "content": {
        "parts": [
          {
            "text": "你好!我是 Gemini,由 Google 开发的大型语言模型。我可以帮助你进行对话、回答问题、分析图片和视频、编写代码等多种任务。有什么我可以帮助你的吗?"
          }
        ],
        "role": "model"
      },
      "finishReason": "STOP",
      "index": 0,
      "safetyRatings": [
        {
          "category": "HARM_CATEGORY_SEXUALLY_EXPLICIT",
          "probability": "NEGLIGIBLE"
        },
        {
          "category": "HARM_CATEGORY_HATE_SPEECH",
          "probability": "NEGLIGIBLE"
        },
        {
          "category": "HARM_CATEGORY_HARASSMENT",
          "probability": "NEGLIGIBLE"
        },
        {
          "category": "HARM_CATEGORY_DANGEROUS_CONTENT",
          "probability": "NEGLIGIBLE"
        }
      ]
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 8,
    "candidatesTokenCount": 45,
    "totalTokenCount": 53
  }
}

text/event-stream

Server-Sent Events 流式响应(当 alt=sse 时返回)

string

"string"
400 请求错误 - 请求参数格式错误或缺少必需字段

application/json

字段类型说明
errorobject
展开结构
字段类型说明
codeintegerHTTP 错误代码
messagestring详细的错误信息描述
statusstring错误状态码

可选值:"INVALID_ARGUMENT" · "UNAUTHENTICATED" · "PERMISSION_DENIED" · "NOT_FOUND" · "RESOURCE_EXHAUSTED" · "INTERNAL" · "UNAVAILABLE"

{
  "error": {
    "code": 400,
    "message": "Invalid request: missing required field 'contents'",
    "status": "INVALID_ARGUMENT"
  }
}
401 认证失败 - API Key 无效或缺失

application/json

字段类型说明
errorobject
展开结构
字段类型说明
codeintegerHTTP 错误代码
messagestring详细的错误信息描述
statusstring错误状态码

可选值:"INVALID_ARGUMENT" · "UNAUTHENTICATED" · "PERMISSION_DENIED" · "NOT_FOUND" · "RESOURCE_EXHAUSTED" · "INTERNAL" · "UNAVAILABLE"

{
  "error": {
    "code": 401,
    "message": "Request is missing required authentication credential.",
    "status": "UNAUTHENTICATED"
  }
}
429 请求频率超限 - 超过了 API 调用速率限制或配额

application/json

字段类型说明
errorobject
展开结构
字段类型说明
codeintegerHTTP 错误代码
messagestring详细的错误信息描述
statusstring错误状态码

可选值:"INVALID_ARGUMENT" · "UNAUTHENTICATED" · "PERMISSION_DENIED" · "NOT_FOUND" · "RESOURCE_EXHAUSTED" · "INTERNAL" · "UNAVAILABLE"

{
  "error": {
    "code": 429,
    "message": "Resource has been exhausted (e.g. check quota).",
    "status": "RESOURCE_EXHAUSTED"
  }
}
500 服务器内部错误

application/json

字段类型说明
errorobject
展开结构
字段类型说明
codeintegerHTTP 错误代码
messagestring详细的错误信息描述
statusstring错误状态码

可选值:"INVALID_ARGUMENT" · "UNAUTHENTICATED" · "PERMISSION_DENIED" · "NOT_FOUND" · "RESOURCE_EXHAUSTED" · "INTERNAL" · "UNAVAILABLE"

{
  "error": {
    "code": 0,
    "message": "string",
    "status": "INVALID_ARGUMENT"
  }
}
POST/v1/models/{model}:streamGenerateContent流式生成内容

使用 Gemini 模型流式生成内容,实时返回生成的结果

请求参数

参数位置 / 类型说明
model必填path / string模型名称
alt必填query / string响应格式: - json: 标准 JSON 响应(默认) - sse: Server-Sent Events 流式响应

"sse" | "json"

keyquery / stringGoogle AI Studio API Key(认证方式1)

请求体 · 必填

application/json
字段类型说明
contents必填array对话内容列表,按时间顺序排列。每条消息包含角色和内容部分(parts)
展开结构

对话内容列表,按时间顺序排列。每条消息包含角色和内容部分(parts)

array

数组元素

Gemini%20Chat%20%E8%AF%B7%E6%B1%82%E4%BD%93-Content

systemInstructionobject
展开结构
字段类型说明
rolestring消息角色: - user: 用户发送的消息 - model: 模型(Gemini)的回复 注意:systemInstruction 中不需要指定 role

可选值:"user" · "model"

parts必填array内容部分列表。一条消息可以包含多个部分(文本、图片、音频、视频、函数调用等)
展开结构

内容部分列表。一条消息可以包含多个部分(文本、图片、音频、视频、函数调用等)

array

数组元素

Gemini%20Chat%20%E8%AF%B7%E6%B1%82%E4%BD%93-Part

generationConfigobject
展开结构
字段类型说明
temperaturenumber采样温度,控制输出的随机性。 - 0.0: 几乎确定性输出 - 1.0: 默认值,平衡创造性和一致性 - 2.0: 最大值,输出更随机 使用场景:创意写作用高温度,数据分析用低温度
topPnumberNucleus sampling 参数。模型会从累积概率达到 topP 的最小 token 集合中采样
topKnumberTop-K sampling 参数。模型只从概率最高的 K 个 token 中采样
maxOutputTokensinteger模型生成响应的最大 token 数量。不同模型有不同的上限: - gemini-1.5-pro: 8192 - gemini-1.5-flash: 8192 - gemini-2.0-flash-exp: 8192
candidateCountinteger生成的候选响应数量。通常设为 1,设置更大值会增加成本
stopSequencesarray自定义停止序列。当模型生成这些字符串之一时,会立即停止生成
展开结构

自定义停止序列。当模型生成这些字符串之一时,会立即停止生成

array

数组元素

string

responseMimeTypestring响应的 MIME 类型。 - text/plain: 纯文本(默认) - application/json: JSON 格式(需配合 responseSchema 使用)

可选值:"text/plain" · "application/json"

responseSchemaobjectJSON Schema 格式的响应结构定义。当 responseMimeType 为 application/json 时使用,强制模型输出符合指定格式的 JSON
展开结构

JSON Schema 格式的响应结构定义。当 responseMimeType 为 application/json 时使用,强制模型输出符合指定格式的 JSON

字段类型说明
presencePenaltynumber存在惩罚。正值会降低已出现 token 的概率,鼓励模型谈论新话题
frequencyPenaltynumber频率惩罚。正值会根据 token 出现频率降低其概率,减少重复内容
responseLogprobsboolean是否返回 logprobs(对数概率)。用于分析模型的置信度
logprobsinteger返回的 top logprobs 数量(每个 token 位置返回概率最高的 N 个候选)
seedinteger随机种子。设置相同的种子可以获得更一致的输出(但不保证完全确定性)
responseModalitiesarray响应模态。指定模型输出的类型
展开结构

响应模态。指定模型输出的类型

array

数组元素

string · "TEXT" | "IMAGE" | "AUDIO"

thinkingConfigGemini%20Chat%20%E8%AF%B7%E6%B1%82%E4%BD%93-ThinkingConfig思考配置。启用后,模型会展示内部推理过程
safetySettingsarray安全设置,用于控制内容过滤的严格程度。可以针对不同类别的有害内容设置不同的阈值
展开结构

安全设置,用于控制内容过滤的严格程度。可以针对不同类别的有害内容设置不同的阈值

array

数组元素

Gemini%20Chat%20%E8%AF%B7%E6%B1%82%E4%BD%93-ChatSafetySettings

toolsarray可用工具列表。支持函数调用、Google 搜索、代码执行等多种工具
展开结构

可用工具列表。支持函数调用、Google 搜索、代码执行等多种工具

array

数组元素

Gemini%20Chat%20%E8%AF%B7%E6%B1%82%E4%BD%93-ChatTool

toolConfigobject
展开结构
字段类型说明
functionCallingConfigGemini%20Chat%20%E8%AF%B7%E6%B1%82%E4%BD%93-FunctionCallingConfig函数调用配置
cachedContentstring缓存内容的名称。使用上下文缓存功能可以减少重复内容的处理,降低延迟和成本
{
  "contents": [
    "string"
  ],
  "systemInstruction": {
    "role": "user",
    "parts": [
      "string"
    ]
  },
  "generationConfig": {
    "temperature": 0,
    "topP": 0,
    "topK": 0,
    "maxOutputTokens": 0,
    "candidateCount": 1,
    "stopSequences": [
      "string"
    ],
    "responseMimeType": "text/plain",
    "responseSchema": {},
    "presencePenalty": 0,
    "frequencyPenalty": 0,
    "responseLogprobs": false,
    "logprobs": 0,
    "seed": 0,
    "responseModalities": [
      "TEXT"
    ],
    "thinkingConfig": "string"
  },
  "safetySettings": [
    "string"
  ],
  "tools": [
    "string"
  ],
  "toolConfig": {
    "functionCallingConfig": "string"
  },
  "cachedContent": "string"
}

请求示例

参考地址:https://router.shengsuanyun.com。路径参数与凭据需替换;非 JSON 请求体需按对应格式准备。

curl -X POST 'https://router.shengsuanyun.com/v1/models/{model}:streamGenerateContent?alt=sse' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  --data '{
  "contents": [
    "string"
  ],
  "systemInstruction": {
    "role": "user",
    "parts": [
      "string"
    ]
  },
  "generationConfig": {
    "temperature": 0,
    "topP": 0,
    "topK": 0,
    "maxOutputTokens": 0,
    "candidateCount": 1,
    "stopSequences": [
      "string"
    ],
    "responseMimeType": "text/plain",
    "responseSchema": {},
    "presencePenalty": 0,
    "frequencyPenalty": 0,
    "responseLogprobs": false,
    "logprobs": 0,
    "seed": 0,
    "responseModalities": [
      "TEXT"
    ],
    "thinkingConfig": "string"
  },
  "safetySettings": [
    "string"
  ],
  "tools": [
    "string"
  ],
  "toolConfig": {
    "functionCallingConfig": "string"
  },
  "cachedContent": "string"
}'

响应

200 成功 - 返回流式响应

application/json

流式 JSON 响应,每行一个 JSON 对象

string

"string"
POST/v1beta/models/{model}:generateContent生成内容(Beta)

使用 Gemini 模型生成内容(Beta 版本,支持最新实验性功能)

请求参数

参数位置 / 类型说明
model必填path / string模型名称(Beta 版本可能包含实验性模型)
keyquery / stringGoogle AI Studio API Key
altquery / string响应格式

"json" | "sse"

请求体 · 必填

application/json
字段类型说明
contents必填array对话内容列表,按时间顺序排列。每条消息包含角色和内容部分(parts)
展开结构

对话内容列表,按时间顺序排列。每条消息包含角色和内容部分(parts)

array

数组元素

Gemini%20Chat%20%E8%AF%B7%E6%B1%82%E4%BD%93-Content

systemInstructionobject
展开结构
字段类型说明
rolestring消息角色: - user: 用户发送的消息 - model: 模型(Gemini)的回复 注意:systemInstruction 中不需要指定 role

可选值:"user" · "model"

parts必填array内容部分列表。一条消息可以包含多个部分(文本、图片、音频、视频、函数调用等)
展开结构

内容部分列表。一条消息可以包含多个部分(文本、图片、音频、视频、函数调用等)

array

数组元素

Gemini%20Chat%20%E8%AF%B7%E6%B1%82%E4%BD%93-Part

generationConfigobject
展开结构
字段类型说明
temperaturenumber采样温度,控制输出的随机性。 - 0.0: 几乎确定性输出 - 1.0: 默认值,平衡创造性和一致性 - 2.0: 最大值,输出更随机 使用场景:创意写作用高温度,数据分析用低温度
topPnumberNucleus sampling 参数。模型会从累积概率达到 topP 的最小 token 集合中采样
topKnumberTop-K sampling 参数。模型只从概率最高的 K 个 token 中采样
maxOutputTokensinteger模型生成响应的最大 token 数量。不同模型有不同的上限: - gemini-1.5-pro: 8192 - gemini-1.5-flash: 8192 - gemini-2.0-flash-exp: 8192
candidateCountinteger生成的候选响应数量。通常设为 1,设置更大值会增加成本
stopSequencesarray自定义停止序列。当模型生成这些字符串之一时,会立即停止生成
展开结构

自定义停止序列。当模型生成这些字符串之一时,会立即停止生成

array

数组元素

string

responseMimeTypestring响应的 MIME 类型。 - text/plain: 纯文本(默认) - application/json: JSON 格式(需配合 responseSchema 使用)

可选值:"text/plain" · "application/json"

responseSchemaobjectJSON Schema 格式的响应结构定义。当 responseMimeType 为 application/json 时使用,强制模型输出符合指定格式的 JSON
展开结构

JSON Schema 格式的响应结构定义。当 responseMimeType 为 application/json 时使用,强制模型输出符合指定格式的 JSON

字段类型说明
presencePenaltynumber存在惩罚。正值会降低已出现 token 的概率,鼓励模型谈论新话题
frequencyPenaltynumber频率惩罚。正值会根据 token 出现频率降低其概率,减少重复内容
responseLogprobsboolean是否返回 logprobs(对数概率)。用于分析模型的置信度
logprobsinteger返回的 top logprobs 数量(每个 token 位置返回概率最高的 N 个候选)
seedinteger随机种子。设置相同的种子可以获得更一致的输出(但不保证完全确定性)
responseModalitiesarray响应模态。指定模型输出的类型
展开结构

响应模态。指定模型输出的类型

array

数组元素

string · "TEXT" | "IMAGE" | "AUDIO"

thinkingConfigGemini%20Chat%20%E8%AF%B7%E6%B1%82%E4%BD%93-ThinkingConfig思考配置。启用后,模型会展示内部推理过程
safetySettingsarray安全设置,用于控制内容过滤的严格程度。可以针对不同类别的有害内容设置不同的阈值
展开结构

安全设置,用于控制内容过滤的严格程度。可以针对不同类别的有害内容设置不同的阈值

array

数组元素

Gemini%20Chat%20%E8%AF%B7%E6%B1%82%E4%BD%93-ChatSafetySettings

toolsarray可用工具列表。支持函数调用、Google 搜索、代码执行等多种工具
展开结构

可用工具列表。支持函数调用、Google 搜索、代码执行等多种工具

array

数组元素

Gemini%20Chat%20%E8%AF%B7%E6%B1%82%E4%BD%93-ChatTool

toolConfigobject
展开结构
字段类型说明
functionCallingConfigGemini%20Chat%20%E8%AF%B7%E6%B1%82%E4%BD%93-FunctionCallingConfig函数调用配置
cachedContentstring缓存内容的名称。使用上下文缓存功能可以减少重复内容的处理,降低延迟和成本
{
  "contents": [
    "string"
  ],
  "systemInstruction": {
    "role": "user",
    "parts": [
      "string"
    ]
  },
  "generationConfig": {
    "temperature": 0,
    "topP": 0,
    "topK": 0,
    "maxOutputTokens": 0,
    "candidateCount": 1,
    "stopSequences": [
      "string"
    ],
    "responseMimeType": "text/plain",
    "responseSchema": {},
    "presencePenalty": 0,
    "frequencyPenalty": 0,
    "responseLogprobs": false,
    "logprobs": 0,
    "seed": 0,
    "responseModalities": [
      "TEXT"
    ],
    "thinkingConfig": "string"
  },
  "safetySettings": [
    "string"
  ],
  "tools": [
    "string"
  ],
  "toolConfig": {
    "functionCallingConfig": "string"
  },
  "cachedContent": "string"
}

请求示例

参考地址:https://router.shengsuanyun.com。路径参数与凭据需替换;非 JSON 请求体需按对应格式准备。

curl -X POST 'https://router.shengsuanyun.com/v1beta/models/{model}:generateContent' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  --data '{
  "contents": [
    "string"
  ],
  "systemInstruction": {
    "role": "user",
    "parts": [
      "string"
    ]
  },
  "generationConfig": {
    "temperature": 0,
    "topP": 0,
    "topK": 0,
    "maxOutputTokens": 0,
    "candidateCount": 1,
    "stopSequences": [
      "string"
    ],
    "responseMimeType": "text/plain",
    "responseSchema": {},
    "presencePenalty": 0,
    "frequencyPenalty": 0,
    "responseLogprobs": false,
    "logprobs": 0,
    "seed": 0,
    "responseModalities": [
      "TEXT"
    ],
    "thinkingConfig": "string"
  },
  "safetySettings": [
    "string"
  ],
  "tools": [
    "string"
  ],
  "toolConfig": {
    "functionCallingConfig": "string"
  },
  "cachedContent": "string"
}'

响应

200 成功响应

application/json

Gemini%20Chat%20%E5%93%8D%E5%BA%94

"string"
POST/v1beta/models/{model}:streamGenerateContent流式生成内容(Beta)

使用 Gemini 模型流式生成内容(Beta 版本)

请求参数

参数位置 / 类型说明
model必填path / string模型名称
keyquery / stringGoogle AI Studio API Key
alt必填query / string响应格式: - json: 标准 JSON 响应(默认) - sse: Server-Sent Events 流式响应

"sse" | "json"

请求体 · 必填

application/json
字段类型说明
contents必填array对话内容列表,按时间顺序排列。每条消息包含角色和内容部分(parts)
展开结构

对话内容列表,按时间顺序排列。每条消息包含角色和内容部分(parts)

array

数组元素

Gemini%20Chat%20%E8%AF%B7%E6%B1%82%E4%BD%93-Content

systemInstructionobject
展开结构
字段类型说明
rolestring消息角色: - user: 用户发送的消息 - model: 模型(Gemini)的回复 注意:systemInstruction 中不需要指定 role

可选值:"user" · "model"

parts必填array内容部分列表。一条消息可以包含多个部分(文本、图片、音频、视频、函数调用等)
展开结构

内容部分列表。一条消息可以包含多个部分(文本、图片、音频、视频、函数调用等)

array

数组元素

Gemini%20Chat%20%E8%AF%B7%E6%B1%82%E4%BD%93-Part

generationConfigobject
展开结构
字段类型说明
temperaturenumber采样温度,控制输出的随机性。 - 0.0: 几乎确定性输出 - 1.0: 默认值,平衡创造性和一致性 - 2.0: 最大值,输出更随机 使用场景:创意写作用高温度,数据分析用低温度
topPnumberNucleus sampling 参数。模型会从累积概率达到 topP 的最小 token 集合中采样
topKnumberTop-K sampling 参数。模型只从概率最高的 K 个 token 中采样
maxOutputTokensinteger模型生成响应的最大 token 数量。不同模型有不同的上限: - gemini-1.5-pro: 8192 - gemini-1.5-flash: 8192 - gemini-2.0-flash-exp: 8192
candidateCountinteger生成的候选响应数量。通常设为 1,设置更大值会增加成本
stopSequencesarray自定义停止序列。当模型生成这些字符串之一时,会立即停止生成
展开结构

自定义停止序列。当模型生成这些字符串之一时,会立即停止生成

array

数组元素

string

responseMimeTypestring响应的 MIME 类型。 - text/plain: 纯文本(默认) - application/json: JSON 格式(需配合 responseSchema 使用)

可选值:"text/plain" · "application/json"

responseSchemaobjectJSON Schema 格式的响应结构定义。当 responseMimeType 为 application/json 时使用,强制模型输出符合指定格式的 JSON
展开结构

JSON Schema 格式的响应结构定义。当 responseMimeType 为 application/json 时使用,强制模型输出符合指定格式的 JSON

字段类型说明
presencePenaltynumber存在惩罚。正值会降低已出现 token 的概率,鼓励模型谈论新话题
frequencyPenaltynumber频率惩罚。正值会根据 token 出现频率降低其概率,减少重复内容
responseLogprobsboolean是否返回 logprobs(对数概率)。用于分析模型的置信度
logprobsinteger返回的 top logprobs 数量(每个 token 位置返回概率最高的 N 个候选)
seedinteger随机种子。设置相同的种子可以获得更一致的输出(但不保证完全确定性)
responseModalitiesarray响应模态。指定模型输出的类型
展开结构

响应模态。指定模型输出的类型

array

数组元素

string · "TEXT" | "IMAGE" | "AUDIO"

thinkingConfigGemini%20Chat%20%E8%AF%B7%E6%B1%82%E4%BD%93-ThinkingConfig思考配置。启用后,模型会展示内部推理过程
safetySettingsarray安全设置,用于控制内容过滤的严格程度。可以针对不同类别的有害内容设置不同的阈值
展开结构

安全设置,用于控制内容过滤的严格程度。可以针对不同类别的有害内容设置不同的阈值

array

数组元素

Gemini%20Chat%20%E8%AF%B7%E6%B1%82%E4%BD%93-ChatSafetySettings

toolsarray可用工具列表。支持函数调用、Google 搜索、代码执行等多种工具
展开结构

可用工具列表。支持函数调用、Google 搜索、代码执行等多种工具

array

数组元素

Gemini%20Chat%20%E8%AF%B7%E6%B1%82%E4%BD%93-ChatTool

toolConfigobject
展开结构
字段类型说明
functionCallingConfigGemini%20Chat%20%E8%AF%B7%E6%B1%82%E4%BD%93-FunctionCallingConfig函数调用配置
cachedContentstring缓存内容的名称。使用上下文缓存功能可以减少重复内容的处理,降低延迟和成本
{
  "contents": [
    "string"
  ],
  "systemInstruction": {
    "role": "user",
    "parts": [
      "string"
    ]
  },
  "generationConfig": {
    "temperature": 0,
    "topP": 0,
    "topK": 0,
    "maxOutputTokens": 0,
    "candidateCount": 1,
    "stopSequences": [
      "string"
    ],
    "responseMimeType": "text/plain",
    "responseSchema": {},
    "presencePenalty": 0,
    "frequencyPenalty": 0,
    "responseLogprobs": false,
    "logprobs": 0,
    "seed": 0,
    "responseModalities": [
      "TEXT"
    ],
    "thinkingConfig": "string"
  },
  "safetySettings": [
    "string"
  ],
  "tools": [
    "string"
  ],
  "toolConfig": {
    "functionCallingConfig": "string"
  },
  "cachedContent": "string"
}

请求示例

参考地址:https://router.shengsuanyun.com。路径参数与凭据需替换;非 JSON 请求体需按对应格式准备。

curl -X POST 'https://router.shengsuanyun.com/v1beta/models/{model}:streamGenerateContent?alt=sse' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  --data '{
  "contents": [
    "string"
  ],
  "systemInstruction": {
    "role": "user",
    "parts": [
      "string"
    ]
  },
  "generationConfig": {
    "temperature": 0,
    "topP": 0,
    "topK": 0,
    "maxOutputTokens": 0,
    "candidateCount": 1,
    "stopSequences": [
      "string"
    ],
    "responseMimeType": "text/plain",
    "responseSchema": {},
    "presencePenalty": 0,
    "frequencyPenalty": 0,
    "responseLogprobs": false,
    "logprobs": 0,
    "seed": 0,
    "responseModalities": [
      "TEXT"
    ],
    "thinkingConfig": "string"
  },
  "safetySettings": [
    "string"
  ],
  "tools": [
    "string"
  ],
  "toolConfig": {
    "functionCallingConfig": "string"
  },
  "cachedContent": "string"
}'

响应

200 成功 - 返回流式响应

application/json

流式 JSON 响应

string

"string"
POST/v1/chat/completions*【Google】NB-1图像生成-chat接口(同步)

与AI模型进行多轮对话

请求参数

参数位置 / 类型说明
HTTP-Refererheader / string用于在胜算云Router中排名的应用网站URL
X-Titleheader / string用于在胜算云Router中排名的应用名称

请求体

application/json
字段类型说明
model必填string请求使用的模型 ID。
messagesarray对话的消息列表。
展开结构

对话的消息列表。

array

数组元素

OpenAI-Chat%20%E8%AF%B7%E6%B1%82%E4%BD%93-Message

streamboolean是否使用流式响应。
online_searchboolean是否启用联网搜索功能。
stream_optionsOpenAI-Chat%20%E8%AF%B7%E6%B1%82%E4%BD%93-%20StreamOptions流式输出相关选项,只有在 stream 参数为 true 时,此参数才有效。
max_tokensinteger限制一次请求中模型生成 completion 的最大 token 数。
temperaturenumber采样温度,用于控制模型生成文本的多样性。 更高的值,如 0.8,会使输出更随机,而更低的值,如 0.2,会使其更加集中和确定。
top_pnumber核采样概率阈值,用于控制模型生成文本的多样性。 top_p 越高,生成的文本更多样。反之,生成的文本更确定。 由于 temperature 与 top_p 均可以控制生成文本的多样性,因此建议您只设置其中一个值。
stopunion模型遇到 stop 字段所指定的字符串时将停止继续生成,这个词语本身不会输出。
展开结构

模型遇到 stop 字段所指定的字符串时将停止继续生成,这个词语本身不会输出。

union

oneOf · 1

string

oneOf · 2

array

数组元素

string

ninteger生成响应的个数。对于需要生成多个响应的场景(如创意写作、广告文案等),可以设置较大的 n 值。 当前仅支持 qwen-plus 、doubao-pro 模型,且在传入 tools 参数时固定为1。 设置较大的 n 值不会增加输入 Token 消耗,会增加输出 Token 的消耗。
frequency_penaltynumber频率惩罚系数。如果值为正,会根据新 token 在文本中的出现频率对其进行惩罚,从而降低模型逐字重复的可能性。
presence_penaltynumber存在惩罚系数。如果值为正,会根据新 token 到目前为止是否出现在文本中对其进行惩罚,从而增加模型谈论新主题的可能性。
logprobsboolean是否返回所输出 token 的对数概率。如果为 true,则在 message 的 content 中返回每个输出 token 的对数概率。仅部分模型支持。
top_logprobsinteger一个介于 0 到 20 之间的整数 N,指定每个输出位置返回输出概率 top N 的 token,且返回这些 token 的对数概率。指定此参数时,logprobs 必须为 true。
auto_routeboolean是否自动路由模型供应商。
supplierstring指定模型供应商。只有在 `auto_route=false` 时该参数才会生效。

可选值:"DeepSeek" · "Bytedance" · "OpenRouter" · "Ali"

reasoningobject设置思维链模式
展开结构

设置思维链模式

字段类型说明
effortstring支持允许控制思维链长度模型

可选值:"low" · "medium" · "high"

max_tokensinteger最大推理Token数,控制非OpenAI思考模型思维链长度
typestring开启和关闭思考模式,可选参数: **enabled**、**disabled** 支持大多数混合推理模型
{
  "stream": true,
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "这是一张道路图片"
        },
        {
          "type": "image_url",
          "image_url": {
            "url": "https://upload.wikimedia.org/wikipedia/commons/thumb/d/dd/Gfp-wisconsin-madison-the-nature-boardwalk.jpg/2560px-Gfp-wisconsin-madison-the-nature-boardwalk.jpg"
          }
        },
        {
          "type": "text",
          "text": "生成一张小女孩在这张图片中的道路上奔跑的图片,必须生成一张图片"
        }
      ]
    }
  ],
  "stream_options": {
    "include_usage": true
  },
  "model": "google/gemini-2.5-flash-image"
}

请求示例

参考地址:https://router.shengsuanyun.com。路径参数与凭据需替换;非 JSON 请求体需按对应格式准备。

curl -X POST 'https://router.shengsuanyun.com/v1/chat/completions' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  --data '{
  "stream": true,
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "这是一张道路图片"
        },
        {
          "type": "image_url",
          "image_url": {
            "url": "https://upload.wikimedia.org/wikipedia/commons/thumb/d/dd/Gfp-wisconsin-madison-the-nature-boardwalk.jpg/2560px-Gfp-wisconsin-madison-the-nature-boardwalk.jpg"
          }
        },
        {
          "type": "text",
          "text": "生成一张小女孩在这张图片中的道路上奔跑的图片,必须生成一张图片"
        }
      ]
    }
  ],
  "stream_options": {
    "include_usage": true
  },
  "model": "google/gemini-2.5-flash-image"
}'

响应

200 请求成功

application/json

OpenAI%20Chat%20%E5%93%8D%E5%BA%94%E4%BD%93

{
  "id": "2025102912501117466000AxcO7O3t",
  "provider": "Google",
  "model": "google/gemini-2.5-flash-image",
  "object": "chat.completion",
  "created": 1761713411,
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "这是您要的图片:一个小女孩在道路上奔跑",
        "images": [
          {
            "type": "image_url",
            "image_url": {
              "url": "data:image/png;base64,iVBORw0KGgo..."
            },
            "index": 0
          }
        ]
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 3376,
    "completion_tokens": 1290,
    "total_tokens": 4666
  }
}
400 参数错误

application/json

字段类型说明
{}
POST/v1/images/generations*【Google】NB-1、NB-Pro 图像生成(同步)

nano banana pro / nano banana 1 模型进行同步图像生成。支持文生图、图生图(编辑)和多图参考。

请求参数

参数位置 / 类型说明
Content-Type必填header / string

请求体

application/json

union

anyOf · 1

常规请求体

Gemini%20%E5%9B%BE%E7%89%87%E7%94%9F%E6%88%90%E8%AF%B7%E6%B1%82%E4%BD%93-%E5%B8%B8%E8%A7%84

anyOf · 2

对话式构建请求体

Gemini%20%E5%9B%BE%E7%89%87%E7%94%9F%E6%88%90%E8%AF%B7%E6%B1%82%E4%BD%93-Messages

{
  "model": "google/gemini-2.5-flash-image",
  "system": "You are a professional image generation expert. You need to generate pictures based on the user's description. Note that you must generate at least one picture.",
  "messages": [
    {
      "text": "这是一张背景图:"
    },
    {
      "image": "https://**.jpg"
    },
    {
      "text": "You need to help me add elements from the reference image to the original image"
    },
    {
      "text": "Reference Image 1: 风格图"
    },
    {
      "image": "https://**.png"
    },
    {
      "text": "Reference Image 2: 一座房子"
    },
    {
      "image": "https://**.png"
    }
  ]
}

请求示例

参考地址:https://router.shengsuanyun.com。路径参数与凭据需替换;非 JSON 请求体需按对应格式准备。

curl -X POST 'https://router.shengsuanyun.com/v1/images/generations' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  --data '{
  "model": "google/gemini-2.5-flash-image",
  "system": "You are a professional image generation expert. You need to generate pictures based on the user'\''s description. Note that you must generate at least one picture.",
  "messages": [
    {
      "text": "这是一张背景图:"
    },
    {
      "image": "https://**.jpg"
    },
    {
      "text": "You need to help me add elements from the reference image to the original image"
    },
    {
      "text": "Reference Image 1: 风格图"
    },
    {
      "image": "https://**.png"
    },
    {
      "text": "Reference Image 2: 一座房子"
    },
    {
      "image": "https://**.png"
    }
  ]
}'

响应

200 成功响应

application/json

Gemini%20Chat%20%E5%93%8D%E5%BA%94

"string"
400 请求参数错误

application/json

字段类型说明
{}
401 认证失败

application/json

字段类型说明
{}
500 服务器错误

application/json

字段类型说明
{}