GPT Image 2.6 新能力

curl --request POST \
  --url https://api.apiyi.com/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data @- <<EOF
{
  "model": "gpt-image-2.6-sunburst",
  "prompt": "A clean 2x2 technical infographic on a white background. Top-left: a red circle labeled 'A'. Top-right: a blue square labeled 'B'. Bottom-left: a green triangle labeled 'C'. Bottom-right: a yellow hexagon labeled 'D'. A black arrow connects A to B to C to D in that order. Exactly four labels, balanced grid, no other text."
}
EOF

{
  "created": 123,
  "background": "opaque",
  "data": [
    {
      "b64_json": "<string>",
      "generation_id": "<string>"
    }
  ],
  "output_format": "gif",
  "quality": "low",
  "size": "512x512",
  "usage": {
    "input_tokens": 59,
    "output_tokens": 555,
    "total_tokens": 614,
    "input_tokens_details": {
      "text_tokens": 59,
      "image_tokens": 0
    },
    "output_tokens_details": {
      "text_tokens": 0,
      "image_tokens": 555
    }
  },
  "svg_usage": {
    "model": "gpt-5.6-sol",
    "input_tokens": 1572,
    "output_tokens": 1437,
    "reasoning_tokens": 994,
    "total_tokens": 3009
  }
}

POST

images

generations

curl --request POST \
  --url https://api.apiyi.com/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data @- <<EOF
{
  "model": "gpt-image-2.6-sunburst",
  "prompt": "A clean 2x2 technical infographic on a white background. Top-left: a red circle labeled 'A'. Top-right: a blue square labeled 'B'. Bottom-left: a green triangle labeled 'C'. Bottom-right: a yellow hexagon labeled 'D'. A black arrow connects A to B to C to D in that order. Exactly four labels, balanced grid, no other text."
}
EOF

{
  "created": 123,
  "background": "opaque",
  "data": [
    {
      "b64_json": "<string>",
      "generation_id": "<string>"
    }
  ],
  "output_format": "gif",
  "quality": "low",
  "size": "512x512",
  "usage": {
    "input_tokens": 59,
    "output_tokens": 555,
    "total_tokens": 614,
    "input_tokens_details": {
      "text_tokens": 59,
      "image_tokens": 0
    },
    "output_tokens_details": {
      "text_tokens": 0,
      "image_tokens": 555
    }
  },
  "svg_usage": {
    "model": "gpt-5.6-sol",
    "input_tokens": 1572,
    "output_tokens": 1437,
    "reasoning_tokens": 994,
    "total_tokens": 3009
  }
}

右侧 Playground 提供 普通 PNG + complexity、SVG、2 帧 GIF 三组示例。请在 Authorization 中填入 Bearer sk-xxx，选择示例后修改提示词并发送。

返回的 data[0].b64_json 不含 data: 前缀，SVG 和 GIF 也都是 base64。浏览器 Playground 可能无法展示较长的 base64 响应；此时请求可能已经成功，请改用下方 Python 代码在本地解码保存。

模型选型

GPT Image 2.6 于 2026-11-04 发布，沿用 /v1/images/generations 和 /v1/images/edits，增加复杂度控制、SVG、GIF 与标记引导编辑。

模型	定位	适用场景
`gpt-image-2.6-flare`	快速迭代	草稿、批量出图、社交内容、需要快速比较多个提示词的场景
`gpt-image-2.6-sunburst`	精细视觉工作	复杂布局、精细文字、成品物料、需要精确编辑的场景

两款的 token 单价可在模型价格总表中查询。实际费用取决于尺寸、画质、输出格式和 token 用量；SVG 还会产生编写模型费用，不能按普通 PNG 的单张成本估算。

新能力一览

complexity 规划控制

控制模型渲染前的规划量，与 quality 画质设置相互独立。

SVG 矢量输出

返回可编辑的路径、形状和颜色，适合图标、插画和 UI 素材。

GIF 循环动画

一次请求生成完整 GIF，可控制帧数和每帧时长。

标记引导编辑

用透明标记图层圈出编辑区域，再通过 prompt 描述修改内容。

complexity：控制规划量

complexity 控制模型在渲染前投入多少规划。它适合密集文字、复杂布局、多个对象关系等任务；quality 则控制最终渲染画质，两者不要混用。

官方档位	建议用途
`low`	聚焦修改、简单构图、快速草稿
`medium`	常规布局与多个约束的均衡选择
`high`	密集文字、复杂布局、对象关系较多的场景；省略 `complexity` 时默认使用

complexity 不单独收费，但较高档位可能增加耗时，也可能引入不希望的改动。先用同一提示词比较结果，再决定生产档位，不要默认越高越好。

上游实测补充：还会返回哪些档位？

本次上游错误信息还列出 none、xhigh、max，这些值在当前链路可被接受。OpenAI 公开指南稳定承诺的是 low / medium / high，因此生产请求建议只使用官方三档，不把额外档位作为长期兼容保证。

SVG：生成可编辑矢量文件

设置 output_format: "svg"。当前上游还要求提供嵌套的 svg.model，用于指定编写矢量代码的文本模型：

{
  "model": "gpt-image-2.6-sunburst",
  "prompt": "A minimal flat vector icon of a rocket, exactly three solid colors, geometric editable shapes, no text, no raster texture, transparent background.",
  "output_format": "svg",
  "svg": {
    "model": "gpt-5.6-terra"
  },
  "quality": "low",
  "size": "1024x1024",
  "n": 1
}

红色尾翼、蓝色舷窗和白色机身的矢量火箭图标 — APIYI 透传链路生成的真实 SVG：由 path 和 circle 组成，可继续在矢量编辑器中修改

