提交图像生成任务

POST

/v2/images/generations (gemini-3.1-flash-image)

提交一个图像生成任务。任务创建成功后立即返回任务 ID（task_id），
实际生成在后台进行，请通过 GET /v2/tasks/{task_id} 查询结果。

是否传入参考图（image_urls）决定生成模式：

不传：文生图，根据 prompt 文字描述生成新图。

传 1~9 张：图生图 / 改图 / 多图融合。

参数要求：

model 必填。

文生图模式下 prompt 必填。

size 支持档位（1K/2K/4K）、比例（16:9）、像素（1024x1024）三种格式。

image_urls 最多 9 张，支持 base64（data:image/...;base64,...）或图片 URL。

Gemini 原生参数（temperature/topP/imageConfig 等）可直接在请求体顶层传入。

请求参数

Authorization

Header 参数

Body 参数application/json必填

{
    "model": "gemini-3.1-flash-image",
    "prompt": "赛博朋克城市夜景，霓虹灯，雨后倒影，超高清细节",
    "size": "1K"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v2/images/generations    (gemini-3.1-flash-image)' \
--header 'Accept;' \
--header 'Content-Type: application/json' \
--data '{
    "model": "gemini-3.1-flash-image",
    "prompt": "赛博朋克城市夜景，霓虹灯，雨后倒影，超高清细节",
    "size": "1K"
}'

返回响应

🟢200

application/json

任务创建成功，已进入排队。

Bodyapplication/json

示例

{
    "id": "task_c8FQYX2jkwwYxvuzjZCii5re3eycMx82",
    "model": "gemini-3.1-flash-image",
    "status": "QUEUED",
    "created_at": 1784800359,
    "metadata": {
        "source": "my-app"
    }
}

🟠401

🟠429

🔴503

修改于 2026-07-27 08:21:50

查询任务结果