API 中转接入指南
API 中转提供统一的大模型调用入口，一份接口即可访问多家上游模型服务。本文介绍从获取密钥到完成首次调用的完整流程。
一、获取 API 密钥
- 使用统一账号登录 API 中转控制台
- 进入「密钥管理」，点击「创建密钥」
- 为密钥设置名称与可用模型范围，保存后妥善保管密钥串
密钥仅在创建时完整展示一次，请立即复制保存；如遗失请吊销后重新创建。
二、发起首次调用
API 中转兼容主流大模型的对话接口格式，将请求地址替换为中转入口即可：
- 请求地址：
https://api.yurenai.cn/v1/chat/completions - 鉴权方式：请求头携带
Authorization: Bearer <你的密钥> - 模型字段：填写控制台「模型列表」中展示的模型标识
三、流式输出与错误处理
- 设置
stream: true开启流式输出，按事件流逐段读取 - 常见错误码：
401密钥无效、429触发限流、5xx上游服务异常 - 建议为客户端实现指数退避重试，幂等处理超时请求
四、配额与用量管理
控制台「用量统计」页提供按模型、按密钥维度的调用量与消耗明细：
- 支持为单个密钥设置月度配额上限
- 用量接近上限时可开启邮件提醒
- 团队空间内可查看各成员的汇总用量
五、常见问题
- 是否支持私有模型接入？ 支持，企业版可登记自建推理端点纳入统一路由。
- 计费粒度是什么？ 按上游模型的 token 用量计费，明细可在账单页导出。