GPT Image 2.6

通过 SeedRouter 的异步图像 API，用 GPT Image 2.6 生成和编辑图像、创建 GIF 动画并请求 SVG 输出。

GPT Image 2.6 接受文本提示词和可选的参考图。向 POST /v1/images/generations 提交一次，保存任务 ID，再轮询 GET /v1/tasks/{id} 获取结果。生成完成的文件以 URL 返回。

模型 ID 与价格

使用 GET /v1/models 查看你的 key 可用的模型。已配置的 Sunburst ID 为 gpt-image-2.6-sunburst-official 和 gpt-image-2.6-sunburst。Flare ID 在列表中出现时，也使用同一份参数契约。裸模型 ID 使用其 Default 分组；其他分组使用发现接口返回的 model:group ID。

参见当前价格与 Playground。按 token 计费的模型以实际用量结算；按张计费的模型使用配置的单张价格。SVG 响应在 svg_usage 中单独报告代码编写模型的 token，按该模型自身在 SeedRouter 上的价格计费。

生成图像

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.6-sunburst-official",
    "prompt": "A red paper crane on a pale blue table, soft daylight",
    "size": "1024x1024",
    "quality": "low",
    "complexity": "high"
  }'

响应包含一个 id。请轮询该 ID，不要再次提交生成请求：

curl "https://api.seedrouter.ai/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY"

完成后，output.data 包含带 url 的对象。请下载该 URL，以保留原始文件格式，以及 GIF 的所有动画帧。失败的任务带有 error，且不计费。参见任务状态与轮询。

参数

共 18 个顶层字段。只有 model 和 prompt 必填。可选字段接受 null，效果与省略相同。未知字段会被丢弃。受支持字段的非法值会在图像生成前被校验拦截。

字段	类型	默认值与约束
`model`	string	必填；使用你的 key 可用的 ID。
`prompt`	string	必填，不能为空白，最长 32,000 个 Unicode 字符。
`n`	integer	1；范围 1–10。SVG 要求为 1。
`size`	string	`auto` 或 `WIDTHxHEIGHT`。详见下方尺寸规则。
`quality`	string	默认 `auto`；也可用 `low`、`medium`、`high`、`xhigh`、`max`。
`background`	string	默认 `auto`；也可用 `opaque`、`transparent`。JPEG 不支持透明。
`output_format`	string	默认 `png`；也可用 `jpeg`、`gif`、`svg`。不提供 WebP 输出。
`output_compression`	integer	JPEG 默认为 100；范围 0–100。仅搭配 `output_format: "jpeg"` 传入。
`moderation`	string	默认 `auto`；也可用 `low`。公开 Playground 中的 `low` 仅限 API 使用。
`complexity`	string	默认 `high`；也可用 `low`、`medium`。控制规划强度，不另加费用。
`frame_count`	integer	9；范围 2–16。仅限 GIF。
`frame_duration_ms`	integer	200；至少 20 毫秒，无上限。仅限 GIF；编码器会四舍五入到最接近的 10 ms，并将每帧时长限制在 655,350 ms 以内。
`svg`	object	默认省略。可选的代码编写模型设置；见下文。
`images`	array	1–16 个形如 `{"image_url":"https://..."}` 的对象；传入即切换为编辑。
`mask`	object	`{"image_url":"https://..."}`。需要 `images`；不能与 `markup` 同时使用。
`markup`	object	`{"image_url":"https://..."}`。需要 `images`；不能与 `mask` 同时使用。
`safety_identifier`	string	可选的稳定终端用户标识，最长 128 字符。非空值优先于 `user`。
`user`	string	已弃用的可选终端用户标识；Playground 中不显示，也不会自动填入。

参考图 URL 必须使用 HTTP 或 HTTPS，且不能包含凭证。不接受文件 ID、内联 base64 或 multipart 上传；请先上传文件，再提供公开 URL。请求采用异步任务轮询，不使用 stream 或 partial_images。此契约不提供 input_fidelity、response_format 和 prompt_rewriter。

