生成图片

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

参数处理规则（重要）：

图片模型请求仅使用上游图片参数：prompt、image/images、aspect_ratio、size

不执行 size -> resolution 映射

不自动补 duration

不注入视频参数 resolution

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

Request

Body Params application/jsonRequired

Examples

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"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

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

Responses

🟢200OK

application/json

提交成功（异步任务）

Bodyapplication/json

Example

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

🟠400Bad Request

🟠401Unauthorized

Modified at 2026-04-03 13:45:37

MJ 融图（Blend）

MJ 提交绘图任务