生成图片

POST

/v1/images/generations

OpenAI Images 兼容端点（当前按异步任务提交）。

当前支持模型：

gemini-3-pro-image-preview

gemini-3.1-flash-image-preview

不支持 gemini-3-pro-preview（text_to_text）

参数说明（对齐上游 gemini-3 模型能力）：

prompt：必填

aspect_ratio：可选

size：可选

image / images：可选（用于 image-to-image）

image_to_image 输入数量：1~14

image_to_image 文件类型：jpg/png

返回值中的 id/task_id 为任务 ID，需再调用 GET /v1/images/generations/{task_id} 轮询获取结果。

请求参数

Body 参数application/json必填

示例

gemini-3-pro-image-preview 文生图gemini-3-pro-image-preview 单图生图（image）gemini-3-pro-image-preview 多图生图（images）gemini-3.1-flash-image-preview 图生图gemini-3.1-flash-image-preview 文生图（512px）

{
    "model": "gemini-3-pro-image-preview",
    "prompt": "a futuristic city at sunset",
    "aspect_ratio": "16:9",
    "size": "2K"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

curl --location --request POST '/v1/images/generations' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "gemini-3-pro-image-preview",
    "prompt": "a futuristic city at sunset",
    "aspect_ratio": "16:9",
    "size": "2K"
}'

返回响应

🟢200成功

application/json

提交成功（异步任务）

Body

示例

{
    "id": "task_202603200001",
    "task_id": "task_202603200001",
    "object": "image",
    "model": "gemini-3.1-flash-image-preview",
    "status": "queued",
    "progress": 0,
    "created_at": 1774000000
}

🟠400请求有误

🟠401没有权限

修改于 2026-03-20 08:40:11

查询素材配额信息

查询图片任务状态与结果