nano-banana-pro

POST

v1beta/models/gemini-3-pro-image-preview:generateContent

请求参数

Header 参数

Body 参数application/json必填

示例

{
    "contents": [
        {
            "role": "user",
            "parts": [
                {
                    "inline_data": {
                        "mime_type": "image/jpeg",
                        "data": "<图像base64>,如：/9j/4AAQSkZJRxxxx6xilSlA"
                    }
                },
                {
                    "text": "生成图片: 换一种背景"
                }
            ]
        }
    ],
    "generationConfig": {
        "responseModalities": [
            "IMAGE"
        ],
        "imageConfig": {
            "aspectRatio": "可选值有：1:1，2:3，3:2，3:4，4:3，4:5，5:4，9:16，16:9，21:9。 如果您不提供aspectRatio字段，API将默认返回与输入图片最接近的原图比例",
            "imageSize": "可选值有：1K, 2K, 4K。不提供此字段就使用默认值为 1K"
        }
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://apis.koukoutu.comv1beta/models/gemini-3-pro-image-preview:generateContent' \
--header 'Authorization: Bearer sk-xxx' \
--header 'Content-Type: application/json' \
--data-raw '{
    "contents": [
        {
            "role": "user",
            "parts": [
                {
                    "inline_data": {
                        "mime_type": "image/jpeg",
                        "data": "<图像base64>,如：/9j/4AAQSkZJRxxxx6xilSlA"
                    }
                },
                {
                    "text": "生成图片: 换一种背景"
                }
            ]
        }
    ],
    "generationConfig": {
        "responseModalities": [
            "IMAGE"
        ],
        "imageConfig": {
            "aspectRatio": "可选值有：1:1，2:3，3:2，3:4，4:3，4:5，5:4，9:16，16:9，21:9。 如果您不提供aspectRatio字段，API将默认返回与输入图片最接近的原图比例",
            "imageSize": "可选值有：1K, 2K, 4K。不提供此字段就使用默认值为 1K"
        }
    }
}'

返回响应

🟢200成功

application/json

Body

示例

{
    "candidates": [
        {
            "content": {
                "parts": [
                    {
                        "inlineData": {
                            "mimeType": "image/jpeg",
                            "data": "9jAAB5qdW1kY2QPOUefMcSHUYDQO7uyqE264Q+A=="
                        }
                    }
                ],
                "role": "model"
            },
            "finishReason": "STOP",
            "index": 0
        }
    ],
    "usageMetadata": {
        "promptTokenCount": 266,
        "candidatesTokenCount": 1225,
        "totalTokenCount": 1673,
        "promptTokensDetails": [
            {
                "modality": "TEXT",
                "tokenCount": 8
            },
            {
                "modality": "IMAGE",
                "tokenCount": 258
            }
        ],
        "candidatesTokensDetails": [
            {
                "modality": "IMAGE",
                "tokenCount": 1120
            }
        ],
        "thoughtsTokenCount": 182
    },
    "modelVersion": "gemini-3-pro-image-preview",
    "responseId": "xxx"
}

🟠401未认证

修改于 2026-01-21 09:48:17

nano-banana

seedream4.5