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 取回結果 |
FlyRouter