GPT Image 2.6
使用 gpt-image-2.6 进行文生图、参考图编辑和文字生成 GIF。flare 适合快速迭代,sunburst 适合精细构图与编辑。每次请求仅生成 1 个结果,n 只能为 1,也可省略。暂不支持 SVG 输出。
定价
两个版本均与 GPT Image 2.5 保持相同价格:
| 分辨率 | 每个结果的积分 | 每个结果的价格 |
|---|---|---|
1k(默认) | 3.4 | $0.017 |
2k | 12 | $0.06 |
4k | 16 | $0.08 |
以上为账户倍率前的标准价。画质、输出格式、复杂度、比例和参考图均不影响价格。费用应用账户配置的倍率并保留两位小数,提交时预扣。任务成功后保留扣费;已确认生成失败时仅退还一次。提交或交付结果不明确时,保留预扣积分等待核对,不能仅凭 failed 状态判断已退款。查询任务和重试回调不会再次扣费或退款。
创建任务
curl -X POST https://api.aivideoapi.ai/v1/images/generations \
-H "Authorization: Bearer sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2.6",
"callback_url": "https://your-server.com/webhook",
"input": {
"prompt": "雨天窗边温暖舒适的阅读角,柔和台灯光线",
"version": "flare",
"resolution": "1k",
"aspect_ratio": "16:9",
"quality": "high",
"n": 1
}
}'
请求包含 model、input 对象,以及可选的顶层 callback_url。
Input 参数
| 字段 | 类型 | 说明 |
|---|---|---|
prompt | string,必填 | 生成或编辑提示词,去除首尾空格后不能为空;有参考图时同样必填。 |
version | string | flare(默认)或 sunburst。 |
resolution | string | 1k(默认)、2k 或 4k;也接受大写。 |
aspect_ratio | string | auto(默认)、1:1、3:2、2:3、4:3、3:4、5:4、4:5、16:9、9:16 或 21:9。 |
size | string | aspect_ratio 的别名;两者同时提供时必须一致。不接受 1024x1024 等像素尺寸。 |
n | integer | 只能为 1,默认 1。 |
quality | string | 可选:auto、low、medium、high、xhigh 或 max。省略时不下发,由上游自动选择;auto 也不固定为 low。质量不影响单张价格,高档位通常耗时更长。 |
output_format | string | png(默认)、jpeg、webp 或 gif;jpg 是 jpeg 的别名。暂不支持 SVG。 |
complexity | string | 可选:low、medium 或 high。省略时不下发,由上游决定。用于控制画面复杂度;low 适合简洁图标和扁平插画,high 适合丰富细节。不影响单张价格。 |
image_urls | string[] | 最多 16 张公开 HTTP(S) 图片 URL 或图片 Base64 Data URL,每张最多 20 MB。1K 支持 PNG/JPEG/WebP/GIF/BMP;2K、4K 的参考图不能是 GIF 或 BMP。 |
枚举值忽略大小写与首尾空格。文生图的 auto 使用正方形构图;图生图根据第一张能读取尺寸的参考图匹配最接近的支持比例,不保证保留原图像素尺寸。4K 正方形输出为 2880×2880,4K 16:9 输出为 3840×2160。
Playground 上传目前支持 JPG/PNG/WebP,每张最多 10 MB;其他上述参考图格式与大小请通过 API 使用。
参考图编辑
{
"model": "gpt-image-2.6",
"input": {
"prompt": "将第一张图中的商品放入第二张图的场景,保留标签文字并匹配光线。",
"version": "sunburst",
"resolution": "2k",
"aspect_ratio": "auto",
"output_format": "webp",
"n": 1,
"image_urls": ["https://example.com/product.png", "https://example.com/scene.jpg"]
}
}
请将示例链接替换为真实、公开可访问的图片。
GIF 动图
GIF 仅支持文生图,不能传入参考图。省略 size、aspect_ratio 或传 auto,并在提示词中描述动作与循环方式。
{
"model": "gpt-image-2.6",
"input": {
"prompt": "卡通小狗抬起一只爪子挥手,再回到起始姿势。白色背景,固定机位,无缝循环。",
"version": "flare",
"resolution": "1k",
"output_format": "gif",
"quality": "medium",
"n": 1
}
}
暂不支持 SVG 及 svg 配置。不支持 width、height、markup、markup_url。background、moderation、output_compression、seed、negative_prompt、style 不生效。response_format 不改变交付方式,结果始终为文件 URL,不返回 Base64 图片。
任务响应与查询
提交成功后返回平台任务 ID:
{
"code": 200,
"msg": "success",
"data": { "taskId": "397ce9f2-c04e-4244-ac33-3af19a7cc297" }
}
使用相同 Bearer 认证,每 3–5 秒查询 GET https://api.aivideoapi.ai/v1/tasks/{taskId}。客户端等待超时后继续查询原任务,避免重复提交生成。GPT Image 2.6 任务提交后不支持取消。
{
"id": "397ce9f2-c04e-4244-ac33-3af19a7cc297",
"status": "completed",
"model": "gpt-image-2.6",
"credits_consumed": 3.4,
"output": { "urls": ["https://file.aivideoapi.ai/images/example.gif"] }
}
任务经过 pending、processing,最终进入 completed 或 failed。从 output.urls 读取图片或动图,并下载保存需要保留的结果。任务失败时,error.message 在有可用信息时提供经过脱敏的具体原因。
回调通知
在请求顶层提供 callback_url,任务完成或失败后会收到 POST 通知。JSON 内容与任务查询结构一致。请求头包括 Content-Type: application/json、X-Event(task.completed 或 task.failed)、X-Task-Id 和 X-Timestamp(Unix 秒)。
请在 10 秒内返回 HTTP 2xx。最多投递三次(含首次),接收端应按任务 ID 幂等处理。回调投递失败不会将已成功生成的任务变为可退款失败任务。
常见错误码
请求失败时,API 返回 JSON 格式的错误响应:
{
"error": {
"code": "insufficient_credits",
"message": "Your credit balance is too low. Please top up.",
"type": "billing_error"
}
}
错误码一览
| HTTP 状态码 | 错误码 | 类型 | 说明 |
|---|---|---|---|
| 400 | invalid_request | invalid_request_error | 缺少必填参数或参数无效 |
| 401 | invalid_api_key | authentication_error | API Key 无效、已禁用或已删除 |
| 402 | insufficient_credits | billing_error | 积分余额不足,请充值 |
| 403 | ip_not_allowed | permission_error | 请求 IP 不在 Key 的白名单中 |
| 404 | model_not_found | invalid_request_error | 模型不存在或已停用 |
| 404 | task_not_found | invalid_request_error | 任务 ID 不存在 |
| 429 | rate_limit_exceeded | rate_limit_error | 请求过于频繁,请降低频率 |
| 429 | spend_limit_exceeded | billing_error | 达到 Key 的消费限额(每小时/每天/总量) |
| 500 | internal_error | api_error | 服务器内部错误 |
| 503 | upstream_error | upstream_error | 上游 AI 服务返回错误 |
常见场景
invalid_request (400)
缺少必填字段或参数格式错误时返回。
{
"error": {
"code": "invalid_request",
"message": "'model' is required.",
"type": "invalid_request_error"
}
}
insufficient_credits (402)
积分不足。可通过 GET /v1/credits 查询余额,前往 Dashboard > Billing 充值。
invalid_api_key (401)
可能原因:
- Key 不以
sk-开头 - Key 已被禁用或删除
- 用户账户已被封禁
upstream_error (503)
上游 AI 服务返回错误,可能原因:
- 输入内容包含敏感或违规信息
- 上游服务暂时不可用
- 请求参数不被上游支持
因上游错误导致任务失败时,预扣积分会自动退还。