身份验证

OneProvider 同时支持 OpenAI 风格的 Bearer 和 Anthropic 风格的 x-api-key。二选一即可，不要同时使用。

请求头写法

API 接受任意一种请求头。请使用您的 SDK 默认发送的那一种。

Authorization: Bearer sk-... # OpenAI-style
x-api-key: sk-... # Anthropic-style

环境变量

我们的示例把密钥放在 ONEPROVIDER_KEY 中。但各 SDK 客户端默认会自动读取它们各自的原生变量名：要么用该名称导出密钥，要么在构造函数中显式传入 ONEPROVIDER_KEY。下表列出了每个工具读取的变量：

验证身份验证是否生效

请求 /v1/models 即可进行一次成本低、无副作用的检查：

curl -s https://api.oneprovider.dev/v1/models \
-H "x-api-key: $ONEPROVIDER_KEY" | jq '.data[].id'

成功的响应会列出当前可用的模型。如果这里返回 401，说明密钥格式有误、已被撤销或尚未生效。

密钥存放位置

• 环境变量：适用于大多数场景的默认做法。
• ~/.zshrc / ~/.bashrc，并设置 HISTCONTROL=ignorespace，这样以空格开头的命令不会进入 shell 历史记录。
• 密钥管理工具：1Password CLI、AWS Secrets Manager、Doppler、GCP Secret Manager。
• 各项目自己的 .env 文件，务必加入 .gitignore。

常见陷阱

• 末尾斜杠。https://api.oneprovider.dev/v1/ 与 https://api.oneprovider.dev/v1 不同：有些 SDK 会直接拼接路径。请使用上面不带末尾斜杠的写法。
• 重复的 Bearer。当工具已经自动加上 Bearer，而您又手动加了一次，就会出现 Authorization: Bearer Bearer sk-...。请在配置中去掉这个前缀。
• Anthropic 版本请求头。直接发送原始 HTTP 请求时，务必带上 anthropic-version: 2023-06-01。SDK 会自动添加。

轮换密钥

在个人中心签发新密钥（“密钥” → “签发密钥”），在各客户端中更新，然后删除旧密钥。操作即时生效且免费，个人中心的所有密钥共用同一份余额。更多信息：个人中心与密钥 。

快速解答

该使用哪个 base URL？

Claude Code 和 Anthropic SDK 使用 https://api.oneprovider.dev。OpenAI SDK 和兼容 OpenAI 的客户端使用 https://api.oneprovider.dev/v1。同一个密钥可用于这两个地址；模型列表见模型页面 ，费率见价格页面 。

如何进行身份验证？

将完整的 sk-… 密钥放在 x-api-key 或 Authorization: Bearer 中，二选一，不要同时使用。请把密钥存放在环境变量中，不要写进会被提交的文件。了解更多身份验证说明 。

在哪里获取密钥？

在 Telegram 机器人 @oneprovider_robot 或 app.oneprovider.dev 打开您的个人中心，为余额充值，然后点击“签发密钥”。每个密钥都可以设置各自的消费限额。个人中心与 API 密钥 。

401、404 和 429 是什么意思？

401：密钥缺失、拼写有误或放错了请求头；请粘贴完整的密钥，不要带引号或空格。404：通常是 base URL 不对，例如缺少或重复了 /v1。429 且提示“Insufficient balance”：个人中心余额或密钥的消费限额已用完，请充值，不要反复重试；其他 429 属于速率限制，请等待 Retry-After 指定的时间。详情见：错误码 和故障排查 。

流式输出为什么会中断或被重置？

VPN 和 VLESS 代理常常会缓冲 SSE，或破坏 HTTP/2 协商。OneProvider 没有地区限制，也不会缓冲流式输出，请关闭代理后重试。

以上都没解决，该去哪里咨询？

请在 Telegram 联系 @Oneproviderhelpbot ，或在网页个人中心打开“客服”，并附上 HTTP 状态码和完整的错误信息。客服如何运作 。