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

# GPT Image 2.5

> 接入 Flare 与 Sunburst：模型 ID、调用示例及切换注意事项。

## 模型 ID

| 模型 | 请求中的 `model` |
| - | - |
| Flare | `gpt-image-2.5-flare` |
| Sunburst | `gpt-image-2.5-sunburst` |

不要简写为 `gpt-image-2.5`。两个完整 ID 均已完成单张 `1024x1024`、URL 返回与图片下载联调；调用权限仍以你的企业账号配置为准。

## 调用示例

先完成 [环境变量配置](https://docs.vizluma.online/getting-started/authentication.md)，再选择一个模型：

```bash Flare theme={null}
curl --fail-with-body --silent --show-error \
  --connect-timeout 15 --max-time 600 \
  "$VIZLUMA_BASE_URL/images/generations" \
  -H "Authorization: Bearer $VIZLUMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.5-flare",
    "prompt": "生成一张白色陶瓷杯的商品插画，杯子居中，纯白背景，柔和阴影，无文字",
    "size": "1024x1024",
    "n": 1,
    "response_format": "url"
  }' \
  -o generation.json
```

```bash Sunburst theme={null}
curl --fail-with-body --silent --show-error \
  --connect-timeout 15 --max-time 600 \
  "$VIZLUMA_BASE_URL/images/generations" \
  -H "Authorization: Bearer $VIZLUMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.5-sunburst",
    "prompt": "生成一张白色陶瓷杯的商品插画，杯子居中，纯白背景，柔和阴影，无文字",
    "size": "1024x1024",
    "n": 1,
    "response_format": "url"
  }' \
  -o generation.json
```

响应结构与 GPT Image 2 相同，见 [图片生成 API](https://docs.vizluma.online/api-reference/images-generations.md)。返回 URL 后请及时保存图片。

## 参数

| 参数 | 类型 | 必填 | 说明 |
| - | - | - | - |
| `model` | string | 是 | 已开通权限的完整模型 ID，见 [模型列表](https://docs.vizluma.online/models/overview.md)。 |
| `prompt` | string | 是 | 非空的图像描述。建议说明主体、风格、构图、背景和文字要求。 |
| `size` | string | 否 | 建议显式使用 `1024x1024` 开始联调。其他尺寸见 [尺寸说明](https://docs.vizluma.online/guides/sizes-and-quality.md)。 |
| `n` | integer | 否 | 默认 `1`；网关接受 `1`～`10`，批量能力与企业调用限制需单独确认。按实际返回图片数量计费。 |
| `response_format` | string | 否 | `url` 或 `b64_json`。建议显式指定；本文的已实测基础示例使用 `url`。 |

`stream: true` 和 `mask` 不在当前支持范围内。不要假设官方接口的所有扩展参数在这里都可用。

## 从 GPT Image 2 切换

1. 请管理员确认当前 Key 已开通目标 2.5 模型。
2. 在现有请求中替换完整 `model` ID。
3. 保留已经验证的 `size`、`n` 和 `response_format`。
4. 使用真实业务提示词复测效果、耗时和费用。

两个 2.5 模型的公开基础价一致，但与 GPT Image 2 不同，见 [计费说明](https://docs.vizluma.online/pricing.md)。不要仅根据型号数字判断效果，也不要把某一张样图的风格当作模型的固定行为。

> [!NOTE]
>
> 尚未完成本轮验证的编辑、批量、高分辨率和扩展参数，不因更换为 2.5 模型自动视为已验证。


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