GPT Image 2.6
使用此模型提交图片生成任务,再通过返回的任务 ID 查询结果。
模型 ID gpt-image-2.6
快速开始
创建 并设置 I2V_API_KEY。每个新任务设置一个 IDEMPOTENCY_KEY,重试同一次提交时复用原幂等键和请求体。
提交任务
POST https://api.i2v.ai/api/v1/jobs/createTask
bash
curl "https://api.i2v.ai/api/v1/jobs/createTask" \
-H "Authorization: Bearer $I2V_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "gpt-image-2.6",
"inputs": {
"prompt": "A calm lake at sunrise",
"resolution": "1K"
}
}'HTTP 200 表示任务已受理。保存返回的 taskId。
json
{"taskId":"YOUR_TASK_ID"}查询结果
bash
curl "https://api.i2v.ai/api/v1/jobs/recordInfo?taskId=YOUR_TASK_ID" \
-H "Authorization: Bearer $I2V_API_KEY"将 YOUR_TASK_ID 替换为返回的任务 ID。状态为 waiting 或 generating 时退避轮询。success 时读取 output[].url,fail 时检查 error。
请求参数
模型输入放在 inputs 对象中。素材 URL 需要可公开访问。必需素材及参数组合取决于具体生成模式。
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
inputs.prompt | string | 是 | — | 描述生成结果或编辑要求的提示词。 上限 20000 字符. |
inputs.resolution | string | 否 | 1K | 输出分辨率。 可选值 1K, 2K, 4K. |
inputs.aspectRatio | string | 否 | — | 输出宽高比。 可选值 auto, 1:1, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 16:9, 9:16, 2:1, 1:2, 3:1, 1:3, 21:9, 9:21. |
inputs.imageUrls | string[] | 否 | — | 图片编辑所用的参考图地址。 上限 16 个 URL. |
inputs.variant | string | 否 |

