GPT Image 2.6

使用 gpt-image-2.6 进行文生图、参考图编辑和文字生成 GIF。flare 适合快速迭代,sunburst 适合精细构图与编辑。每次请求仅生成 1 个结果,n 只能为 1,也可省略。暂不支持 SVG 输出。

打开 Playground 或查看模型介绍。

定价

两个版本均与 GPT Image 2.5 保持相同价格:

分辨率每个结果的积分每个结果的价格
1k(默认)3.4$0.017
2k12$0.06
4k16$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 参数

字段类型说明
promptstring,必填生成或编辑提示词,去除首尾空格后不能为空;有参考图时同样必填。
versionstringflare(默认)或 sunburst。
resolutionstring1k(默认)、2k 或 4k;也接受大写。
aspect_ratiostringauto(默认)、1:1、3:2、2:3、4:3、3:4、5:4、4:5、16:9、9:16 或 21:9。
sizestringaspect_ratio 的别名;两者同时提供时必须一致。不接受 1024x1024 等像素尺寸。
ninteger只能为 1,默认 1。
qualitystring可选:auto、low、medium、high、xhigh 或 max。省略时不下发,由上游自动选择;auto 也不固定为 low。质量不影响单张价格,高档位通常耗时更长。
output_formatstringpng(默认)、jpeg、webp 或 gif;jpg 是 jpeg 的别名。暂不支持 SVG。
complexitystring可选:low、medium 或 high。省略时不下发,由上游决定。用于控制画面复杂度;low 适合简洁图标和扁平插画,high 适合丰富细节。不影响单张价格。
image_urlsstring[]最多 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 状态码错误码类型说明
400invalid_requestinvalid_request_error缺少必填参数或参数无效
401invalid_api_keyauthentication_errorAPI Key 无效、已禁用或已删除
402insufficient_creditsbilling_error积分余额不足,请充值
403ip_not_allowedpermission_error请求 IP 不在 Key 的白名单中
404model_not_foundinvalid_request_error模型不存在或已停用
404task_not_foundinvalid_request_error任务 ID 不存在
429rate_limit_exceededrate_limit_error请求过于频繁,请降低频率
429spend_limit_exceededbilling_error达到 Key 的消费限额(每小时/每天/总量)
500internal_errorapi_error服务器内部错误
503upstream_errorupstream_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 服务返回错误,可能原因:

  • 输入内容包含敏感或违规信息
  • 上游服务暂时不可用
  • 请求参数不被上游支持

因上游错误导致任务失败时,预扣积分会自动退还。