跳转到主要内容
curl --request POST \
  --url https://xxx.wengaocloud.com/v2/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "gpt-image-2-async",
  "prompt": "一张电影感的未来城市天际线，傍晚，广角镜头"
}
'
{
  "id": "imgtask_5a16c0f5d2b64b40a86f7f5b21f42a61",
  "object": "image.generation.task",
  "model": "gpt-image-2-async",
  "status": "queued",
  "created_at": 1779860000
}

授权

​
Authorization
string
header
默认值:sk-your-api-key
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

application/json

当前异步图片接口不支持 n 字段；如需多张图片，请创建多个任务。

​
model
string
必填

支持图片异步 endpoint 的模型 ID，例如 gpt-image-2-async。

示例:

"gpt-image-2-async"

​
prompt
string
必填

图片生成提示词。

示例:

"一张电影感的未来城市天际线，傍晚，广角镜头"

​
size
string

输出比例或尺寸口径，以模型能力为准。常用比例类值例如 1:1、16:9。

示例:

"16:9"

​
urls
string<uri>[]

参考图 URL 列表。当前默认最多 8 张。

响应

任务已创建并进入队列。

​
id
string
必填
示例:

"imgtask_5a16c0f5d2b64b40a86f7f5b21f42a61"

​
object
enum<string>
必填
可用选项:
image.generation.task
​
model
string
必填
示例:

"gpt-image-2-async"

​
status
enum<string>
必填
可用选项:
queued
​
created_at
integer
必填

Unix 时间戳，秒。