从 OpenRouter 或其他网关迁移到 FlyRouter
先迁移一个应用或 API Key,验证协议与模型 ID,并核对实际调用记录后再增加流量。兼容同一种 SDK 格式,不代表所有厂商专属功能完全一致。
更新日期:
修改地址前记录现有配置
记录接口地址、SDK 版本、模型 ID、流式设置、工具调用、结构化输出、图像输入、超时和重试策略。保留旧配置用于回滚,不将生产密钥放入公开示例。
匹配协议与地址
| 应用协议 | FlyRouter Base URL | 指南 |
|---|---|---|
| OpenAI Chat Completions / Responses | https://api.flyrouter.ai/v1 | 快速开始 |
| Anthropic Messages | https://api.flyrouter.ai | Claude Code |
| Gemini 原生 | https://api.flyrouter.ai | API 参考 |
采用价格目录中的完整 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。
验证少量真实请求
- 发送短文本请求,检查状态、模型 ID 与 usage。
- 如需流式输出,验证流式响应与取消操作。
- 用真实 schema 测试工具调用和结构化输出,不能只测一句问候。
- 分别验证图像输入、缓存等必要功能。
- 核对控制台扣费与重试行为,避免无限重试。
记录客户端版本与日期,未测功能标为未测。文本请求成功不能证明全部 Agent 功能可用。
逐步迁移并保留回滚
从小工作负载开始,观察错误、任务完成质量、延迟和总费用。将原接口及模型映射保留为可切换配置。必要功能不符合预期时,停止增加流量,切回原配置后排查。