> ## Documentation Index
> Fetch the complete documentation index at: https://docs.laozhang.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# GPT Image 2.6 API：GIF 动图与 SVG 矢量图，VIP 每张 0.03 美元

> 用老张API密钥调用 OpenAI 的 GPT Image 2.6 Flare 与 Sunburst，不需要 OpenAI 账号：官转按 token 计费，可直接输出 GIF 动图和 SVG 矢量图；VIP 与网页版每次固定 0.03 美元。附三条线路的模型 ID、令牌分组、参数和可运行示例。

GPT Image 2.6 是 OpenAI 继 GPT Image 2.5 之后的图像模型，同样分 **Flare**（出图快）和 **Sunburst**（细节与编辑更稳），新增 GIF 动图、SVG 矢量图输出和 `complexity` 参数。老张API提供三条线路，先按下表选择。

## 先选择接入线路

| 线路 | 模型 ID | 价格 | 输出 | 常见耗时 |
| - | - | - | - | - |
| 官转 | `gpt-image-2.6-flare`、`gpt-image-2.6-sunburst` | 按 token | 静态图、GIF、SVG；原生 4K | Flare 1024 图 8–12 秒 |
| VIP 按次 | `gpt-image-2.6-flare-vip`、`gpt-image-2.6-sunburst-vip` | \$0.03/张 | PNG；原生 4K | 25–55 秒 |
| 网页版 | `gpt-image-2.6-web` | \$0.03/次 | PNG、JPEG、WebP、GIF；原生约 2K | 15–35 秒 |

* 令牌分组只在创建令牌时选，不写进请求：
  * 官转用 `OpenAI Official` 或 `OpenAI Official Enterprise`，计费模式「按量优先」或「按量计费」。
  * VIP 和网页版用 `default` 或其他图像分组，计费模式「按量优先」或「按次计费」。
* 三条线路都用 `/v1/images/generations` 生成、`/v1/images/edits` 编辑，请求格式与 OpenAI Images API 相同。
* 怎么选：要 SVG、要从编辑直接出 GIF 或要最快出图，用官转；要固定价的原生 4K PNG，用 VIP；要固定价的 GIF（1024×1024 及以上），用网页版。

## 和 GPT Image 2.5 的区别

