開發文件

模型與選擇

FlyRouter 提供 Claude、GPT、Gemini、Grok、DeepSeek 等系列的文字模型，以及 GPT Image、Nano Banana 等影像模型。模型 ID 與各廠商官方保持一致，換用 FlyRouter 時不用改模型名。

查詢可用模型

模型列表會隨上架即時變化，以介面回傳為準：

終端機

curl https://api.flyrouter.ai/v1/models \
  -H "Authorization: Bearer $FLYROUTER_API_KEY"

回傳目前 Key 可以呼叫的全部模型（如果 Key 限制了可用模型，只回傳允許的那些）：

json

{
  "object": "list",
  "data": [
    { "id": "claude-sonnet-5-5", "object": "model" },
    { "id": "gpt-6.1-sol", "object": "model" }
  ]
}

每個模型的單價、上下文長度與快取價格見模型價格頁面。

系列	代表模型 ID	推薦協定
Claude	`claude-opus-5-5`、`claude-sonnet-5-5`、`claude-haiku-5-5`、`claude-fable-5-1`	Anthropic 原生
GPT	`gpt-6.1-sol`、`gpt-6-astra`、`gpt-6-luna`	OpenAI 相容（Chat Completions 或 Responses）
Gemini	`gemini-4-argon`	Gemini 原生或 OpenAI 相容
Grok	`grok-4.7`、`grok-4.6`	OpenAI 相容
DeepSeek	`deepseek-v4-pro`、`deepseek-v4-flash`	OpenAI 相容
影像	`gpt-image-2`、`nano-banana-2`、`nano-banana-pro`	OpenAI Images

程式設計與複雜 Agent 任務：claude-opus-5-5、claude-sonnet-5-5 或 gpt-6.1-sol。Claude Code 推薦 Sonnet 做主力、Opus 處理難題。
最強推理：claude-fable-5-1，適合長時間、高難度的推理與規劃，單價也最高。
日常對話、客服、批次處理：claude-haiku-5-5、deepseek-v4-flash 等輕量模型，速度快、成本低。
圖片理解：Claude、GPT、Gemini 系列都支援圖片輸入，見圖片理解。
生成圖片：見影像生成。

協定與模型的對應

所有文字模型都能透過 OpenAI 相容的 /v1/chat/completions 呼叫。但 Claude 建議走 Anthropic 原生協定，才能完整使用提示詞快取、深度思考等能力；/v1/responses 只支援 GPT 系列。

報 model_not_found 或 503 時：

用 GET /v1/models 核對模型 ID 拼寫，注意 - 和 . 的區別（如 claude-sonnet-5-5 與 gpt-6.1-sol）。
確認這個 Key 沒有限制可用模型。
確認端點和模型匹配，比如不要用 /v1/responses 呼叫 Claude。