创建图像

POST

/v1/images/generations

根据文本提示创建新图像。

模型支持

gemini-2.5-flash-image: 仅支持 1K 分辨率，quality 和 image_size 参数会被忽略

gemini-3-pro-image-preview: 支持 1K/2K/4K 分辨率，推荐使用

参数优先级

image_size > quality：当同时指定两个参数时，image_size 优先生效。

quality 映射

standard → imageSize: 2K

hd → imageSize: 4K

垫图功能

当请求包含垫图参数时，会自动转换为 edits 请求，同时保留 quality 和 image_size 参数。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Header 参数

Body 参数application/json必填

示例

基础请求（1K 分辨率）使用 quality 参数生成高清图片（需要 gemini-3-pro-image-preview）使用 quality 参数生成标准图片（需要 gemini-3-pro-image-preview）使用 image_size 参数生成 4K 图片（更精确，需要 gemini-3-pro-image-preview）使用 image_size 参数生成 2K 图片（需要 gemini-3-pro-image-preview）

{
    "model": "gemini-2.5-flash-image",
    "prompt": "A cute baby sea otter",
    "n": 1,
    "size": "1024x1024"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

curl --location '/v1/images/generations' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "model": "gemini-2.5-flash-image",
    "prompt": "A cute baby sea otter",
    "n": 1,
    "size": "1024x1024"
}'

返回响应

🟢200

application/json

成功响应

Bodyapplication/json

示例

{
    "created": 1589478378,
    "data": [
        {
            "url": "https://..."
        }
    ]
}

🟠400BadRequest

🟠401Unauthorized

修改于 2025-12-21 08:37:55

Chat 格式生成图片

创建图片编辑

创建图像

模型支持#

参数优先级#

quality 映射#