Google (Gemini) 兼容 API
兼容 Google Gemini generateContent / streamGenerateContent 接口,可直接用 Google AI SDK 接入胜算云调用 Gemini 全系列模型。
https://router.shengsuanyun.com/apiAuthorization: Bearer YOUR_API_KEY端点列表
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" |
key | query / string | Google AI Studio API Key(认证方式1:Query 参数)。从 https://aistudio.google.com/apikey 获取 |
alt | query / string | 响应格式:
- json: 标准 JSON 响应(默认)
- sse: Server-Sent Events 流式响应 "json" | "sse" |
请求体 · 必填
application/json
| 字段 | 类型 | 说明 | |||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
contents必填 | array | 对话内容列表,按时间顺序排列。每条消息包含角色和内容部分(parts)展开结构对话内容列表,按时间顺序排列。每条消息包含角色和内容部分(parts)
数组元素
| |||||||||||||||||||||||||||||||||||||||||||||||||||
systemInstruction | object | 展开结构
| |||||||||||||||||||||||||||||||||||||||||||||||||||
generationConfig | object | 展开结构
| |||||||||||||||||||||||||||||||||||||||||||||||||||
safetySettings | array | 安全设置,用于控制内容过滤的严格程度。可以针对不同类别的有害内容设置不同的阈值展开结构安全设置,用于控制内容过滤的严格程度。可以针对不同类别的有害内容设置不同的阈值
数组元素
| |||||||||||||||||||||||||||||||||||||||||||||||||||
tools | array | 可用工具列表。支持函数调用、Google 搜索、代码执行等多种工具展开结构可用工具列表。支持函数调用、Google 搜索、代码执行等多种工具
数组元素
| |||||||||||||||||||||||||||||||||||||||||||||||||||
toolConfig | object | 展开结构
| |||||||||||||||||||||||||||||||||||||||||||||||||||
cachedContent | string | 缓存内容的名称。使用上下文缓存功能可以减少重复内容的处理,降低延迟和成本 |
{
"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
| 字段 | 类型 | 说明 | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
error | object | 展开结构
|
{
"error": {
"code": 400,
"message": "Invalid request: missing required field 'contents'",
"status": "INVALID_ARGUMENT"
}
}401 认证失败 - API Key 无效或缺失
application/json
| 字段 | 类型 | 说明 | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
error | object | 展开结构
|
{
"error": {
"code": 401,
"message": "Request is missing required authentication credential.",
"status": "UNAUTHENTICATED"
}
}429 请求频率超限 - 超过了 API 调用速率限制或配额
application/json
| 字段 | 类型 | 说明 | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
error | object | 展开结构
|
{
"error": {
"code": 429,
"message": "Resource has been exhausted (e.g. check quota).",
"status": "RESOURCE_EXHAUSTED"
}
}500 服务器内部错误
application/json
| 字段 | 类型 | 说明 | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
error | object | 展开结构
|
{
"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" |
key | query / string | Google AI Studio API Key(认证方式1) |
请求体 · 必填
application/json
| 字段 | 类型 | 说明 | |||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
contents必填 | array | 对话内容列表,按时间顺序排列。每条消息包含角色和内容部分(parts)展开结构对话内容列表,按时间顺序排列。每条消息包含角色和内容部分(parts)
数组元素
| |||||||||||||||||||||||||||||||||||||||||||||||||||
systemInstruction | object | 展开结构
| |||||||||||||||||||||||||||||||||||||||||||||||||||
generationConfig | object | 展开结构
| |||||||||||||||||||||||||||||||||||||||||||||||||||
safetySettings | array | 安全设置,用于控制内容过滤的严格程度。可以针对不同类别的有害内容设置不同的阈值展开结构安全设置,用于控制内容过滤的严格程度。可以针对不同类别的有害内容设置不同的阈值
数组元素
| |||||||||||||||||||||||||||||||||||||||||||||||||||
tools | array | 可用工具列表。支持函数调用、Google 搜索、代码执行等多种工具展开结构可用工具列表。支持函数调用、Google 搜索、代码执行等多种工具
数组元素
| |||||||||||||||||||||||||||||||||||||||||||||||||||
toolConfig | object | 展开结构
| |||||||||||||||||||||||||||||||||||||||||||||||||||
cachedContent | string | 缓存内容的名称。使用上下文缓存功能可以减少重复内容的处理,降低延迟和成本 |
{
"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 版本可能包含实验性模型) |
key | query / string | Google AI Studio API Key |
alt | query / string | 响应格式 "json" | "sse" |
请求体 · 必填
application/json
| 字段 | 类型 | 说明 | |||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
contents必填 | array | 对话内容列表,按时间顺序排列。每条消息包含角色和内容部分(parts)展开结构对话内容列表,按时间顺序排列。每条消息包含角色和内容部分(parts)
数组元素
| |||||||||||||||||||||||||||||||||||||||||||||||||||
systemInstruction | object | 展开结构
| |||||||||||||||||||||||||||||||||||||||||||||||||||
generationConfig | object | 展开结构
| |||||||||||||||||||||||||||||||||||||||||||||||||||
safetySettings | array | 安全设置,用于控制内容过滤的严格程度。可以针对不同类别的有害内容设置不同的阈值展开结构安全设置,用于控制内容过滤的严格程度。可以针对不同类别的有害内容设置不同的阈值
数组元素
| |||||||||||||||||||||||||||||||||||||||||||||||||||
tools | array | 可用工具列表。支持函数调用、Google 搜索、代码执行等多种工具展开结构可用工具列表。支持函数调用、Google 搜索、代码执行等多种工具
数组元素
| |||||||||||||||||||||||||||||||||||||||||||||||||||
toolConfig | object | 展开结构
| |||||||||||||||||||||||||||||||||||||||||||||||||||
cachedContent | string | 缓存内容的名称。使用上下文缓存功能可以减少重复内容的处理,降低延迟和成本 |
{
"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 | 模型名称 |
key | query / string | Google AI Studio API Key |
alt必填 | query / string | 响应格式:
- json: 标准 JSON 响应(默认)
- sse: Server-Sent Events 流式响应 "sse" | "json" |
请求体 · 必填
application/json
| 字段 | 类型 | 说明 | |||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
contents必填 | array | 对话内容列表,按时间顺序排列。每条消息包含角色和内容部分(parts)展开结构对话内容列表,按时间顺序排列。每条消息包含角色和内容部分(parts)
数组元素
| |||||||||||||||||||||||||||||||||||||||||||||||||||
systemInstruction | object | 展开结构
| |||||||||||||||||||||||||||||||||||||||||||||||||||
generationConfig | object | 展开结构
| |||||||||||||||||||||||||||||||||||||||||||||||||||
safetySettings | array | 安全设置,用于控制内容过滤的严格程度。可以针对不同类别的有害内容设置不同的阈值展开结构安全设置,用于控制内容过滤的严格程度。可以针对不同类别的有害内容设置不同的阈值
数组元素
| |||||||||||||||||||||||||||||||||||||||||||||||||||
tools | array | 可用工具列表。支持函数调用、Google 搜索、代码执行等多种工具展开结构可用工具列表。支持函数调用、Google 搜索、代码执行等多种工具
数组元素
| |||||||||||||||||||||||||||||||||||||||||||||||||||
toolConfig | object | 展开结构
| |||||||||||||||||||||||||||||||||||||||||||||||||||
cachedContent | string | 缓存内容的名称。使用上下文缓存功能可以减少重复内容的处理,降低延迟和成本 |
{
"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-Referer | header / string | 用于在胜算云Router中排名的应用网站URL |
X-Title | header / string | 用于在胜算云Router中排名的应用名称 |
请求体
application/json
| 字段 | 类型 | 说明 | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
model必填 | string | 请求使用的模型 ID。 | ||||||||||||
messages | array | 对话的消息列表。展开结构对话的消息列表。
数组元素
| ||||||||||||
stream | boolean | 是否使用流式响应。 | ||||||||||||
online_search | boolean | 是否启用联网搜索功能。 | ||||||||||||
stream_options | OpenAI-Chat%20%E8%AF%B7%E6%B1%82%E4%BD%93-%20StreamOptions | 流式输出相关选项,只有在 stream 参数为 true 时,此参数才有效。 | ||||||||||||
max_tokens | integer | 限制一次请求中模型生成 completion 的最大 token 数。 | ||||||||||||
temperature | number | 采样温度,用于控制模型生成文本的多样性。 更高的值,如 0.8,会使输出更随机,而更低的值,如 0.2,会使其更加集中和确定。 | ||||||||||||
top_p | number | 核采样概率阈值,用于控制模型生成文本的多样性。 top_p 越高,生成的文本更多样。反之,生成的文本更确定。 由于 temperature 与 top_p 均可以控制生成文本的多样性,因此建议您只设置其中一个值。 | ||||||||||||
stop | union | 模型遇到 stop 字段所指定的字符串时将停止继续生成,这个词语本身不会输出。展开结构模型遇到 stop 字段所指定的字符串时将停止继续生成,这个词语本身不会输出。
oneOf · 1
oneOf · 2
数组元素
| ||||||||||||
n | integer | 生成响应的个数。对于需要生成多个响应的场景(如创意写作、广告文案等),可以设置较大的 n 值。 当前仅支持 qwen-plus 、doubao-pro 模型,且在传入 tools 参数时固定为1。 设置较大的 n 值不会增加输入 Token 消耗,会增加输出 Token 的消耗。 | ||||||||||||
frequency_penalty | number | 频率惩罚系数。如果值为正,会根据新 token 在文本中的出现频率对其进行惩罚,从而降低模型逐字重复的可能性。 | ||||||||||||
presence_penalty | number | 存在惩罚系数。如果值为正,会根据新 token 到目前为止是否出现在文本中对其进行惩罚,从而增加模型谈论新主题的可能性。 | ||||||||||||
logprobs | boolean | 是否返回所输出 token 的对数概率。如果为 true,则在 message 的 content 中返回每个输出 token 的对数概率。仅部分模型支持。 | ||||||||||||
top_logprobs | integer | 一个介于 0 到 20 之间的整数 N,指定每个输出位置返回输出概率 top N 的 token,且返回这些 token 的对数概率。指定此参数时,logprobs 必须为 true。 | ||||||||||||
auto_route | boolean | 是否自动路由模型供应商。 | ||||||||||||
supplier | string | 指定模型供应商。只有在 `auto_route=false` 时该参数才会生效。 可选值:"DeepSeek" · "Bytedance" · "OpenRouter" · "Ali" | ||||||||||||
reasoning | object | 设置思维链模式展开结构设置思维链模式
|
{
"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
| 字段 | 类型 | 说明 |
|---|
{}