* 新增输出格式：官转可输出 GIF 动图和 SVG 矢量图，网页版可输出 GIF。
* 新参数 `complexity`（`low` / `medium` / `high`）控制画面复杂度，不另收费。
* 官转 `low`、`medium` 用的 tokens 是 2.5 的 3–4 倍，`high` 及以上与 2.5 同价；大量草图可以继续用 [GPT Image 2.5](https://docs.laozhang.ai/api-capabilities/gpt-image-2-5.md)。
* 2.6 VIP 不支持 `xhigh`、`max`，按次调用需要这两档时继续用 2.5 VIP。

## 调用前准备

**1. 创建令牌**

在[令牌管理](https://api2.laozhang.ai/token)创建令牌，分组按上表的线路选择，不需要 OpenAI 账号。

**2. 设置环境变量**

```bash theme={null}
export LAOZHANG_API_KEY="替换为你的老张API令牌"
export BASE_URL="https://api.laozhang.ai/v1"
```

**3. 准备保存脚本**

响应的 `data[]` 里是 Base64（`b64_json`）或下载地址（`url`）。将以下代码保存为 `save_images.py`，它按文件头识别 PNG、JPEG、WebP、GIF 和 SVG，并用对应的扩展名保存：

```python theme={null}
import base64
import json
import sys
import urllib.request
from pathlib import Path

if len(sys.argv) != 3:
    raise SystemExit("用法：python save_images.py 响应文件.json 输出文件前缀")


def decode_b64(value):
    # 去掉可能存在的 data:...;base64, 前缀，并补齐缺失的 = 填充
    if value.startswith("data:"):
        value = value.split(",", 1)[1]
    value = "".join(value.split())
    value += "=" * (-len(value) % 4)
    return base64.b64decode(value, validate=True)


def extension_of(raw):
    # 按文件头判断格式：PNG、JPEG、WebP、GIF 或 SVG
    if raw.startswith(b"\x89PNG"):
        return "png"
    if raw.startswith(b"\xff\xd8"):
        return "jpg"
    if raw[:4] == b"RIFF" and raw[8:12] == b"WEBP":
        return "webp"
    if raw.startswith(b"GIF8"):
        return "gif"
    if b"<svg" in raw[:2048]:
        return "svg"
    raise RuntimeError("无法识别的图片格式")


payload = json.loads(Path(sys.argv[1]).read_text(encoding="utf-8"))
if payload.get("error"):
    raise RuntimeError(payload["error"])
items = payload.get("data") or []
if not items:
    raise RuntimeError("响应中没有图片结果，请检查错误信息和调用日志")

for index, item in enumerate(items, start=1):
    if item.get("b64_json"):
        raw = decode_b64(item["b64_json"])
    elif item.get("url"):
        with urllib.request.urlopen(item["url"], timeout=60) as download:
            raw = download.read()
    else:
        raise RuntimeError(f"第 {index} 项缺少图片内容或下载地址")
    output = Path(f"{sys.argv[2]}-{index}.{extension_of(raw)}")
    output.write_bytes(raw)
    print(f"已保存 {output}（{len(raw)} 字节）")
```

用法：`python save_images.py 响应文件.json 输出文件前缀`。

## GPT Image 2.6 官转

GPT Image 2.6 是 OpenAI 新一代图像模型，同样分 Flare（快）和 Sunburst（细节与编辑更稳）。官转分组按 token 计费，令牌、接口和请求写法与 2.5 官转相同，只换 `model`；也可以用 `default` 分组按次调用，见 [GPT Image 2.6 VIP 按次](#gpt-image-2-6-vip-按次)。

| 项目 | 内容 |
| - | - |
| 模型 ID | `gpt-image-2.6-flare`、`gpt-image-2.6-sunburst` |
| 令牌分组 | `OpenAI Official` 或 `OpenAI Official Enterprise`，计费模式「按量优先」或「按量计费」 |
| 接口 | `/v1/images/generations`、`/v1/images/edits` |
| 单价 | 与 [GPT Image 2.5 官转计费](https://docs.laozhang.ai/api-capabilities/gpt-image-2-5.md#官转计费)相同：文本输入 \$5、图片输入 \$8、图片输出 \$30（每 1M tokens） |
| 新参数 | `output_format: "gif"` 输出循环动图；`output_format: "svg"` 输出 SVG 矢量图（写 SVG 的文本模型默认 `gpt-6.1-terra`，不另收费，可用 `svg.model` 更换）；`complexity`（`low` / `medium` / `high`，默认 `high`）控制画面复杂度，不另收费 |
| 按次线路 | `gpt-image-2.6-flare-vip`、`gpt-image-2.6-sunburst-vip`，每张 \$0.03，不支持 GIF、SVG 和 `xhigh` / `max`，见 [GPT Image 2.6 VIP 按次](#gpt-image-2-6-vip-按次)；`gpt-image-2.6-web` 每次 \$0.03，可输出 GIF，不支持 SVG，见 [GPT Image 2.6 网页版](#gpt-image-2-6-网页版) |

1024×1024 一张图的图片输出 tokens 与成本（`OpenAI Official` 分组，2026 年 11 月 5 日实测，耗时为直连 OpenAI 的单次结果）：

| `quality` | 输出 tokens | 每张 | Flare 耗时 | Sunburst 耗时 |
| - | -: | -: | -: | -: |
| `low` | 824 | \$0.025 | 8 秒 | 34 秒 |
| `medium` | 1,449 | \$0.043 | 11 秒 | 42 秒 |
| `high` | 1,756 | \$0.053 | 12 秒 | 59 秒 |
| `xhigh` | 3,122 | \$0.094 | 23 秒 | 86 秒 |
| `max` | 7,024 | \$0.211 | 39 秒 | 157 秒 |

* `high` 及以上与 2.5 同价；`low`、`medium` 的 tokens 是 2.5 的 3–4 倍，大量草图可以继续用 2.5。
* 横版 1536×1024 用的 tokens 更少：`low` 664、`high` 1,353。
* 原生 4K（3840×2160）的 `high` 约 3,337 tokens，约 \$0.10。
* 请显式传 `quality`。不传时 Flare 按提示词自动选档，细节多的提示词一张 1024 图可能用到约 5,800 tokens；Sunburst 不传时按 `high`。

生成 GIF 动图：

```bash theme={null}
curl --fail-with-body "$BASE_URL/images/generations" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.6-flare",
    "prompt": "一只橘猫在窗台上伸懒腰后打哈欠，窗外下着小雨，扁平插画风格，循环动画",
    "output_format": "gif",
    "size": "512x512",
    "frame_count": 9,
    "frame_duration_ms": 200,
    "quality": "medium"
  }' -o gif.json
```

用 `python save_images.py gif.json animation` 保存为 `.gif`。GIF 的规则：

* `frame_count` 默认 9 帧；`frame_duration_ms` 默认 200，最小 20。
* 所有帧拼在一张大图里生成，尺寸太小或帧数太多会报 `No supported sheet fits`；`512x512` 配 4–9 帧可直接使用，512×512 九帧 `medium` 约 2,073 tokens（约 \$0.06）。
* 不支持 `stream`。

![GPT Image 2.6 Flare 生成的循环 GIF：橘猫在下雨的窗台上伸懒腰打哈欠](https://mintcdn.com/laozhangai-edd05f2c/12rpJOJJXqwT-_gR/images/samples/gpt26-zh-gif.gif?s=d4dda0eb4c16ba5276702bd4ee40d3cc)

gpt-image-2.6-flare 输出的 GIF：512×512，9 帧，约 11 秒

### 生成 SVG 矢量图

GPT Image 2.6 官转可以直接输出 SVG 矢量图，适合图标、Logo 和简单插画：放大不失真，可以直接改颜色和形状。默认设置下写 SVG 不收费，一个 1024×1024 图标只收参考图费用：`low` 约 \$0.025，`medium` 约 \$0.044。把 `output_format` 设为 `svg` 即可：

```bash theme={null}
curl --fail-with-body "$BASE_URL/images/generations" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.6-flare",
    "prompt": "一个扁平风格的咖啡杯图标，杯子冒着热气，杯身上有一片绿色叶子图案，暖棕色和奶白色配色",
    "output_format": "svg",
    "quality": "medium",
    "size": "1024x1024"
  }' -o svg.json
```

用 `python save_images.py svg.json icon` 保存为 `.svg`。OpenAI 在一次请求里分两步完成：图片模型先按 `quality` 出一张参考图，再由一个 GPT 文本模型把它写成 SVG 代码。

* 写 SVG 的文本模型用 `svg.model` 指定，不传时默认 `gpt-6.1-terra`。
* 也可以自己传，例如 `"svg": {"model": "gpt-5.5"}`（`gpt-5.5` 会另收写作费，见下方计费）。只能填文本模型，填图片模型会报 `model_not_found`。

计费分两部分：

* 参考图：和普通出图一样，按 `usage` 以官方单价计费。
* 写 SVG：默认的 `gpt-6.1-terra` 和以下 8 个低价文本模型不收费：
  * `gpt-5.4-mini`、`gpt-5.4-nano`、`gpt-5-mini`、`gpt-5-nano`
  * `gpt-4.1-mini`、`gpt-4o-mini`、`gpt-5.6-luna`、`gpt-6-luna`
* 其他写作模型（例如 `gpt-5.5`、`gpt-6-sol`）按其官方单价计费，用量在响应的 `svg_usage` 里。调用日志中，这部分按等价金额折成文本输入 tokens 计入，折算后的数量见 `svg_usage.billed_as_text_input_tokens`；用免费模型时该值为 0。

不同写作模型的对比（2026 年 11 月 5 日实测，同一个 1024 图标提示词，每个模型 3 次以上）：

| `svg.model` | 成功率 | 写 SVG 的费用 | 耗时 | 效果 |
| - | - | -: | -: | - |
| `gpt-6.1-terra`（默认） | 7/7 | 不收费 | 33–43 秒 | 线条干净，接近 gpt-5.5 |
| `gpt-5.5` | 3/3 | 约 \$0.09–0.16 | 42–70 秒 | 细节最好 |
| `gpt-6-sol`、`gpt-6.1-sol` | 各 2/3 | 约 \$0.02–0.04 | 33–49 秒 | 好 |
| `gpt-5.4-mini` | 3/3 | 不收费 | 16 秒 | 造型粗糙 |
| `gpt-5.6-terra` | 0/3 | — | — | 不建议 |

失败都是 OpenAI 返回 502，与网关无关。没有特殊需要时不传 `svg.model`，直接用默认模型。

* 支持的写作模型：GPT-5.x、GPT-6.x、GPT-4.1、GPT-4o、o3 等 GPT 文本模型。不在支持列表里的返回 `unsupported_svg_model`，不扣费。
* 可选 `svg.reasoning.effort`（low、medium、high 等）控制写 SVG 时的思考量。high 的 tokens 实测是默认值的 2.6–14 倍，图标用默认值即可。
* 画面越复杂，SVG 代码越长，费用和耗时越高。
* 细节多的整幅插画（例如一整间咖啡店的场景）实测多数失败，一次失败要等 2–3 分钟。SVG 请用于图标、Logo 和简单图形。
* 只支持 `/v1/images/generations`，不支持编辑、`stream`，`n` 只能为 1。
* OpenAI 返回 502 时，网关会自动重试或换一条线路再试。全部失败时返回错误（通常是 `svg_generation_failed`），不扣费；失败不会返回参考图，可以稍后重试或简化提示词。

![GPT Image 2.6 生成的 SVG 矢量图标：冒热气的奶白色咖啡杯，杯身有绿色叶子，放在棕色碟子上](https://mintcdn.com/laozhangai-edd05f2c/opsNeKybSpGGbpi9/images/samples/gpt26-svg-coffee.svg?fit=max\&auto=format\&n=opsNeKybSpGGbpi9\&q=85\&s=21bb7f4e2c881bb9d48f640a48804353)

gpt-image-2.6-flare 默认设置生成的 SVG 图标：4 KB，约 42 秒，费用约 \\\$0.044（只收 medium 参考图，gpt-6.1-terra 写 SVG 不收费）

## GPT Image 2.6 VIP 按次

不想按 token 算账、主要出 `high` 及以下画质的 PNG 时，用 2.6 的 VIP 模型：每张 \$0.03，令牌和 2.5 VIP 相同。

| 项目 | 内容 |
| - | - |
| 模型 ID | `gpt-image-2.6-flare-vip`、`gpt-image-2.6-sunburst-vip`，两款同价，耗时相近 |
| 令牌分组 | `default` 或其他图像分组，计费模式「按量优先」或「按次计费」 |
| 接口 | `/v1/images/generations`、`/v1/images/edits` |
| 价格 | 每张 \$0.03，尺寸、质量、生成与编辑都不改变单价 |
| `quality` | `low` / `medium` / `high`；`xhigh`、`max` 返回 `400`，不扣费 |
| `size` | 与 2.5 VIP 相同，1K 到 4K 原生生成，限制见 [GPT Image 2.5 的尺寸与质量](https://docs.laozhang.ai/api-capabilities/gpt-image-2-5.md#尺寸与质量) |
| 输出 | PNG，支持透明背景；`output_format` 填 `jpeg` 也返回 PNG |
| 不支持 | GIF、SVG：`output_format` 为 `gif` 或 `svg` 时返回 `400`，不扣费，需要时用 [2.6 官转](#gpt-image-2-6-官转) |
| 耗时 | 2026 年 11 月 5 日实测：1024×1024 约 25–55 秒，3840×2160 约 25–45 秒，编辑约 30–40 秒 |

```bash theme={null}
export LAOZHANG_API_KEY="替换为你的 default 分组令牌"

curl --fail-with-body "https://api.laozhang.ai/v1/images/generations" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.6-flare-vip",
    "prompt": "白色陶瓷杯的产品照片，灰色桌面，柔和自然光",
    "size": "2048x2048",
    "quality": "high"
  }' -o generation.json
```

编辑、透明背景的写法与 [GPT Image 2.5 VIP 的示例](https://docs.laozhang.ai/api-capabilities/gpt-image-2-5.md#vip-按次计费接入)相同，把 `model` 换成 2.6 的 `-vip` 模型 ID 即可，结果用本页的 `save_images.py` 保存。

和其他线路怎么选：

* **2.6 官转**：`high` 一张 1024 图约 \$0.053，VIP 是 \$0.03；要 GIF、SVG 或更快出图（Flare 8–12 秒）时用官转。
* **2.5 VIP**：同为 \$0.03，支持 `xhigh` / `max`；需要这两档时继续用 2.5。
* **2.6 网页版**：同为 \$0.03，出图更快（一般 20–35 秒），可输出 GIF 动图；原生最高约 2K，4K 为放大，只要 1K、2K 时用它，见 [GPT Image 2.6 网页版](#gpt-image-2-6-网页版)。

## GPT Image 2.6 网页版

想按每次 \$0.03 的固定价生成 GIF 动图时，用 2.6 网页版 `gpt-image-2.6-web`：帧数和每帧时长都可以指定。令牌与 2.5 网页版、VIP 相同。

| 项目 | 内容 |
| - | - |
| 模型 ID | `gpt-image-2.6-web`，不能指定 Flare / Sunburst |
| 令牌分组 | `default` 或其他图像分组，计费模式「按量优先」或「按次计费」 |
| 接口 | `/v1/images/generations` 生成（含 GIF）、`/v1/images/edits` 编辑 |
| 价格 | 每次 \$0.03，尺寸、帧数、生成与编辑都不改变单价 |
| `size` | 规则与 VIP 相同，见 [GPT Image 2.5 的尺寸与质量](https://docs.laozhang.ai/api-capabilities/gpt-image-2-5.md#尺寸与质量)；总像素至少 655,360，所以 `512x512` 不可用，最小方图是 `816x816` |
| 输出 | PNG（默认）、`jpeg`、`webp`、`gif`；原生最高约 2K，4K 尺寸按请求宽高返回，但细节相当于 2K 放大 |
| 不支持 | SVG：`output_format` 为 `svg` 时立即返回 `400`，不扣费；编辑接口不能输出 GIF |
| 耗时 | 2026 年 11 月 5 日实测：PNG 1024×1024 约 15–35 秒，编辑约 20–30 秒 |

生成 GIF 动图：

```bash theme={null}
export LAOZHANG_API_KEY="替换为你的 default 分组令牌"

curl --fail-with-body "https://api.laozhang.ai/v1/images/generations" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.6-web",
    "prompt": "一只橘猫坐着向镜头招手，扁平卡通风格，浅蓝色纯色背景，循环动画",
    "size": "1024x1024",
    "output_format": "gif",
    "frame_count": 8,
    "frame_duration_ms": 120
  }' -o gif.json
```

用 `python save_images.py gif.json animation` 保存为 `.gif`。返回的帧数和每帧时长与请求一致，循环播放。

GIF 的规则：

* `frame_count` 为 2–64，默认 9；`frame_duration_ms` 为 20–2000，默认 200。
* 一定要传 `size`：不传时返回的 GIF 尺寸小且不规则（例如 439×390）。GIF 推荐 `1024x1024`。
* `n` 只能为 1。
* 传 `stream: true` 不会分段返回，生成完成后一次返回整张 GIF。
* 帧数越多越慢、文件越大。1024×1024 时：4–9 帧约 35–42 秒、1–2.5 MB；16 帧约 100 秒、约 5 MB；64 帧约 2 分钟、约 18 MB，单帧会略糊。2048×2048 九帧约 54 秒、约 11 MB。客户端超时至少设 300 秒。
* 高峰时多帧或大尺寸 GIF 可能在约 2 分钟后返回 `429`，不扣费；稍后重试，或减少帧数、缩小尺寸。

参数不符合要求时返回 `400`、不扣费，但 `message` 只写「请求未被上游接受，请检查请求参数和内容后重试」，原因要看 `param` 和 `code`：

| 情况 | `param` / `code` |
| - | - |
| 尺寸不合规，例如 `512x512` | `"param": "size"`、`"code": "invalid_value"` |
| `n` 大于 1 | `"param": "n"`、`"code": "invalid_value"` |
| `frame_count` 或 `frame_duration_ms` 超出范围 | `"code": "invalid_image_request"` |
| 编辑接口请求 GIF | `"code": "invalid_image_request"` |

GIF 用哪条线路：

* **2.6 网页版**：1024×1024 及以上，每次 \$0.03 固定价，帧数可控。
* **2.6 官转**：要 `512x512` 这类小尺寸 GIF、从编辑直接输出 GIF 或要 SVG 时用，按 token 计费，512×512 九帧 `medium` 约 \$0.06，见 [GPT Image 2.6 官转](#gpt-image-2-6-官转)。
* **2.6 VIP**：不输出 GIF；要原生 4K 的 PNG 时用。

## 常见问题

### 不用 OpenAI 账号能调用 GPT Image 2.6 吗？

可以。只需要老张API密钥，不需要 OpenAI 账号。三条线路都走 OpenAI 兼容的 Images 接口，已有 OpenAI SDK 代码只需改 `base_url` 和密钥，再把 `model` 换成 2.6 的模型 ID。

### GPT Image 2.6 API 多少钱一张？

VIP（`gpt-image-2.6-flare-vip`、`gpt-image-2.6-sunburst-vip`）每张 \$0.03，网页版 `gpt-image-2.6-web` 每次 \$0.03，尺寸和质量都不改变单价。

官转按 token 计费，一张 1024×1024 图 `low` 约 \$0.025、`high` 约 \$0.053，原生 4K `high` 约 \$0.10，各档见 [GPT Image 2.6 官转](#gpt-image-2-6-官转)。上游返回非 200 不扣费，见[扣费与失败规则](https://docs.laozhang.ai/api-capabilities/image-billing-and-failures.md)。

## 相关文档

* [GPT Image 2.5 API](https://docs.laozhang.ai/api-capabilities/gpt-image-2-5.md)：上一代模型，VIP 支持 `xhigh` / `max`
* [GPT Image 2.6 上线公告](https://docs.laozhang.ai/announcements/gpt-image-2-6-2026-11.md)
* [Images API 参考](https://docs.laozhang.ai/api-reference/images.md)
* [图像生成 API 选型与价格](https://docs.laozhang.ai/api-capabilities/image-generation-guide.md)
* [调用日志](https://docs.laozhang.ai/faq/call-logs.md)
* [模型与价格总表](https://docs.laozhang.ai/models.md)

## 参考资料

* [OpenAI 图像生成指南](https://developers.openai.com/api/docs/guides/image-generation)
* [OpenAI Images API 参考](https://developers.openai.com/api/reference/resources/images)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.