开始使用
从其他服务迁移到 iRouter
调整接口地址、凭据与模型,验证流式、工具和费用行为。
迁移前记录
记录应用使用的 SDK 版本、协议、模型 ID、超时、重试和可选参数。保留原配置,另建测试环境与 iRouter 密钥,避免将环境变量改动立即扩散到生产服务。
替换配置
配置项 | iRouter 值 |
|---|---|
OpenAI SDK Base URL | |
Anthropic SDK Base URL | |
API Key | 在 iRouter 创建的密钥 |
模型 | 当前密钥可用的完整模型 ID |
计价依据 | iRouter 模型与线路的实际价格 |
删去旧服务专属的主机、认证头和专有参数前,检查它们是否还承担其他功能。不要把旧分组名、自动选模别名、异步任务地址或模型别名直接带入 iRouter。
按能力验证
依次检查模型列表、非流式文本、流式结束事件、工具调用往返、结构化输出校验,以及应用需要的图片或音频输入。Responses 的状态管理、后台任务和其他扩展功能需要单独验证。
对照实际响应调整解析代码。原始 HTTP 响应与 SDK 的便捷属性可能不同,例如 Responses 的 output_text。发生失败时,确认重试不会重复执行工具或重复提交生成任务。
切换与回退
测试通过后逐步切换流量,观察错误、延迟、用量和费用。异常时恢复先前配置,保留脱敏的时间、模型和请求标识供排查。完成迁移后按原服务流程回收不再使用的密钥,并为 iRouter 凭据安排轮换。