官方格式(文生图)

POST

/v1beta/models/{model}:generateContent

请求参数

Path 参数

Header 参数

Body 参数application/json必填

示例

{
    "contents": [
        {
            "role": "user",
            "parts": [
                {
                    "text": "一只睡觉的猫"
                }
            ]
        }
    ],
    "generationConfig": {
        "responseModalities": [
            "TEXT",
            "IMAGE"
        ],
        "imageConfig": {
            "aspectRatio": "16:9",
            "imageSize": "1K"
        }
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://mliapi.com/v1beta/models/gemini-3-pro-image-preview:generateContent' \
--header 'Accept;' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data '{
    "contents": [
        {
            "role": "user",
            "parts": [
                {
                    "text": "一只睡觉的猫"
                }
            ]
        }
    ],
    "generationConfig": {
        "responseModalities": [
            "TEXT",
            "IMAGE"
        ],
        "imageConfig": {
            "aspectRatio": "16:9",
            "imageSize": "1K"
        }
    }
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "candidates": [
        {
            "content": {
                "role": "model",
                "parts": [
                    {
                        "inlineData": {
                            "mimeType": "image/png",
                            "data": "3O2jWsWheJzH6fwG8H3Y9YXTs0gAAAABJRU5ErkJggg=="
                        }
                    }
                ]
            },
            "finishReason": "STOP"
        }
    ],
    "usageMetadata": {
        "promptTokenCount": 122,
        "candidatesTokenCount": 1290,
        "totalTokenCount": 1412,
        "trafficType": "ON_DEMAND",
        "promptTokensDetails": [
            {
                "modality": "TEXT",
                "tokenCount": 122
            }
        ],
        "candidatesTokensDetails": [
            {
                "modality": "IMAGE",
                "tokenCount": 1290
            }
        ]
    },
    "modelVersion": "gemini-2.5-flash-image-preview",
    "createTime": "2025-11-06T07:06:46.306721Z",
    "responseId": "BkkMaaHcEsSY4_UP_aOrmAg"
}

修改于 2026-05-23 15:38:00

文档说明

官方格式(图生图)