Claude 和 GPT API 文档：密钥、SDK、客户端

一个密钥，两个兼容的 base URL，覆盖生产环境模型、客户端和媒体 API。

给 AI 智能体

遇到困难？交给 AI 智能体

把下面的链接发给任意 AI 智能体（Claude Code、Codex、Cursor……），让它帮您配置客户端：从各客户端的设置到最后的检查，智能体需要的信息都在里面。

三个步骤

1. 在个人中心获取密钥

   打开个人中心，为余额充值（或兑换交易平台的兑换码），然后点击“签发密钥”。

   app.oneprovider.dev 运作方式

2. 选择您的客户端

   每个客户端都有各自的简短指南。

   • Claude Code
   • Claude Desktop
   • Codex (OpenAI)
   • Cursor
   • Hermes Agent
   • Cline
   • OpenClaw
   • VS Code
   • OpenCode
   • Open Cowork
   • Factory Droid
   • n8n
   • Python SDK
   • Node SDK

3. 设置 base URL 和密钥

   密钥放在 x-api-key 或 Authorization: Bearer 请求头中。地址取决于客户端类型：

   Anthropic（Claude Code、Anthropic SDK），不带 /v1 https://api.oneprovider.dev OpenAI（Codex、Cursor、OpenAI SDK），带 /v1 https://api.oneprovider.dev/v1 bash

   curl -s https://api.oneprovider.dev/v1/models \
   -H "Authorization: Bearer sk-your-key-here"

   如果返回了模型列表，就说明密钥可以正常使用。

下一页

• 模型与价格
• 身份验证
• Messages API
• Chat Completions
• 个人中心与密钥
• 错误与诊断

快速解答

该使用哪个 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 状态码和完整的错误信息。客服如何运作 。