如何将您的 Claude API 密钥替换为我们的密钥
将 Claude API 密钥替换为无审查、OpenAI 兼容端点的密钥大约需要十分钟,前提是代码已经使用聊天补全格式。本指南将引导您完成新密钥、基础 URL、测试请求、流式传输、工具、成本以及切换过程中可能遇到的错误。
摘要
- 切换只需更换密钥和基础 URL;请求格式保持不变。
- 在迁移生产流量之前,先在模型 id uncensored 上运行一次测试请求。
- 成本为每 100 万输入令牌 $0.15 和每 100 万输出令牌 $0.50,从预付费信用中计费。
- 在旧密钥在配置中干净运行几天之前,保留它。
为什么开发者正在将密钥切换到无审查端点
部分合法工作负载在标准助手上会遇到拒绝,例如成人小说、直白的医学问题或安全研究。uncensored 端点直接回答这些请求,唯一的硬性限制是涉及未成年人的性内容。
提前决定您的产品接受哪些请求,因为模型不会为您做出该决定。
步骤 1:获取你的新无审查 API 密钥
在“获取 API 密钥”页面上使用 Google 或邮箱和密码注册。密钥会立即显示在屏幕上。账户初始包含 7 天内有效的 $0.50 试用额度,且无需信用卡。
- 将密钥存储在环境变量中,永远不要存储在客户端代码中。
- 随时轮换密钥;旧密钥会立即停止工作。
步骤 2:在代码中更新您的 Base URL
将基础 URL 设置为 https://mistralgetapikey.com/v1 并在 Authorization 标头中传递新密钥作为 Bearer 令牌。将基础 URL 保留在配置中,以便在不部署的情况下更改它。
保留客户端其余部分不变。消息、角色和响应解析器均保持不变。
步骤 3:通过测试请求验证切换
发送一个短请求,模型ID为 uncensored. 带有 usage 块的回复确认了密钥、base URL 和 model id 一起工作。
如果调用失败,请先查看状态码。401 表示密钥错误,402 表示信用额度已用完。
在您现有代码中处理流式响应
设置 stream: true 如果您的产品已经支持流式传输。每个服务器发送的事件携带答案的一部分,最后一个事件携带使用数据。
也在慢速连接上测试流式传输,因为断开的流应在界面中以清晰错误消息结束,而不是半截回复。
函数调用兼容性检查
如果您的应用使用工具,请定义一个带有 JSON 架构的函数,并让模型调用它。返回结果,然后检查最终答案是否正确使用了它。
- 测试具有两个必需参数的工具。
- 测试连续调用的两个工具。
- 在执行操作之前验证参数。
监控令牌使用情况与成本
存储每个响应的输入和输出令牌计数,以及请求 ID。将它们乘以每 1M 令文的 $0.15 和 $0.50,以计算每次调用的成本。
| 工作负载 | 输入 token | 输出 token | 成本 |
|---|---|---|---|
| 简短聊天回合 | 1,000 | 400 | $0.0003 |
| 长文档总结 | 80,000 | 2,000 | $0.0130 |
排查常见连接错误
大多数切换问题来自三个原因:带有额外空格或换行符的密钥,仍然指向旧服务的 base URL,或缺少 /v1 在 URL 的末尾。
每个密钥允许每分钟 300 次请求和 8 个同时请求。429 表示请放慢速度,通过退避重试即可解决。
最终验证与上线
在同一组提示下运行两个端点几天,比较答案、延迟和成本。逐步迁移流量,观察每一步后的错误率,并在新密钥干净运行之前将旧密钥保留在配置中。
当数字符合您的预期时,从环境中移除旧密钥,并从代码审查清单中移除。
常见问题
切换后我的现有代码还能工作吗?
在大多数情况下是的。端点使用聊天补全格式,因此只需更改基础 URL 和密钥。
我应该发送哪个 model id?
发送 uncensored。它是服务中唯一的模型,因此 ID 不会更改。
是否有免费测试方式?
是的。新账户获得 $0.50 试用信用额,有效期 7 天,无需信用卡即可开始。
我如何向余额添加资金?
使用 TRC20 上的 USDT 或 Base 上的 USDC 支付,起付 $20。充值 $50 起享赠额,且信用额度永不过期。
获取您的 API 密钥
注册,获取密钥,更新基础 URL。简单。