图像

POST

/v1beta/models/{model}:generateContent

Google Gemini · 图像（generateContent 原生格式）

模型清单（路径参数 model）：

gemini-2.5-flash-image

gemini-3-pro-image

gemini-3.1-flash-image

gemini-3.1-flash-lite-image

调用注意：

参考图放在 contents[].parts[].inlineData（Base64）

responseModalities 必须包含 IMAGE

gemini-2.5-flash-image 不支持 imageSize

图像带 SynthID 水印

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Path 参数

Body 参数application/json

示例

文生图图生图（参考图）

{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "一只在月球上喝咖啡的柴犬，卡通风格"
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": [
      "TEXT",
      "IMAGE"
    ],
    "imageConfig": {
      "aspectRatio": "1:1",
      "imageSize": "2K"
    }
  }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

文生图图生图（参考图）

curl --location 'https://api.firemux.com/v1beta/models/gemini-3.1-flash-image:generateContent' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "一只在月球上喝咖啡的柴犬，卡通风格"
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": [
      "TEXT",
      "IMAGE"
    ],
    "imageConfig": {
      "aspectRatio": "1:1",
      "imageSize": "2K"
    }
  }
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "candidates": [
        {
            "content": {
                "role": "model",
                "parts": [
                    {
                        "text": "你好！",
                        "inlineData": {
                            "mimeType": "string",
                            "data": "string"
                        }
                    }
                ]
            },
            "finishReason": "STOP"
        }
    ],
    "usageMetadata": {
        "promptTokenCount": 12,
        "candidatesTokenCount": 30,
        "totalTokenCount": 42
    }
}

修改于 2026-08-18 07:00:42

对话