# GPT Image 2.5 Sunburst API（TokenRa）

模型 ID：`gpt-image-2.5-sunburst`
获取 API Key：https://tokenra.io/sign-up?utm_source=llms-agent&utm_medium=model-llms
更新日期：2026-10-30

> GPT Image 2.5 Sunburst 是 TokenRa 上的另一款 GPT Image 2.5 模型，接口和参数与 GPT Image 2.5 Flare 相同，实测约 30 秒出图。

- 厂商：OpenAI
- 类型：图片模型
- 输入：文本、图片（编辑）
- 输出：PNG 图片
- 计费：按次

## 价格

以下为本文件最后更新时 TokenRa 控制台的价格，单位美元，默认分组。请以实时价格为准：https://tokenra.io/pricing（JSON：https://tokenra.io/api/pricing）。

- `gpt-image-2.5-sunburst`：每次请求 $0.02

## 能力与接口

两个接口都兼容 OpenAI，OpenAI SDK 把 `base_url` 设为 `https://tokenra.io/v1` 即可使用。均已于 2026-10-23 实测调用成功。

- `POST https://tokenra.io/v1/images/generations`：文生图，JSON 请求体，响应中直接返回生成好的图片。
- `POST https://tokenra.io/v1/images/edits`：图生图与编辑，`multipart/form-data` 格式，原图放在 `image` 字段。

## 调用示例

先把环境变量 `TOKENRA_API_KEY` 设为你的 API Key。文档页提供同一示例的 Python、JavaScript 和 Java 版本。

```bash
curl https://tokenra.io/v1/images/generations \
  -H "Authorization: Bearer $TOKENRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.5-sunburst",
    "prompt": "台灯下读书的水彩风格小狐狸",
    "size": "1024x1536",
    "quality": "low",
    "response_format": "url"
  }'
```

## 请求参数

### 生成：POST /v1/images/generations

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `model` | string | 是 | 模型 ID：`gpt-image-2.5-sunburst`。 |
| `prompt` | string | 是 | 图片描述。 |
| `size` | string | 否 | `auto`（默认）或具体尺寸，如 `1024x1536`。实测 `auto` 返回 1254x1254 的图片。 |
| `quality` | string | 否 | `auto`（默认）、`low`、`medium` 或 `high`。 |
| `n` | integer | 否 | 生成张数，默认 1，实测 `n: 2` 可用。 |
| `response_format` | string | 否 | `b64_json`（默认）返回 base64 数据；`url` 返回临时下载链接。 |

### 编辑：POST /v1/images/edits

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `model` | string | 是 | 模型 ID：`gpt-image-2.5-sunburst`。 |
| `prompt` | string | 是 | 修改要求。 |
| `image` | file | 是 | 原图文件（已用 PNG 实测）。 |
| `response_format` | string | 否 | `b64_json`（默认）或 `url`，与生成接口相同。 |

## 响应格式

**响应示例（base64 已截断）**

```json
{
  "created": 1792766203,
  "data": [
    {"b64_json": "iVBORw0KGgoAAAANSUhEUgAABOYAAATm..."}
  ],
  "background": "auto",
  "output_format": "png",
  "quality": "auto",
  "size": "auto",
  "usage": {
    "input_tokens": 180,
    "input_tokens_details": {"image_tokens": 0, "text_tokens": 180},
    "output_tokens": 1056,
    "total_tokens": 1236
  }
}
```

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `created` | integer | Unix 时间戳。 |
| `data[].b64_json` | string | base64 编码的 PNG（默认），解码后保存即可。 |
| `data[].url` | string | `response_format` 为 `url` 时返回的临时链接，请及时下载。 |
| `size / quality / output_format` | string | 本次实际使用的尺寸、质量和格式。 |
| `usage` | object | 模型上报的 token 用量。 |

## 错误与限制

### 常见错误

| HTTP | error.code | 含义 | 处理建议 |
| --- | --- | --- | --- |
| `401` | — | API Key 缺失、错误或已删除，message 为 `Invalid token`。 | 检查 `Authorization: Bearer` 请求头，并在控制台核对 Key。 |
| `400` | — | 请求体不是合法 JSON。 | 修正 JSON，并带上 `Content-Type: application/json`。 |
| `500` | `invalid_request` | 缺少必填字段，例如未传 `messages`。 | 按 message 补全字段，重试无效。 |
| `403` | `insufficient_user_quota` | 账户余额或套餐额度不足。 | 在控制台充值后重试。 |
| `503` | `model_not_found` | 模型 ID 不存在，或你的分组下没有可用渠道。 | 在模型列表或 `GET /v1/models` 中核对模型 ID。 |
| `429` | — | 请求过于频繁。 | 指数退避后重试。 |
| `5xx` | — | 上游服务商出错或超时。 | 稍后重试几次；持续出错时保留 request id 联系支持。 |

### 使用限制与说明

- 实测单次请求约 30 秒，请把客户端超时设为 120 秒以上。
- base64 图片约有 1–3 MB，只需要链接时可用 `response_format: "url"`。
- 按次计费，与 token 数无关，实时价格见模型广场。

## 更多链接

- [GPT Image 2.5 Sunburst API 文档页](https://tokenra.io/zh/docs/gpt-image-2.5-sunburst.html)：参数表和 cURL、Python、JavaScript、Java 代码示例
- [GPT Image 2.5 Sunburst 模型介绍与价格页](https://tokenra.io/zh/models/gpt-image-2-5.html)
- [公共信息](https://tokenra.io/zh/docs/common.html)：Base URL、鉴权、错误码与重试
- [快速开始](https://tokenra.io/zh/docs/quickstart.html)：创建 Key 并发出第一个请求
- [全部模型](https://tokenra.io/zh/docs/models.html)：所有模型 ID
- [本指南的英文版](https://tokenra.io/docs/gpt-image-2.5-sunburst/llms.txt)
- [面向 AI 代理的站点索引](https://tokenra.io/llms.txt)

---

本文档的规范地址：https://tokenra.io/zh/docs/gpt-image-2.5-sunburst/llms.txt