图片生成（异步按张计费） - 问高云API开发文档

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
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "model_endpoint_mismatch",
    "message": "该模型不支持当前 endpoint。"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "model_endpoint_mismatch",
    "message": "该模型不支持当前 endpoint。"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "model_endpoint_mismatch",
    "message": "该模型不支持当前 endpoint。"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "model_endpoint_mismatch",
    "message": "该模型不支持当前 endpoint。"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "model_endpoint_mismatch",
    "message": "该模型不支持当前 endpoint。"
  }
}

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
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "model_endpoint_mismatch",
    "message": "该模型不支持当前 endpoint。"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "model_endpoint_mismatch",
    "message": "该模型不支持当前 endpoint。"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "model_endpoint_mismatch",
    "message": "该模型不支持当前 endpoint。"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "model_endpoint_mismatch",
    "message": "该模型不支持当前 endpoint。"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "model_endpoint_mismatch",
    "message": "该模型不支持当前 endpoint。"
  }
}

授权

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"

resolution

enum<string>

NanoBanana 系列分辨率字段，可选 1K、2K、4K；不按分辨率拆分价格。

可用选项:

1K,

2K,

4K

示例:

"2K"

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 时间戳，秒。