费用与限制

图像模型先生成参考图，文本模型再编写 SVG。响应中的 usage 是参考图像用量，svg_usage 是编写模型用量，两部分都要计入成本。
svg_usage.reasoning_tokens 已包含在 svg_usage.output_tokens 中，不要重复相加。
仅限 /v1/images/generations，n=1；编辑接口不支持 SVG 输出，也不能把 SVG 作为编辑输入位图。
不支持 streaming、partial images、output_compression 或 prompt_rewriter。
返回静态矢量 XML，不包含脚本、外部资源或嵌入位图。解码后保存为 .svg，不要按 PNG 渲染。

GIF：生成循环动画

设置 output_format: "gif"，并在提示词中描述主体、运动和循环方式。下面的低成本示例预期得到 2 帧、每帧 100ms、总时长 0.2 秒：

{
  "model": "gpt-image-2.6-sunburst",
  "prompt": "A minimal two-frame looping animation of a yellow circle moving slightly right and returning to its starting position on a plain white background, no text, seamless loop.",
  "output_format": "gif",
  "quality": "low",
  "size": "512x512",
  "frame_count": 2,
  "frame_duration_ms": 100,
  "n": 1
}

黄色圆形向右移动并回到起点的两帧循环动画 — APIYI 透传链路生成的真实 GIF：2 帧、0.2 秒，圆形位置发生变化

参数	官方范围与默认值	说明
`frame_count`	2–64，默认 9	帧数越多，耗时和费用通常越高
`frame_duration_ms`	20–2000ms，默认 200ms，按 10ms 取整	总时长约为帧数 × 每帧时长
`size`	`auto` 或合法 WIDTHxHEIGHT	表示每帧尺寸；帧数、单帧尺寸和总像素预算必须同时满足限制

GIF 仅限 generations，不支持 streaming、partial images、自定义 output_compression 或 prompt_rewriter。frame_count 和 frame_duration_ms 也不要用于 PNG、JPEG、WebP 或 SVG。

验证真实帧数

不要只看 HTTP 200 或响应中的 output_format。字段被路由丢弃时，仍可能返回默认 9 帧、1.8 秒的 GIF。可用 ffprobe 检查实际文件：

ffprobe -v error -select_streams v:0 -count_frames \
  -show_entries stream=codec_name,width,height,nb_read_frames,duration \
  -of json result.gif

本例应返回 nb_read_frames=2、duration=0.200000。

标记引导编辑

GPT Image 2.6 还支持通过 /v1/images/edits 的 markup 字段进行标记引导编辑：

第一张输入图保持为原图。
另做一张与原图同尺寸的透明 PNG，用圆圈、箭头或草图标出修改区域。
将该透明图层作为 markup 上传，并在 prompt 中说明修改内容和需要保留的细节。
markup 作用于第一张输入图，不能与 mask 或 prompt_rewriter 同时使用。

普通单图编辑、多图融合和 mask 用法见图片编辑 API。不同路由对 markup 的透传情况需单独验证，本页不将其作为已实测的在线演示。

客户端解码

三种输出都读取 data[0].b64_json，只是保存扩展名不同：

import base64
from pathlib import Path

payload = response.json()
fmt = payload["output_format"]
raw = base64.b64decode(payload["data"][0]["b64_json"])
Path(f"result.{fmt}").write_bytes(raw)

SVG 解码后是 UTF-8 XML；GIF 和 PNG/JPEG/WebP 解码后是二进制文件。生产代码还应检查 HTTP 状态、error 字段和实际文件签名，不要只根据扩展名判断成功。

路由兼容性与排障

2.6 新字段要求链路按原生 JSON 透传。不同上游路由的兼容进度可能不同，公开示例不代表每个分组都已具备相同行为。接入时请在实际使用的分组中验证。

现象	优先检查
已传 `svg.model`，仍返回 `SVG generation requires 'svg.model'`	嵌套 `svg` 对象是否被路由过滤或改写
请求 2 帧、100ms，实际却是 9 帧、1.8 秒	`frame_count` 和 `frame_duration_ms` 是否被丢弃并回退默认值
complexity 非法字符串仍返回 200	不同上游的校验策略可能不同，不能仅凭这一点判定未透传；结合合法档位的耗时、结果和上游日志排查
Playground 显示 `unable to complete request`	先检查是否实际返回 200；长 base64 可能超出浏览器展示能力，改用本地代码解码
担心 SVG 账单偏高	同时核对 `usage` 与 `svg_usage`，不要只统计参考图像 tokens

产品基础

基础 API

图片 API（官转）

视频 API（官转）

多模态理解 API

文本生成

音频 API（官转）

检索与安全

模型选型

新能力一览

complexity 规划控制

SVG 矢量输出

GIF 循环动画

标记引导编辑

complexity：控制规划量

SVG：生成可编辑矢量文件

费用与限制

GIF：生成循环动画

验证真实帧数

标记引导编辑

客户端解码

路由兼容性与排障

相关文档

授权

请求体

响应

​模型选型

​新能力一览

complexity 规划控制

SVG 矢量输出

GIF 循环动画

标记引导编辑

​complexity：控制规划量

​SVG：生成可编辑矢量文件

​费用与限制

​GIF：生成循环动画

​验证真实帧数

​标记引导编辑

​客户端解码

​路由兼容性与排障

​相关文档

授权

请求体

响应

模型选型

新能力一览

complexity：控制规划量

SVG：生成可编辑矢量文件

费用与限制

GIF：生成循环动画

验证真实帧数

标记引导编辑

客户端解码

路由兼容性与排障

相关文档