Skip to main content
POST
/
v1beta
/
models
/
{image-model}
:generateContent
curl -X POST "https://gogogotoken.ai/v1beta/models/gemini-2.5-flash-image:generateContent" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{
      "parts": [{ "text": "A watercolor painting of a coastal village at sunset" }]
    }],
    "generationConfig": {
      "responseModalities": ["TEXT", "IMAGE"]
    }
  }'

{
  "candidates": [
    {
      "content": {
        "parts": [
          { "text": "Here is the image." },
          {
            "inlineData": {
              "mimeType": "image/png",
              "data": "<base64>"
            }
          }
        ]
      }
    }
  ]
}
使用 Gemini 原生 generateContent API 调用图像输出模型，适用于 Gemini 图像模型与使用 Gemini 原生 generateContent API 调用图像输出模型，适用于 Gemini 图像模型与已使用 Gemini 官方 SDK 的项目。 
curl -X POST "https://gogogotoken.ai/v1beta/models/gemini-2.5-flash-image:generateContent" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{
      "parts": [{ "text": "A watercolor painting of a coastal village at sunset" }]
    }],
    "generationConfig": {
      "responseModalities": ["TEXT", "IMAGE"]
    }
  }'

{
  "candidates": [
    {
      "content": {
        "parts": [
          { "text": "Here is the image." },
          {
            "inlineData": {
              "mimeType": "image/png",
              "data": "<base64>"
            }
          }
        ]
      }
    }
  ]
}

​
接口说明

Gemini 图像模型通常通过 inlineData 返回 base64 图片数据。前端展示前需要拼接为 data:image/png;base64,...，或解码为 Blob 再渲染。
如需稳定获得图片输出，建议在 generationConfig.responseModalities 中包含 "IMAGE"。

​
路径参数

​
image-model
string
default:"gemini-2.5-flash-image"
required
Gemini 图像模型 ID，例如 gemini-2.5-flash-image。完整模型 ID 以 GET /v1/models 与模型广场为准。

​
请求头

​
Authorization
string
required
API Key 鉴权信息，格式为 Bearer YOUR_API_KEY。
​
Content-Type
string
required
固定为 application/json。

​
请求体

​
contents
object[]
required
生成请求内容数组。
​
parts
object[]
required
内容片段数组，通常包含图片描述文本，也可以包含参考图等多模态输入。
​
generationConfig.responseModalities
string[]
default:["TEXT","IMAGE"]
响应模态。图像生成建议包含 IMAGE，需要文字说明时可同时包含 TEXT。
​
generationConfig.temperature
number
采样温度。数值越高，结果越发散。

​
响应体

​
candidates
object[]
模型候选输出数组。
​
content.parts
object[]
输出内容片段数组，可能同时包含文本和图片。
​
inlineData.mimeType
string
图片 MIME 类型，例如 image/png。
​
inlineData.data
string
base64 编码的图片内容。

​
调用方式对比

方式端点适用场景
Gemini 原生/v1beta/models/{model}:generateContent已使用 Gemini 官方 SDK、需多模态原生能力
OpenAI 兼容/v1/images/generations已使用 OpenAI SDK、想统一图像调用入口
OpenAI 兼容转发需渠道侧已配置 Gemini 图像桥接，使用前请先确认。

​
错误码

状态码含义处理建议
401API Key 无效或未传检查请求头与令牌状态
403无权限访问目标 Gemini 图像模型检查 API Key 分组权限
429触发限速降低请求频率或调整套餐
5xx上游或网关异常稍后重试，并查看控制台日志
curl -X POST "https://gogogotoken.ai/v1beta/models/gemini-2.5-flash-image:generateContent" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{
      "parts": [{ "text": "A watercolor painting of a coastal village at sunset" }]
    }],
    "generationConfig": {
      "responseModalities": ["TEXT", "IMAGE"]
    }
  }'

{
  "candidates": [
    {
      "content": {
        "parts": [
          { "text": "Here is the image." },
          {
            "inlineData": {
              "mimeType": "image/png",
              "data": "<base64>"
            }
          }
        ]
      }
    }
  ]
}

​
接口说明

Gemini 图像模型通常通过 inlineData 返回 base64 图片数据。前端展示前需要拼接为 data:image/png;base64,...，或解码为 Blob 再渲染。
如需稳定获得图片输出，建议在 generationConfig.responseModalities 中包含 "IMAGE"。

​
路径参数

​
image-model
string
default:"gemini-2.5-flash-image"
required
Gemini 图像模型 ID，例如 gemini-2.5-flash-image。完整模型 ID 以 GET /v1/models 与模型广场为准。

​
请求头

​
Authorization
string
required
API Key 鉴权信息，格式为 Bearer YOUR_API_KEY。
​
Content-Type
string
required
固定为 application/json。

​
请求体

​
contents
object[]
required
生成请求内容数组。
​
parts
object[]
required
内容片段数组，通常包含图片描述文本，也可以包含参考图等多模态输入。
​
generationConfig.responseModalities
string[]
default:["TEXT","IMAGE"]
响应模态。图像生成建议包含 IMAGE，需要文字说明时可同时包含 TEXT。
​
generationConfig.temperature
number
采样温度。数值越高，结果越发散。

​
响应体

​
candidates
object[]
模型候选输出数组。
​
content.parts
object[]
输出内容片段数组，可能同时包含文本和图片。
​
inlineData.mimeType
string
图片 MIME 类型，例如 image/png。
​
inlineData.data
string
base64 编码的图片内容。

​
调用方式对比

方式端点适用场景
Gemini 原生/v1beta/models/{model}:generateContent已使用 Gemini 官方 SDK、需多模态原生能力
OpenAI 兼容/v1/images/generations已使用 OpenAI SDK、想统一图像调用入口
OpenAI 兼容转发需渠道侧已配置 Gemini 图像桥接，使用前请先确认。

​
错误码

状态码含义处理建议
401API Key 无效或未传检查请求头与令牌状态
403无权限访问目标 Gemini 图像模型检查 API Key 分组权限
429触发限速降低请求频率或调整套餐
5xx上游或网关异常稍后重试，并查看控制台日志