图片编辑

POST

/v1beta/models/{model-name}:generateContent

官方文档：https://ai.google.dev/gemini-api/docs/image-generation?hl=zh-cn#gemini-image-editing

请求参数

Path 参数

Query 参数

Header 参数

Body 参数application/json

示例

{
    "contents": [
        {
            "role": "user",
            "parts": [
                {
                    "text": "'Hi, This is a picture of me. Can you add a llama next to me"
                },
                {
                    "inline_data": {
                        "mime_type": "image/jpeg",
                        "data": "https://gips3.baidu.com/it/u=1821127123,1149655687&fm=3028&app=3028&f=JPEG&fmt=auto?w=720&h=1280"
                    }
                }
            ]
        }
    ],
    "generationConfig": {
        "responseModalities": [
            "TEXT",
            "IMAGE"
        ],
        "imageConfig": {
            "aspectRatio": "9:16",
            "imageSize": "1K"
        }
    },
    "type": "image"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request POST '/v1beta/models/:generateContent?key={{YOUR_API_KEY}}' \
--header 'Authorization: Bearer  {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "contents": [
        {
            "role": "user",
            "parts": [
                {
                    "text": "'\''Hi, This is a picture of me. Can you add a llama next to me"
                },
                {
                    "inline_data": {
                        "mime_type": "image/jpeg",
                        "data": "https://gips3.baidu.com/it/u=1821127123,1149655687&fm=3028&app=3028&f=JPEG&fmt=auto?w=720&h=1280"
                    }
                }
            ]
        }
    ],
    "generationConfig": {
        "responseModalities": [
            "TEXT",
            "IMAGE"
        ],
        "imageConfig": {
            "aspectRatio": "9:16",
            "imageSize": "1K"
        }
    },
    "type": "image"
}'

返回响应

🟢200成功

application/json

Body

示例

{}

修改于 2026-03-24 09:54:18

图片生成 gemini-3-pro-image-preview 控制宽高比 +清晰度

图片理解