Gemini 图片
Legacy generateContent
在 URL 路径中填写模型 ID,通过 contents 传入提示词。生成的图片从 candidates[].content.parts[].inlineData 读取。
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model(路径参数) | string | 是 | 模型 ID,例如 gemini-3.1-flash-image-preview 或 gemini-3-pro-image-preview,填写在 URL 路径中。 |
contents | array | 是 | 输入内容,每项包含 parts 数组。 |
contents[].role | string | 否 | 当前提示词使用 user,历史模型回复使用 model。 |
contents[].parts[].text | string | 是 | 描述待生成图片的提示词。 |
generationConfig.responseModalities | string[] | 否 | 输出类型。文图混合输出使用 [“TEXT”, “IMAGE”]。 |
generationConfig.imageConfig.aspectRatio | string | 否 | 图片宽高比,例如 1:1、16:9 或 9:16。 |
generationConfig.imageConfig.imageSize | string | 否 | 输出分辨率,可选 1K、2K、4K,其中 K 必须大写。 |
调用示例
非流式 cURL
curl "https://api.example.com/v1beta/models/gemini-3.1-flash-image-preview:generateContent" \
-H "Authorization: Bearer <YOUR_API_KEY>" \
-H "Content-Type: application/json" \
-d '{
"contents": [
{
"role": "user",
"parts": [
{
"text": "Create a minimalist blue circular app icon on a white background"
}
]
}
],
"generationConfig": {
"responseModalities": [
"TEXT",
"IMAGE"
],
"imageConfig": {
"aspectRatio": "1:1",
"imageSize": "2K"
}
}
}'响应参数
| 字段 | 类型 | 说明 |
|---|---|---|
candidates[].content.parts[].text | string | 生成的文本,按实际输出返回。 |
candidates[].content.parts[].inlineData.mimeType | string | 图片 MIME 类型,例如 image/png。 |
candidates[].content.parts[].inlineData.data | string | Base64 编码的图片数据,解码后保存为图片文件。 |
candidates[].finishReason | string | 生成结束原因,未返回图片时可结合此字段判断结果。 |
usageMetadata | object | Token 用量,包含 promptTokenCount、candidatesTokenCount、totalTokenCount 等字段。 |
非流式响应返回 JSON 对象,例如:
{
"candidates": [
{
"content": {
"role": "model",
"parts": [
{
"inlineData": {
"mimeType": "image/png",
"data": "<BASE64_IMAGE_DATA>"
}
}
]
},
"finishReason": "STOP",
"index": 0
}
]
}流式响应使用 text/event-stream。逐条解析 SSE 事件的 data JSON,从 candidates[].content.parts[] 中读取文本或图片。响应可能同时包含文本和图片,请遍历所有内容片段获取图片数据。
普通生图
- 如果模型列表中看到的是不带分辨率后缀的 Gemini 图片模型,请使用普通生图方式。
- 该方式通过请求参数控制分辨率。
- 计费按当前渠道规则执行,不等同于固定按张价。
| 模型名 | 分辨率控制 | 计费口径 |
|---|---|---|
gemini-3.1-flash-image-preview | extra_body.google.image_config.image_size | 按渠道配置计费 |
gemini-3-pro-image-preview | extra_body.google.image_config.image_size | 按渠道配置计费 |
调用示例
cURL
curl "https://api.example.com/v1/chat/completions" \
-H "Authorization: Bearer <YOUR_API_KEY>" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-3.1-flash-image-preview",
"messages": [
{
"role": "user",
"content": "Create a minimalist blue circular app icon, 1:1, white background, crisp edges"
}
],
"extra_body": {
"google": {
"image_config": {
"aspect_ratio": "1:1",
"image_size": "2K"
}
}
}
}'分辨率参数:
image_size 可传 1K, 2K, 4K。普通生图需要显式传该参数;如果省略,具体输出尺寸和扣费以渠道默认配置为准。按张付费生图
- 分辨率由模型名后缀决定。
- 客户只需要选择对应模型名,不需要额外传
image_size。
计费方式:该类模型按生成图片张数固定计费,不按返回
usage 中的 token 数量计费。单次请求默认生成 1 张图片;如需多张,请发起多次请求。| 模型名 | 分辨率档位 | 调用方式 |
|---|---|---|
gemini-3.1-flash-image-preview-1k | 1K | /v1/chat/completions |
gemini-3.1-flash-image-preview-2k | 2K | /v1/chat/completions |
gemini-3.1-flash-image-preview-4k | 4K | /v1/chat/completions |
gemini-3-pro-image-preview-1k | 1K | /v1/chat/completions |
gemini-3-pro-image-preview-2k | 2K | /v1/chat/completions |
gemini-3-pro-image-preview-4k | 4K | /v1/chat/completions |
调用示例
cURL
curl "https://api.example.com/v1/chat/completions" \
-H "Authorization: Bearer <YOUR_API_KEY>" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-3.1-flash-image-preview-1k",
"messages": [
{
"role": "user",
"content": "Create a minimalist blue circular app icon, 1:1, white background, crisp edges"
}
]
}'不要混用参数:按张生图的分辨率由
-1k, -2k, -4k 模型名决定。请不要再额外传 Gemini 原生的 generationConfig.imageConfig.imageSize,也不要依赖 usage.completion_tokens 判断图片价格。返回示例(伪结构):
JSON
{
"choices": [
{
"message": {
"role": "assistant",
"content": "data:image/png;base64,<BASE64>"
}
}
]
}Last updated on