GPT-Image 异步生图

GPT-Image 异步接口用于创建图片生成或编辑任务，并立即返回本地任务 ID。

适用场景

图片生成或编辑耗时较长，不适合保持同步 HTTP 连接时使用该接口。该接口只创建任务，不会在本次响应中返回生成图片。

Base URL

https://api.xmsmartlink.cn

鉴权

Authorization: Bearer YOUR_API_KEY

Endpoint

POST /v1/aigc-images/generations

参数说明

移动端可横向滑动查看完整参数。

参数	类型	必填	说明
`model`	string	是	通常使用 `gpt-image-2-async`；以服务支持模型为准。
`prompt`	string	是	图片生成或编辑指令。
`n`	integer	否	请求生成图片数量，默认 1，最大 8。
`size`	string	否	输出尺寸。为空或无法识别时按 1K。
`quality`	string	否	`low`、`medium`、`high`、`auto`。
`background`	string	否	`transparent`、`opaque` 或 `auto`。
`output_format`	string	否	`png` 或 `jpeg`。
`mask`	string	否	遮罩图 URL 或 Base64 字符串。
`image`	string 或 string[]	否	一个或多个输入图 URL、Base64 值。

请求示例

bash

curl -X POST 'https://api.xmsmartlink.cn/v1/aigc-images/generations' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -d '{
    "model": "gpt-image-2-async",
    "prompt": "生成一张极简科技产品海报",
    "n": 1,
    "size": "1024x1024"
  }'

响应示例

OpenAPI 契约中的创建响应只包含 task_id。收到后立即持久化，用于后续查询。

json

{
  "task_id": "imgtask_xxx"
}

错误与重试

model 通常使用 gpt-image-2-async；以服务支持模型为准。
400：检查模型、提示词、输入图片和尺寸参数。
401：检查 Bearer Token。
500 或创建请求超时：先从响应和业务记录确认是否获得 task_id，不要直接或无限重试，避免重复任务。
本接口不提供 callback_url；创建成功后直接使用查询接口，并按异步任务指南处理轮询和结果保存。

API Reference

查看底层接口定义

GPT-Image 异步生图 ​

适用场景 ​

Base URL ​

鉴权 ​

Endpoint ​

参数说明 ​

请求示例 ​

响应示例 ​

错误与重试 ​

API Reference ​