从 OpenAI 迁移

只需改三行。您现有的 OpenAI SDK 继续可用。

改动内容

- client = OpenAI()
+ client = OpenAI(
+ api_key=os.environ["ONEPROVIDER_KEY"],
+ base_url="https://api.oneprovider.dev/v1",
+ )

按工作负载选择

我们不会凭空编造不同厂商模型名称之间的一一对应关系。请根据质量、成本和延迟要求选择当前的 GPT 档位：

无需修改即可使用的功能

• chat.completions.create，以及 messages、temperature、max_tokens、stream。
• 通过 tools 进行函数调用；tool_choice: "auto"。
• JSON 模式（response_format: {"type": "json_object"}）。
• 在 Python 和 Node 中都可通过异步迭代器使用流式输出。

有哪些变化

• seed 和 logprobs 会被静默忽略。
• 返回的 ID 前缀是 chatcmpl-op-，而不是 chatcmpl-。
• 旧版 function_call 结构会在内部映射为 Anthropic 的 tool_use；对外的响应结构不变。

使用 OpenAI 的 Codex CLI

如果您使用 OpenAI 的 Codex CLI，请将它指向我们的 Responses API 端点，并沿用同一个密钥。完整设置见 Codex 客户端页面 。简要来说：密钥放在 ~/.codex/auth.json，~/.codex/config.toml 中设置 base_url = "https://api.oneprovider.dev/v1" 和 wire_api = "responses"。

迁移后检查

response = client.chat.completions.create(
model="gpt-6.1-terra",
messages=[{"role": "user", "content": "Reply with: migration works"}],
)
print(response.choices[0].message.content)

从 OpenRouter 或其他网关切换

我的客户端要改什么？

三项设置：base URL、密钥和模型 ID。OpenAI SDK 和兼容 OpenAI 的工具使用 https://api.oneprovider.dev/v1；Claude Code 和 Anthropic SDK 使用 https://api.oneprovider.dev。同一个 OneProvider 密钥可用于这两个地址。

模型 ID 有什么不同？

OneProvider 的 ID 没有厂商前缀，例如 claude-sonnet-5-5 或 gpt-6.1-terra。请从模型页面 复制：未知的 ID 会返回 400 并指出问题所在。

OneProvider 还提供什么？

一个密钥即可使用 Anthropic 原生和兼容 OpenAI 的端点；预付余额不会过期，也没有订阅；支持用加密货币、银行卡、Apple Pay、Google Pay 或 SBP 充值；每个密钥可设置消费限额和有效期；并提供每个请求的用量记录。按政策不会存储提示词文本；服务器位于法兰克福。

怎样比较成本？

请比较同一个模型：每百万 token 的价格（包括缓存价格）见价格页面 。然后跑一个真实任务，在用量记录中查看实际扣费。

快速解答

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