图片模型 · OpenAI

GPT Image 2.5 Flare API

GPT Image 2.5 Flare 通过兼容 OpenAI 的图片接口生成和编辑图片。请求是同步返回的，一般约 30 秒出图，默认以 base64 返回图片数据。

模型 ID: gpt-image-2.5-flare
输入: 文本、图片（编辑）
输出: PNG 图片
计费: 按次

Capabilities

能力与接口

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

POSThttps://tokenra.io/v1/images/generations已实测

文生图，JSON 请求体，响应中直接返回生成好的图片。

POSThttps://tokenra.io/v1/images/edits已实测

图生图与编辑，multipart/form-data 格式，原图放在 image 字段。

Request

请求参数

生成：POST /v1/images/generations

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

Response

响应格式

{
  "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 用量。

Errors

错误与限制

常见错误

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 数无关，实时价格见模型广场。