GPT Image 2.5 Sunburst · 创建生成任务

此模型使用的接口

请求

curl 'https://01router.com/api/v1/generations' \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "gpt-image-2.5-sunburst",
  "input": {
    "prompt": "A cinematic landscape at sunrise.",
    "aspect_ratio": "1:1",
    "quality": "medium",
    "num_images": 1
  }
}'

model

string必填

模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。

可选值:"gpt-image-2.5-sunburst"

input

object必填

模型专属的输入对象。必填字段、默认值和限制见对应模型文档。

provider

string可选

可选供应商 slug。不传时自动路由；项目配置可能固定供应商。

project

string可选

可选项目 ID，使用该项目公开的模型目录和路由配置。

callback_url

string<uri>可选

公开 HTTPS 地址，最长 1,000 字符。接收最终任务对象，不允许内网地址。

input.prompt

string必填

input.image_urls

string<uri>[]可选

Optional — switches to image editing

最多数量:10

input.aspect_ratio

enum可选

默认值:"1:1"

可选值:"1:1""4:3""3:4""16:9""9:16""3:2""2:3"

input.quality

enum可选

默认值:"medium"

可选值:"low""medium""high""xhigh""max"

input.num_images

integer可选

默认值:1

最小值:1

最大值:4

响应示例

{
  "id": "gen_example",
  "object": "generation",
  "model": "gpt-image-2.5-sunburst",
  "type": "image",
  "provider": "fal",
  "status": "processing",
  "input": {
    "prompt": "A cinematic landscape at sunrise.",
    "aspect_ratio": "1:1",
    "quality": "medium",
    "num_images": 1
  },
  "outputs": [],
  "error": null,
  "credits": 100,
  "price_usd": 1,
  "created_at": "2026-10-25T08:00:00.000Z",
  "completed_at": null
}

响应仅用于说明结构；ID、用量、价格和结果以实际请求为准。

输出字段

id

string

创建任务返回的生成 ID。

object

"generation"

generation

model

string

模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。

type

video | image | audio | chat

provider

string

可选供应商 slug。不传时自动路由；项目配置可能固定供应商。

status

string

queued（排队）/ processing（处理中）/ succeeded（成功）/ failed（失败）。成功或失败后停止轮询。

input

object

模型专属的输入对象。必填字段、默认值和限制见对应模型文档。

outputs

string[]

结果文件 URL 列表；结果未就绪时为空。链接可能过期，请及时下载。

error

string | null

失败时的错误信息，否则为 null。

credits

number

该任务扣除的积分，退款后为 0。

price_usd

number

该任务的美元价格，退款后为 0。

created_at

string

ISO 8601 格式的创建时间。

completed_at

string | null

ISO 8601 格式的完成时间，进行中为 null。

使用说明

• 轮询间隔至少 3 秒。同步生图接口返回 504 时，任务可能仍在进行，应使用 error.id 查询，避免重复创建。