POST
模型 ID 以模型列表返回结果为准。纯文生图不需要参考素材；需要参考图片时，可使用平台上传流程，也可直接提供已有的公网 URL，然后传给图片编辑接口。
本接口用于纯文生图。只要使用参考图片，就应改用图片编辑。参考图片必须是公网 URL，可以是上传接口返回的 public_url，也可以是你自己提供的公网 URL。

​
参考图片的两种方式

​
方式一：使用平台上传流程

调用 POST /v1/upload/presign 获取上传地址，完成 PUT 上传后，将响应中的 public_url 写入图片编辑请求的 images[].image_url。

​
方式二：直接提供公网 URL

如果图片已经部署在可公开访问的对象存储或 CDN，可跳过上传接口，直接填写 URL：
公网 URL 必须无需登录、无需 Cookie 或临时签名即可访问，并在任务执行期间保持有效。

​
分辨率与宽高比

接口可能直接返回 data[].url，也可能返回异步任务 ID。收到任务 ID 时使用查询图片任务轮询结果。

授权

​
Authorization
string
header
必填

请求头格式：Authorization: Bearer YOUR_API_KEY

请求体

application/json
​
model
string
必填

图片模型 ID，例如 gpt-image-2。实际值以 GET /v1/models 返回结果为准。

Minimum string length: 1
​
prompt
string
必填

图片生成或编辑指令。

Minimum string length: 1
​
n
integer
默认值:1

生成图片数量。具体上限由目标模型决定。

必填范围: 1 <= x <= 10
​
size
enum<string>
默认值:2048x2048

输出像素尺寸。支持 1K、2K、4K 的 1:1、16:9、9:16、4:3、3:4、3:2、2:3 组合。

可用选项:
1024x1024,
1536x864,
864x1536,
1360x1024,
1024x1360,
1536x1024,
1024x1536,
2048x2048,
3072x1728,
1728x3072,
2720x2048,
2048x2720,
3072x2048,
2048x3072,
2880x2880,
3840x2160,
2160x3840,
3328x2496,
2496x3328,
3520x2336,
2336x3520
​
quality
enum<string>
默认值:auto

生成质量。除 auto 外的值是否生效由目标模型决定。

可用选项:
auto,
low,
medium,
high
​
output_format
enum<string>
默认值:jpeg

输出图片格式。

可用选项:
jpeg,
png,
webp
​
moderation
enum<string>
默认值:auto

内容审核强度。可用值由目标模型决定。

可用选项:
auto,
low
​
response_format
enum<string>
默认值:url

结果返回方式。当前文档统一使用公网 URL。

可用选项:
url

响应

同步图片结果或异步任务信息

​
id
string

异步图片任务 ID。

​
task_id
string

部分实现使用的异步图片任务 ID 字段。

​
status
enum<string>
可用选项:
queued,
pending,
processing,
running,
succeeded,
completed,
failed,
cancelled,
expired
​
progress
number
必填范围: 0 <= x <= 100
​
created
integer

创建 Unix 时间戳，单位秒。

​
data
object[]
​
error
object | null