此頁面目前僅提供簡體中文版本。導覽與選單已經是繁體中文。
身份验证
使用个人或团队 InOneAPI API Key,不要使用供应商 Key 或登录会话 Cookie 代替。
发送密钥
OpenAI 兼容与文件入口使用 Authorization: Bearer $INONEAPI_API_KEY。Anthropic Messages 与 count_tokens 优先读取 x-api-key,也兼容 Bearer;避免同时提供不同的 Key。Anthropic 客户端使用 anthropic-version: 2023-06-01。
curl https://api.inoneapi.com/v1/models \
-H "Authorization: Bearer $INONEAPI_API_KEY"
JSON 请求使用 Content-Type: application/json;文件上传让 multipart 客户端自动设置 boundary。X-APP-NAME、X-APP-URL 可选,详见请求头。
个人与团队 Key
个人 Key 用于个人调用并检查个人钱包余额。团队 Key 归属项目,检查项目状态、Key 与项目预算;模型范围、路由模式、RPM、TPM 和并发按当前配置生效。不要假设存在单独的临时 Key 或自动过期机制。
有权限的用户可以在控制台查看完整 Key。服务端保存鉴权哈希及加密密钥,用于授权揭示;“仅显示一次且无法恢复”不适用于当前实现。
错误与轮换
- 401:未提供 Key 或 Key 无效;删除的 Key 不能继续使用。
- 402:余额不足、Key/项目预算用尽,或普通模型请求的项目被停用。
- 403:模型不在 Key 允许范围,或文件请求所属项目被停用。
- 429:Key 限流或路由容量不足,遵循返回的
Retry-After。
不要将密钥放入浏览器、移动应用、公开仓库或日志。轮换时创建新 Key、更新服务并确认流量迁移后删除旧 Key。泄露时立即撤销;保留 Trace 元数据排查,不记录密钥。