Skip to main content
POST

Authorizations

string
必填
所有接口均需要使用 Bearer Token 进行认证获取 API Key:访问 API Key 管理页面 获取您的 API Key使用时在请求头中添加:

Body

string
默认值:"gpt_image_2_official"
必填
图像生成模型名称固定填写 gpt_image_2_official(OpenAI 官方 gpt-image-2 模型)
object
必填
模型参数对象
string
必填
发起方任务ID用户自定义的任务标识,必填

尺寸 × 分辨率映射表

aspect_ratio × resolution → OpenAI 实际像素(13 比例 × 3 档位):
3:2 / 2:3 @ 2K 实际是 2048×1360(近似比例,误差 < 0.5%);4K 仅支持 6 个比例(总像素超 OpenAI 上限的组合不可用)。

Response

integer
响应状态码
array
返回数据数组

查询任务结果

提交成功后返回 task_id,通过 GET /v1/tasks/{task_id} 轮询任务状态,详见 任务查询接口。

轮询建议

  • 首次查询延迟:提交后等待 10~20 秒再开始查询
  • 查询间隔:建议 3~5 秒一次
  • 超时参考:high + 2K/4K 组合耗时可达 130 秒,客户端超时建议 ≥ 180 秒