Gemini 图片生成接口

Gemini 图片生成接口文档。

支持的模型

模型名称	说明
gemini-2.5-flash-image	Gemini 2.5 Flash 图片生成（推荐，稳定）
gemini-3-pro-image-preview	Gemini 3 Pro 图片生成（Preview，可能不稳定）

下文示例中的 MODEL_NAME 为占位符，请替换为上表中的实际模型名称（如 gemini-2.5-flash-image）。

接口地址

Gemini 图片生成支持三种接口格式：

1. OpenAI Images API 格式（推荐）

POST https://www.moyu.info/v1/images/generations

2. Gemini 原生格式

POST https://www.moyu.info/v1beta/models/{model}:generateContent

3. OpenAI Chat Completions 格式

POST https://www.moyu.info/v1/chat/completions

支持的图片比例

size 参数	说明
`1:1`	正方形（默认）
`16:9`	横屏宽幅
`9:16`	竖屏长图
`4:3`	标准横屏
`3:4`	标准竖屏
`3:2`	经典横屏
`2:3`	经典竖屏

请求示例

OpenAI Images API 格式（推荐）

cURL

PowerShell

curl.exe -X POST "https://www.moyu.info/v1/images/generations" `
  -H "Authorization: Bearer YOUR_API_KEY" `
  -H "Content-Type: application/json" `
  -d '{\"model\":\"MODEL_NAME\",\"prompt\":\"A beautiful sunset over the ocean\",\"size\":\"16:9\"}'

Gemini 原生格式

cURL

OpenAI Chat Completions 格式

cURL

注意：Chat Completions 格式返回的图片以 Markdown 格式嵌入在 content 中：![image](data:image/png;base64,...)

代码示例

OpenAI Images API 格式（推荐）

Gemini 原生格式

OpenAI Chat Completions 格式

响应格式

OpenAI Images API 格式响应

{
  "created": 1771905100,
  "data": [
    {
      "b64_json": "iVBORw0KGgoAAAANSUhEUgAAA..."
    }
  ]
}

注意：返回的 b64_json 是 base64 编码的 PNG 图片数据，需要解码后保存为图片文件。

Gemini 原生格式响应

{
  "candidates": [
    {
      "content": {
        "parts": [
          {
            "inlineData": {
              "mimeType": "image/png",
              "data": "iVBORw0KGgoAAAANSUhEUgAAA..."
            }
          }
        ],
        "role": "model"
      },
      "finishReason": "STOP"
    }
  ],
  "createTime": "2026-02-04T10:46:08.309624Z",
  "model": "MODEL_NAME",
  "modelVersion": "gemini-2.5-flash-image",
  "responseId": "cCODafjyEsWnk8sPmqOg2As",
  "usageMetadata": {
    "candidatesTokenCount": 1290,
    "candidatesTokensDetails": [
      {
        "modality": "IMAGE",
        "tokenCount": 1290
      }
    ],
    "promptTokenCount": 6,
    "promptTokensDetails": [
      {
        "modality": "TEXT",
        "tokenCount": 6
      }
    ],
    "totalTokenCount": 1296,
    "trafficType": "ON_DEMAND"
  }
}

OpenAI Chat Completions 格式响应

{
  "id": "chatcmpl-20260204185456102020700aYXwYVxd",
  "model": "MODEL_NAME",
  "object": "chat.completion",
  "created": 1770202505,
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "![image](data:image/png;base64,iVBORw0KGgoAAAANSUhEUg...)"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 3,
    "completion_tokens": 1301,
    "total_tokens": 1304
  }
}

注意：Chat Completions 格式的响应中，图片以 Markdown 格式嵌入在 content 字段中，格式为 ![image](data:image/png;base64,...)，可以直接在支持 Markdown 的环境中显示。

请求参数

OpenAI Images API 格式参数

参数	类型	必填	默认值	说明
model	string	是	-	模型名称，如 `MODEL_NAME`
prompt	string	是	-	图片描述文本
size	string	否	`1:1`	图片比例，支持 `1:1`、`16:9`、`9:16`、`4:3`、`3:4`、`3:2`、`2:3`

关于 n 参数：Google Gemini 官方 generateContent 接口目前不支持一次生成多张图片（candidateCount>1 会被上游拒绝，仅 imagen-* 系列走 predict 接口的 sampleCount 支持多图）。因此本接口对上述 gemini-*-image 模型忽略 n 参数，任意取值均只返回 1 张图。如需多张图，请在业务侧并发调用多次。

Gemini 原生格式参数

参数	类型	必填	默认值	说明
model	string	是	-	模型名称（URL 路径参数），如 `MODEL_NAME`
contents	array	是	-	对话内容列表，包含用户提示词
generationConfig.responseModalities	array	是	-	响应模式，图片生成设置为 `["IMAGE"]`
generationConfig.imageConfig.aspectRatio	string	否	`1:1`	图片比例，支持 `1:1`、`16:9`、`9:16`、`4:3`、`3:4`、`3:2`、`2:3`

完整参数列表请参考 Gemini 官方文档

OpenAI Chat Completions 格式参数

参数	类型	必填	默认值	说明
model	string	是	-	模型名称，如 `MODEL_NAME`
messages	array	是	-	对话消息列表，格式同 OpenAI

注意：Chat Completions 格式自动识别为图片生成，返回的图片以 Markdown 格式嵌入在 content 字段中。

响应字段说明

OpenAI Images API 格式响应字段

字段	类型	说明
created	integer	创建时间戳
data	array	生成的图片列表
data[].b64_json	string	Base64 编码的 PNG 图片数据

Gemini 原生格式响应字段

字段	类型	说明
candidates	array	生成的候选响应列表
candidates[].content.parts	array	响应内容部分
candidates[].content.parts[].inlineData.mimeType	string	图片 MIME 类型，如 image/png
candidates[].content.parts[].inlineData.data	string	Base64 编码的图片数据
candidates[].content.role	string	角色，固定为 model
candidates[].finishReason	string	结束原因：STOP（正常结束）、NO_IMAGE（未生成图片）、SAFETY（安全过滤）
createTime	string	创建时间
model	string	使用的模型名称
modelVersion	string	模型版本
responseId	string	响应的唯一标识符
usageMetadata	object	token 使用情况统计
usageMetadata.promptTokenCount	integer	输入 token 数
usageMetadata.candidatesTokenCount	integer	生成 token 数
usageMetadata.totalTokenCount	integer	总 token 数

OpenAI Chat Completions 格式响应字段

字段	类型	说明
id	string	响应的唯一标识符
model	string	使用的模型名称
object	string	对象类型，固定为 chat.completion
created	integer	创建时间戳
choices	array	生成的候选响应列表
choices[].message.role	string	角色，固定为 assistant
choices[].message.content	string	Markdown 格式的图片：`![image](data:image/png;base64,...)`
choices[].finish_reason	string	结束原因：stop（正常结束）
usage	object	token 使用情况统计
usage.prompt_tokens	integer	输入 token 数
usage.completion_tokens	integer	生成 token 数
usage.total_tokens	integer	总 token 数

支持的模型#

接口地址#

1. OpenAI Images API 格式（推荐）#

2. Gemini 原生格式#

3. OpenAI Chat Completions 格式#

支持的图片比例#

请求示例#

OpenAI Images API 格式（推荐）#

cURL#

PowerShell#

Gemini 原生格式#

cURL#

OpenAI Chat Completions 格式#

cURL#

代码示例#

OpenAI Images API 格式（推荐）#

Gemini 原生格式#

OpenAI Chat Completions 格式#

响应格式#

OpenAI Images API 格式响应#

Gemini 原生格式响应#

OpenAI Chat Completions 格式响应#

请求参数#

OpenAI Images API 格式参数#

Gemini 原生格式参数#

OpenAI Chat Completions 格式参数#

响应字段说明#

OpenAI Images API 格式响应字段#

Gemini 原生格式响应字段#

OpenAI Chat Completions 格式响应字段#

支持的模型

接口地址

1. OpenAI Images API 格式（推荐）

2. Gemini 原生格式

3. OpenAI Chat Completions 格式

支持的图片比例

请求示例

OpenAI Images API 格式（推荐）

cURL

PowerShell

Gemini 原生格式

cURL

OpenAI Chat Completions 格式

cURL

代码示例

OpenAI Images API 格式（推荐）

Gemini 原生格式

OpenAI Chat Completions 格式

响应格式

OpenAI Images API 格式响应

Gemini 原生格式响应

OpenAI Chat Completions 格式响应

请求参数

OpenAI Images API 格式参数

Gemini 原生格式参数

OpenAI Chat Completions 格式参数

响应字段说明

OpenAI Images API 格式响应字段

Gemini 原生格式响应字段

OpenAI Chat Completions 格式响应字段