SDK 与客户端
自定义客户端配置
为支持自定义服务商的客户端填写 iRouter 地址、协议、模型和密钥。
适用条件
客户端需要支持自定义 API 地址、密钥和模型,并支持目标协议。本页是配置字段对照,不代表每个版本的聊天客户端、配置管理器或 Agent 都已完成 iRouter 验收。
先在独立终端完成 curl 调用,再配置客户端,便于区分服务连接与客户端设置问题。
填写字段
字段 | 填写方式 |
|---|---|
服务商名称 | iRouter |
协议 | 与所选模型和线路匹配 |
OpenAI 兼容 Base URL | |
Anthropic Base URL | |
API Key | 当前账户创建的完整密钥,不附加 Bearer 字样 |
模型 ID | 从可用模型列表复制 |
有些客户端的“API 地址”字段只接受根地址,并自行添加 /v1;另一些接受带 /v1 的 Base URL。以客户端实际发出的路径核对,确保没有重复前缀。要求完整端点 URL 的字段,应填写 API 概览中的操作路径。
验证配置
保存后重启相关客户端,确认当前启用的服务商、模型和认证方式。发送简短文本,在 iRouter 用量页确认调用,再测试流式、工具和图片。连通性检测通过不代表具体模型和可选能力都可用。
配置管理器可能改写其他客户端的设置,变更前保存原配置。iRouter 文档不要求使用第三方预设或一键安装脚本,也不要求改变客户端的审批权限。
常见入口
编程客户端请看 Claude Code 和 Codex CLI。其他工具若无法自定义模型地址,请查其官方说明确认支持范围,勿把官网登录密码填入 API Key 字段。