开始使用
创建与管理 API 密钥
创建密钥、选择线路、设置来源限制并进行轮换。
创建并保存密钥
进入API 密钥,先确认个人或团队上下文,再创建密钥。使用能识别用途的名称,例如开发环境或某个服务,并选择该服务需要的线路。
创建成功时保存完整密钥。这是控制台展示该密钥明文的机会,关闭后列表只保留掩码。遗失明文时创建替代密钥,验证应用后停用旧密钥。
独立的 API Key 输入框只填写密钥本身。HTTP 请求头中才使用 Authorization: Bearer <your-irouter-api-key>。账户密码不能代替密钥。
线路和来源限制
线路决定请求可使用的资源及对应价格,切换前检查模型与线路。密钥启用不代表所有模型都可用。
IP 白名单支持单个 IP 和 CIDR。填写应用实际对外访问的出口地址;本机内网地址通常不是网关看到的来源。修改白名单需要安全验证。团队还可能设置团队级白名单,调用须满足适用的限制。
停用与轮换
- 为同一服务创建新密钥,设置所需线路和限制。
- 在服务端密钥管理配置中替换凭据,部署后发送测试请求。
- 确认用量记录归属正确,再停用旧密钥;确认不再使用后删除。
怀疑泄露时立即停用相关密钥,再检查异常用量。管理员暂停的密钥应根据页面显示的原因联系管理员处理,所有者不能直接解除这类暂停。
验证配置
使用新密钥按模型查询与 curl 指南完成验证。密钥放在服务端环境变量或密钥管理系统,不应写入网页、移动应用安装包、仓库或问题报告。