开发文档
图像生成
使用 OpenAI Images 兼容接口生成和编辑图片，支持 `gpt-image-2`、`gpt-image-2.5-flare`、`gpt-image-2.5-sunburst`、`nano-banana-2`、`nano-banana-2.1`、`nano-banana-pro` 等模型。
文生图
终端
curl https://api.flyrouter.ai/v1/images/generations \
-H "Authorization: Bearer $FLYROUTER_API_KEY" \
-H "Content-Type: application/json" \
--max-time 660 \
-d '{
"model": "nano-banana-2",
"prompt": "一只在键盘上打字的橘猫，扁平插画风格",
"resolution": "2K",
"size": "16:9"
}'生成通常需要几十秒到几分钟，接口会等图片生成完再返回，请把客户端超时设为 10 分钟以上。返回结构与 OpenAI 一致：
json
{
"created": 1761800000,
"data": [
{ "url": "https://api.flyrouter.ai/v1/tasks/task_abc/artifacts/image-0/content?access=..." }
]
}图片链接带访问令牌，可以直接下载或展示，无需再带 API Key。需要长期保存的图片请下载到自己的存储。想直接拿到图片数据，可以加 "response_format": "b64_json"，图片会以 Base64 放在 data[].b64_json。
参数
| 参数 | 说明 |
|---|---|
model | 必填，图像模型 ID |
prompt | 必填，图片描述 |
resolution | 清晰度，默认 1K。GPT Image 可选 1K/2K/4K；nano-banana-2 另支持 0.5K |
size | 画面比例，如 1:1、16:9、9:16。GPT Image 只接受比例，不接受 1024x1024 这样的像素尺寸 |
n | 张数。gpt-image-2.5-* 支持 1–4，其他模型为 1 |
image_urls | 参考图链接数组（也可用 Data URL），用于图生图或多图融合 |
response_format | url（默认）或 b64_json |
不同清晰度价格不同，以 模型价格 页面为准。
编辑图片
用 POST /v1/images/edits 上传原图并描述修改，multipart/form-data 格式，图片字段为 image（多张用 image[]），单张不超过 20 MB：
终端
curl https://api.flyrouter.ai/v1/images/edits \
-H "Authorization: Bearer $FLYROUTER_API_KEY" \
--max-time 660 \
-F model="nano-banana-2" \
-F image="@photo.png" \
-F prompt="把背景换成星空"超时后取回结果
极少数情况下生成超过 10 分钟，接口会返回 504，错误码 task_timeout，错误信息里带任务 ID（如 task_abc）。任务仍会在后台完成，可以稍后查询：
终端
# 查询任务状态：SUCCESS 表示已完成，FAILURE 表示失败
curl https://api.flyrouter.ai/v1/tasks/task_abc -H "Authorization: Bearer $FLYROUTER_API_KEY"
# 获取生成结果的下载链接
curl https://api.flyrouter.ai/v1/tasks/task_abc/artifacts -H "Authorization: Bearer $FLYROUTER_API_KEY"artifacts 返回的每一项都有 content_url，即图片下载地址。
不支持的用法
- 流式返回（
stream: true）。 - 生成失败时返回
400，错误码image_generation_failed，失败的请求不扣费。
FlyRouter