Skip to main content
POST

Authorizations

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

Body

string
必填
模型名称固定值:"gpt_image_2"
object
必填
模型参数对象
string
必填
发起方任务ID用户自定义的任务标识,必填

尺寸 × 分辨率映射表

aspect_ratio × resolution → 实际像素(13 比例 × 3 档位):
3:2 / 2:3 @ 2K 实际是 2048×1360(近似比例,误差 < 0.5%);4K 现已支持全部 13 个比例。

自定义尺寸(size 参数)

当需要精确控制像素尺寸时,可使用 size 参数代替 aspect_ratio + resolution 组合。 有效范围: 总像素 655,360 ~ 8,294,400(上游官方限制) 实测有效下限: 总像素 ≥ 2,088,960(约 1440×1452 或 2048×1020 等同面积) 低于此下限时上游不报错,但会静默替换为相近比例的 ~1.57M 像素尺寸。

常用 size 示例

不要与 aspect_ratio 或 resolution 同时传入,否则返回 400。

Response

string
发起方任务ID,可用于查询结果
string
初始状态,固定为 "pending"
number
预估消耗积分
string
创建时间(ISO 格式)