Skip to Content
图片生成 / 编辑Gemini

Gemini 图片

Legacy generateContent

Gemini GenerateContent
非流式POST /v1beta/models/{model}:generateContent
流式POST /v1beta/models/{model}:streamGenerateContent?alt=sse

在 URL 路径中填写模型 ID,通过 contents 传入提示词。生成的图片从 candidates[].content.parts[].inlineData 读取。

请求参数

参数类型必填说明
model(路径参数)string是模型 ID,例如 gemini-3.1-flash-image-preview 或 gemini-3-pro-image-preview,填写在 URL 路径中。
contentsarray是输入内容,每项包含 parts 数组。
contents[].rolestring否当前提示词使用 user,历史模型回复使用 model。
contents[].parts[].textstring是描述待生成图片的提示词。
generationConfig.responseModalitiesstring[]否输出类型。文图混合输出使用 [“TEXT”, “IMAGE”]。
generationConfig.imageConfig.aspectRatiostring否图片宽高比,例如 1:1、16:9 或 9:16。
generationConfig.imageConfig.imageSizestring否输出分辨率,可选 1K、2K、4K,其中 K 必须大写。

调用示例

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[].textstring生成的文本,按实际输出返回。
candidates[].content.parts[].inlineData.mimeTypestring图片 MIME 类型,例如 image/png。
candidates[].content.parts[].inlineData.datastringBase64 编码的图片数据,解码后保存为图片文件。
candidates[].finishReasonstring生成结束原因,未返回图片时可结合此字段判断结果。
usageMetadataobjectToken 用量,包含 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[] 中读取文本或图片。响应可能同时包含文本和图片,请遍历所有内容片段获取图片数据。

普通生图

OpenAI Chat
接口POST /v1/chat/completions
  • 如果模型列表中看到的是不带分辨率后缀的 Gemini 图片模型,请使用普通生图方式。
  • 该方式通过请求参数控制分辨率。
  • 计费按当前渠道规则执行,不等同于固定按张价。
模型名分辨率控制计费口径
gemini-3.1-flash-image-previewextra_body.google.image_config.image_size按渠道配置计费
gemini-3-pro-image-previewextra_body.google.image_config.image_size按渠道配置计费

调用示例

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。普通生图需要显式传该参数;如果省略,具体输出尺寸和扣费以渠道默认配置为准。

按张付费生图

OpenAI Chat
接口POST /v1/chat/completions
  • 分辨率由模型名后缀决定。
  • 客户只需要选择对应模型名,不需要额外传 image_size。
计费方式:该类模型按生成图片张数固定计费,不按返回 usage 中的 token 数量计费。单次请求默认生成 1 张图片;如需多张,请发起多次请求。
模型名分辨率档位调用方式
gemini-3.1-flash-image-preview-1k1K/v1/chat/completions
gemini-3.1-flash-image-preview-2k2K/v1/chat/completions
gemini-3.1-flash-image-preview-4k4K/v1/chat/completions
gemini-3-pro-image-preview-1k1K/v1/chat/completions
gemini-3-pro-image-preview-2k2K/v1/chat/completions
gemini-3-pro-image-preview-4k4K/v1/chat/completions

调用示例

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 判断图片价格。

返回示例(伪结构):

{ "choices": [ { "message": { "role": "assistant", "content": "data:image/png;base64,<BASE64>" } } ] }
Last updated on