图像尺寸

生成 PNG、JPEG 和 SVG 参考图时，每个维度都必须能被 16 整除，且不超过 3840 像素。总像素必须为 655,360–8,294,400，宽高比须在 1:3 到 3:1 之间。例如：1024x1024、1536x1024、2160x3840、2880x2880。

GIF 的尺寸必须为 16 的正整数倍，或使用 auto。GIF 有单独的像素总预算，由帧数、每帧尺寸和 n 共用；OpenAI 尚未公布具体上限。512x512 GIF 不适用静态图像的最小像素规则。

GIF 动画

{
  "model": "gpt-image-2.6-sunburst-official",
  "prompt": "A red paper crane flapping its wings in a seamless loop on pale blue",
  "output_format": "gif",
  "size": "512x512",
  "quality": "low",
  "frame_count": 4,
  "frame_duration_ms": 200
}

GIF 可从提示词生成，也可根据参考图请求生成。不要搭配遮罩或压缩设置使用。能否使用预览功能可能取决于所选模型的访问权限。

文档差异，核对日期：2026 年 11 月 5 日： OpenAI 的图像生成指南给出的范围是 2–64 帧和 20–2000 ms，并称编辑端点不返回 GIF。Images API 参考文档给出的范围是 2–16 帧，每帧时长无上限，并列出编辑支持 GIF 输出。2026 年 11 月 5 日的上游请求结果与参考文档一致：17 帧被拒绝，3,000 ms 每帧则被接受。本 API 遵循参考文档。

SVG

{
  "model": "gpt-image-2.6-sunburst-official",
  "prompt": "A simple geometric red paper-crane logo, clean editable vector paths",
  "output_format": "svg",
  "n": 1
}

SVG 仅支持生成，且要求 n: 1。不要传入图像、遮罩、标记图或压缩设置。文件为包含矢量形状的静态 UTF-8 XML；不支持脚本、外部资源和嵌入的栅格图像。

支持选择代码编写模型时，可添加 svg: {"model":"YOUR_AUTHOR_MODEL_ID"}。显式传入 svg 对象时，model 不得为空。你还可以将 svg.reasoning.effort 设为 none、minimal、low、medium、high、xhigh 或 max；支持哪些值取决于所选代码编写模型。省略 reasoning 即使用该模型的默认值。OpenAI 没有公布代码编写模型白名单或统一默认值。不支持选择代码编写模型时，请省略整个 svg 对象。

完成的结果中可能包含 svg_usage，其中有 model、input_tokens、output_tokens、reasoning_tokens 和 total_tokens。它与图像的 usage 分开统计，不是额外的图像 token 数量。

参考图、遮罩与标记图

{
  "model": "gpt-image-2.6-sunburst-official",
  "prompt": "Replace the marked background with a pale blue studio backdrop",
  "images": [{"image_url":"https://example.com/reference.png"}],
  "markup": {"image_url":"https://example.com/transparent-markup.png"},
  "output_format": "png",
  "complexity": "low"
}

参考图支持 PNG、JPEG 和 WebP，每张最大 50 MB。遮罩和标记图必须为 PNG，且尺寸须与第一张参考图调整方向后的尺寸一致。标记图必须包含透明像素；标记图和第一张参考图均不得超过 16,777,216 像素，标记图最大为 50 MB。遮罩和标记图不能同时使用。

响应字段

完成的图像输出包含 created、data: [{url}]，以及模型报告时的 size、quality、background、output_format、usage、svg_usage 和 safety_identifier。usage 可能细分文本/图像输入和输出 token，以及缓存输入。公开输出不包含 base64 图像字节或费用字段。

OpenAPI schema · OpenAI 生成参考文档 · OpenAI 编辑参考文档 · OpenAI 图像指南

On this page