提交图像生成任务

POST

/v2/images/generations (gpt-image-2)

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

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

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

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

参数要求：

model 必填。

文生图模式下 prompt 必填。

n 取值范围 1~10。

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

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

请求参数

Authorization

Header 参数

Body 参数application/json必填

示例

文生图 - 基线文生图 - 完整参数文生图 - 固定随机种子（可复现）文生图 - 负向提示词图生图 - 单图改图（base64 风格迁移）图生图 - 单图链接模式改图 - 高保真微调（input_fidelity）多图组图 - 虚拟试穿（2 张参考图）

{
    "model": "gpt-image-2",
    "prompt": "赛博朋克城市夜景，霓虹灯，雨后倒影，超高清细节"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

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

返回响应

🟢200

application/json

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

Bodyapplication/json

示例

{
    "id": "task_c8FQYX2jkwwYxvuzjZCii5re3eycMx82",
    "model": "gpt-image-2",
    "status": "QUEUED",
    "created_at": 1784800359,
    "metadata": {
        "source": "my-app"
    }
}

🟠401

🟠429

🔴503

修改于 2026-07-27 08:20:49

查询任务结果