开发文档

模型与选择

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。