QUICK START
调用说明
计费与网页一致。推荐异步接口,提交后轮询任务状态,适合 2K、4K 任务。
异步生成(推荐)
curl -X POST "{origin}/v1/images/generations/async" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: YOUR_UNIQUE_ID" \
-d '{"model":"gpt-image-2.5-4k","prompt":"一只橘猫坐在窗边","aspect_ratio":"1:1","n":1}'
继续修改已有作品
curl -X POST "{origin}/v1/images/generations/async" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: YOUR_UNIQUE_ID" \
-d '{"model":"gpt-image-2.5-4k","prompt":"把背景改成雪山","aspect_ratio":"1:1","source_order_id":"已有作品订单ID","n":1}'
查询任务
curl "{origin}/v1/images/tasks/TASK_ID" \
-H "Authorization: Bearer YOUR_API_KEY"
同步生成
curl -X POST "{origin}/v1/images/generations" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-image-2.5-1k","prompt":"极简产品摄影","aspect_ratio":"4:3","n":1}'
查询余额
curl "{origin}/api/me" \
-H "Authorization: Bearer YOUR_API_KEY"
| 模型 | 成品 | 单价 |
|---|---|---|
gpt-image-2.5-1k | 1K | ¥0.05 |
gpt-image-2.5-2k | 2K | ¥0.10 |
gpt-image-2.5-4k | 4K | ¥0.15 |
每次只支持生成 1 张(n=1)。余额不足或服务离线时会返回明确错误。
继续修改已有作品时,可传入本人已完成订单的 source_order_id。系统会保留原图,并创建一笔新的生成订单。