从 OpenRouter 或其他网关迁移到 FlyRouter

先迁移一个应用或 API Key,验证协议与模型 ID,并核对实际调用记录后再增加流量。兼容同一种 SDK 格式,不代表所有厂商专属功能完全一致。

更新日期:

修改地址前记录现有配置

记录接口地址、SDK 版本、模型 ID、流式设置、工具调用、结构化输出、图像输入、超时和重试策略。保留旧配置用于回滚,不将生产密钥放入公开示例。

匹配协议与地址

应用协议FlyRouter Base URL指南
OpenAI Chat Completions / Responseshttps://api.flyrouter.ai/v1快速开始
Anthropic Messageshttps://api.flyrouter.aiClaude Code
Gemini 原生https://api.flyrouter.aiAPI 参考

采用价格目录中的完整 ID。其他网关接受的名称可能是此处不支持的别名。密钥放入环境变量或密钥管理器。

从 OpenRouter 迁移时要改的地方

  • Base URL:把 https://openrouter.ai/api/v1 换成 https://api.flyrouter.ai/v1。
  • 模型 ID:去掉厂商前缀,并按价格目录的写法填写,例如 anthropic/claude-opus-5.5 对应 claude-opus-5-5。
  • 请求参数:移除 provider 路由设置和 models 回退列表,FlyRouter 不提供这两项。

两者在价格、手续费和模型目录上的差别见 FlyRouter 对比 OpenRouter。

验证少量真实请求

  1. 发送短文本请求,检查状态、模型 ID 与 usage。
  2. 如需流式输出,验证流式响应与取消操作。
  3. 用真实 schema 测试工具调用和结构化输出,不能只测一句问候。
  4. 分别验证图像输入、缓存等必要功能。
  5. 核对控制台扣费与重试行为,避免无限重试。

记录客户端版本与日期,未测功能标为未测。文本请求成功不能证明全部 Agent 功能可用。

逐步迁移并保留回滚

从小工作负载开始,观察错误、任务完成质量、延迟和总费用。将原接口及模型映射保留为可切换配置。必要功能不符合预期时,停止增加流量,切回原配置后排查。

参考错误与重试、费用核对和服务指标。此迁移流程不表示网关提供自动跨供应商故障切换。