API 参考

Images

POST https://api.flyrouter.ai/v1/images/generations

POST https://api.flyrouter.ai/v1/images/edits

OpenAI Images 兼容的生图与改图接口。接口会等待图片生成完成后同步返回，耗时通常为几十秒到几分钟，请把客户端超时设为 10 分钟以上。使用说明与示例见图像生成。

生成图片

终端

curl https://api.flyrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $FLYROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  --max-time 660 \
  -d '{
    "model": "gpt-image-2",
    "prompt": "极简风格的咖啡店 Logo，白色背景",
    "size": "1:1",
    "resolution": "1K"
  }'

请求参数

参数	类型	说明
`model`	string	必填。`gpt-image-2`、`gpt-image-2.5-flare`、`gpt-image-2.5-sunburst`、`nano-banana-2`、`nano-banana-2.1`、`nano-banana-pro`
`prompt`	string	必填。图片描述
`resolution`	string	`0.5K`（仅 `nano-banana-2`）、`1K`（默认）、`2K`、`4K`
`size`	string	画面比例，如 `1:1`、`3:2`、`16:9`、`9:16`。GPT Image 不接受像素尺寸
`n`	integer	张数。`gpt-image-2.5-*` 为 1–4，其他模型只能为 1
`image_urls`	array	参考图，`https://` 链接或 Data URL
`response_format`	string	`url`（默认）或 `b64_json`

响应

json

{
  "created": 1761800000,
  "data": [
    { "url": "https://api.flyrouter.ai/v1/tasks/task_abc/artifacts/image-0/content?access=..." }
  ]
}

使用 b64_json 时，每一项会同时带 b64_json（图片的 Base64）和 url。

编辑图片

请求体为 multipart/form-data：

字段	说明
`model`	必填。图像模型 ID
`prompt`	必填。修改说明
`image` / `image[]`	必填。原图文件，单张不超过 20 MB，多张用 `image[]`
`resolution`、`size`、`response_format`	同上

终端

curl https://api.flyrouter.ai/v1/images/edits \
  -H "Authorization: Bearer $FLYROUTER_API_KEY" \
  --max-time 660 \
  -F model="gpt-image-2" \
  -F image="@product.png" \
  -F prompt="把产品放到木质桌面上，柔和自然光"

错误

状态码	错误码	说明
`400`	`image_generation_failed`	生成失败（如内容不合规），不扣费
`400`	—	参数不合法，如 GPT Image 传了像素尺寸，或 `n` 超出范围
`504`	`task_timeout`	超过 10 分钟仍未完成，任务继续在后台执行，可用错误信息里的任务 ID 调用 `GET /v1/tasks/{task_id}/artifacts` 取回结果

Images

生成图片#

请求参数#

响应#

编辑图片#

错误#

生成图片

请求参数

响应

编辑图片

错误