API 文档接口参考

GPT Image 2.5 Sunburst · OpenAI 兼容生图

POST /images/generations 兼容 OpenAI 图片接口,OpenAI SDK、LobeChat、Cherry Studio、Dify、n8n 都能直接调用这里的图片模型。size 会映射为最接近的 aspect_ratio,n 映射为 num_images,模型的其他参数可作为额外字段传入。最多等待约 110 秒,超时返回 504 和任务 id,可继续轮询。

POST/api/v1/images/generations需要 Bearer API Key
gpt-image-2.5-sunburst图片 · OpenAI模型详情与价格

此模型使用的接口

选择供应商可查看其实际参数限制。自动路由会选择支持所传参数的供应商。示例包含默认值和必填输入,请将示例媒体地址替换为可访问的文件。

请求

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

输入参数

JSON 请求体
model
string必填

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

可选值:"gpt-image-2.5-sunburst"
prompt
string必填

描述要生成的图片,必填且不能为空。

provider
string可选

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

project
string可选

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

size
string可选

宽 x 高,例如 1024x1024,或 auto。必要时映射到最接近的受支持宽高比。

n
integer可选

正整数,默认 1。多图生成需要模型支持 num_images。

默认值:1
最小值:1
response_format
string可选

url(默认)或 b64_json。Base64 转换失败或超过大小限制时,该条结果回退为 URL。

默认值:"url"
可选值:"url""b64_json"
image_urls
string<uri>[]可选

Optional — switches to image editing

最多数量:10
aspect_ratio
enum可选
默认值:"1:1"
可选值:"1:1""4:3""3:4""16:9""9:16""3:2""2:3"
quality
enum可选
默认值:"medium"
可选值:"low""medium""high""xhigh""max"
num_images
integer可选
默认值:1
最小值:1
最大值:4

响应示例

200 · application/json
{
  "created": 1792915200,
  "data": [
    {
      "url": "https://example.com/result.png"
    }
  ],
  "id": "gen_example",
  "model": "gpt-image-2.5-sunburst",
  "credits": 10
}

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

输出字段

created
integer

Unix 时间戳,单位为秒。

data
array

每项包含 url 或 b64_json,取决于 response_format 及转换是否成功。

id
string

创建任务返回的生成 ID。

model
string

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

credits
number

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

使用说明

  • 轮询间隔至少 3 秒。同步生图接口返回 504 时,任务可能仍在进行,应使用 error.id 查询,避免重复创建。
  • 调用 /generations 和 /quote 时,将以下参数放入 input;调用 /images/generations 时放在顶层;对话参数放在 /chat/completions 顶层。

给 AI 使用

把文档索引或完整接口文档交给 AI 编程助手,包含实时模型参数。