4. Gemini 图像生成

POST

/v1beta/models/{model}:generateContent

使用 Gemini 原生 generateContent 格式生成图像。接口地址：POST https://kuaipao.pro/v1beta/models/{model}:generateContent。文生图和图生图都使用 contents[].parts[]；参考图通过 parts[].inlineData 传入。

请求示例（文生图）

请求示例（图生图）

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Path 参数

Body 参数application/json必填

示例

文生图图生图

{
    "contents": [
        {
            "role": "user",
            "parts": [
                {
                    "text": "一张未来感 AI 工作台场景，冷色氛围，电影级布光"
                }
            ]
        }
    ],
    "generationConfig": {
        "responseModalities": [
            "TEXT",
            "IMAGE"
        ],
        "temperature": 1,
        "topP": 0.95,
        "maxOutputTokens": 8192,
        "imageConfig": {
            "aspectRatio": "16:9",
            "imageSize": "2K"
        }
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

文生图图生图

curl --location '/v1beta/models/gemini-3-pro-image-preview:generateContent' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "contents": [
        {
            "role": "user",
            "parts": [
                {
                    "text": "一张未来感 AI 工作台场景，冷色氛围，电影级布光"
                }
            ]
        }
    ],
    "generationConfig": {
        "responseModalities": [
            "TEXT",
            "IMAGE"
        ],
        "temperature": 1,
        "topP": 0.95,
        "maxOutputTokens": 8192,
        "imageConfig": {
            "aspectRatio": "16:9",
            "imageSize": "2K"
        }
    }
}'

返回响应

🟢200

application/json

生成成功

Bodyapplication/json

示例

{
    "candidates": [
        {
            "content": {
                "role": "model",
                "parts": [
                    {
                        "inlineData": {
                            "mimeType": "image/png",
                            "data": "BASE64_OR_URL"
                        }
                    }
                ]
            },
            "finishReason": "STOP"
        }
    ],
    "usageMetadata": {
        "promptTokenCount": 123,
        "candidatesTokenCount": 456,
        "totalTokenCount": 579,
        "trafficType": "ON_DEMAND"
    },
    "modelVersion": "gemini-3-pro-image-preview",
    "createTime": "2026-05-21T00:00:00Z"
}

🟠400ErrorResponse

🟠401ErrorResponse

修改于 2026-07-06 06:06:13

3. gpt-image-2-1k 编辑图像

5. 图像异步生成