Skip to main content
openai/gpt-image-2.5-sunburst 的 API 参考文档,该模型由 Comfy Router 提供、来源于 OpenAI。

快速开始

你的 Comfy 工作区中创建密钥,并将其导出为 COMFY_API_KEY。Python 和 TypeScript 代码片段使用 Comfy SDK(pip install comfy-sdknpm install @comfyorg/sdk);cURL 代码片段则是通过原始 HTTP 发起相同的调用。 模型 ID: openai/gpt-image-2.5-sunburst 端点: POST https://api.comfy.org/v2/models/openai/gpt-image-2.5-sunburst

Schema

输入

string
背景透明度可选值:transparentopaque
string
用于图像生成的模型(例如 gpt-image-1、gpt-image-1.5、gpt-image-2、gpt-image-2.5-flare、gpt-image-2.5-sunburst)
string
内容审核设置可选值:lowauto
integer
要生成的图像数量(1-10)。
integer
JPEG 或 WebP 的压缩级别(0-100)
string
输出图像的格式可选值:pngwebpjpeg
string
必填
期望图像的文字描述
string
生成图像的质量可选值:lowmediumhighstandardhd
string
图像数据的响应格式可选值:urlb64_json
string
图像的尺寸(例如 1024x1024、1536x1024、auto)
string
图像风格。此操作所接纳的 gpt-image 模型并不使用该参数;它原本是 dall-e-3 独有的参数,而这些 id 已在 OpenAI 于 2026-05-12 关停它们时退役。可选值:vividnatural
string
用于终端用户监控的唯一标识符
根据 Router 在 GET /v2/models/openai/gpt-image-2.5-sunburst/openapi.json 提供的 schema 生成,这也是它在请求到达提供商之前用于校验调用的同一份文档。

输出

object[]
string
Base64 编码的图像数据
string
修订后的提示词
string
图像的 URL
object
integer
object
integer
integer
integer
object
integer
integer
integer
string
生成图像的背景是不透明还是透明。仅在 fal 提供服务的分支上填充,该分支报告 opaque
integer
Generation 完成时的 Unix 时间戳,单位为秒。声明为 int64,因为当今的 epoch 值非常接近 2^31,未格式化的 integer 会在许多 SDK 生成器中生成 32 位字段。格式:int64
string
data[].b64_json 中字节的编码格式(例如 png)。在 fal 提供服务的分支上填充;在 OpenAI 提供服务的分支上缺失,此时以调用方请求的 output_format 为准。
string
本次生成实际运行的质量层级。在 fal 提供服务的分支上、且能够解析出该值时填充;否则缺失。
string
本次生成实际运行的像素尺寸,格式为 <width>x<height>。在 fal 提供服务的分支上、且能够解析出该值时填充;否则缺失。

示例

输入

输出

发布前须知

SDK 会生成 Idempotency-Key 并在自动重试中复用它。手动重试时,请复用原始 key。Router 最长可保持连接 10 分钟。 请求失败时,Router 会发送 X-Comfy-Error-Type 响应头说明原因。422 表示 Router 在调用提供商之前就拒绝了输入。生成的资源请及时下载,因为结果链接会过期

请求头

身份验证、幂等性、请求 ID、错误分类、重试节奏、消费限额。

使用 Router API

模型发现、校验错误、重试与计费。

限制

Router 目前不支持的功能,以及替代方案。