文档
Anthropic(Claude)API key
在 platform.claude.com 的 Settings → API keys 下创建 Anthropic Claude API key — 密钥以 sk-ant- 开头,且只显示一次。无需 Anthropic 账号,即可通过 OpenAI SDK 或原生 Messages API 使用 Kunavo key 调用相同的 Claude 模型。
如需获取 Anthropic Claude API key,请登录 platform.claude.com 上的 Claude Console,打开 Settings → API keys,然后点击 Create Key。Anthropic API key 以 sk-ant- 开头,且只在创建时显示一次。Anthropic 的控制台已从 console.anthropic.com 迁移至 platform.claude.com,密钥页面现位于 platform.claude.com/settings/keys。向 https://api.anthropic.com 发送请求时,Anthropic API key 使用 x-api-key 标头和 anthropic-version 标头进行身份验证,而不是使用 Authorization: Bearer。Anthropic 的定价常见问题说明,新用户会获得少量免费额度用于测试 API;该额度之外没有免费套餐,因此初始额度用完后,Claude API 按 token 计费。
Kunavo 是一个独立且兼容 OpenAI 的 AI API 网关:只需一个 API 密钥和一个按量付费余额,即可调用 Claude、GPT 以及图像、视频和音频模型,无需为每个提供商单独开设账户。 Kunavo API key 以 sk-kn- 开头,在 kunavo.com/app/keys 创建,无需 Anthropic 账号。Kunavo 通过 OpenAI 兼容端点 https://api.kunavo.com/v1/chat/completions 和原生 Anthropic 端点 https://api.kunavo.com/v1/messages 提供 Claude 服务,因此只需更改 base_url,即可通过官方 OpenAI SDK 调用 Claude。Kunavo 按用量付费,最低充值金额为 $10,且不向新账号提供免费额度。
方案 A — 直接从 Anthropic 获取 API key
如果项目今后只会调用 Claude,那么 Anthropic Console key 是合适的选择。Anthropic 按 token 对密钥计费,并在功能发布当天支持所有 Claude 功能。
- 前往
platform.claude.com并登录。旧地址 console.anthropic.com 现在会跳转到同一个控制台。 - 打开 Settings → API keys(直达链接:
platform.claude.com/settings/keys),然后点击 Create Key。Anthropic key 的格式为sk-ant-...,且只显示一次。 - 在 Billing 下添加付款方式。Anthropic 会向新用户赠送少量免费额度,之后按 token 计费。
- 将密钥作为
x-api-key发送,并同时附上anthropic-version标头。
# Anthropic direct — x-api-key, not Bearer
curl https://api.anthropic.com/v1/messages \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "claude-sonnet-5",
"max_tokens": 256,
"messages": [{"role": "user", "content": "Hello, Claude"}]
}'有一点需要提前考虑:Anthropic key 只能调用 Claude。如果项目还要调用 GPT、图像或视频模型,就需要为每个服务提供商分别注册账号、创建密钥、使用 SDK 并接收账单。
方案 B — 使用一个 Kunavo key 调用 Claude 和其他所有模型
Kunavo 同时通过 OpenAI 兼容 API 和原生 Anthropic Messages API 提供 Claude 服务。只需一个 sk-kn- key,即可使用同一个由 Stripe 充值的余额调用 Claude 和目录中的所有其他模型,无需 Anthropic 账号。
| Anthropic Console 密钥 | Kunavo 密钥 | |
|---|---|---|
| 模型 | 仅 Claude | Claude、GPT、图像、视频、音频 |
| 端点 | api. | api. |
| APIs | Messages API | OpenAI 兼容 API + Messages API |
| 身份验证标头 | x-api-key | Authorization: Bearer |
| 服务提供商账号 | 需要 Anthropic 账号 | 无需账号 |
| 计费 | Anthropic 按 token 计费 | 一个由 Stripe 充值的余额 |
| 密钥格式 | sk-ant-... | sk-kn-... |
- 创建 Kunavo 账号并充值 $10。Kunavo 按用量付费,余额永不过期。
- 在
/app/keys生成密钥。Kunavo key 只显示一次;请将其保存在环境变量中。 - 将 OpenAI SDK 指向
https://api.kunavo.com/v1,然后调用 Claude slug。
Claude API key 与 Anthropic API key
“Anthropic API 密钥”和“Claude API 密钥”是同一种凭据的两种叫法。Anthropic 是公司,Claude 是模型系列,而在 Claude Console 中创建的密钥用于验证 Claude API 调用。下面这两种密钥的区别在于各自的来源,以及各自能够访问的服务:
- Anthropic Console key(
sk-ant-...)— 在platform.claude.com/settings/keys创建。Anthropic Console key 只能调用 Claude,费用由 Anthropic 按 token 收取。 - Kunavo key(
sk-kn-...)— 在kunavo.com/app/keys创建。Kunavo key 无需 Anthropic 账号,即可通过 OpenAI SDK 或原生 Messages API 调用相同的 Claude 模型,以及 GPT、图像、视频和音频模型;费用统一从一个由 Stripe 充值的余额中扣除。
使用 Python 调用 Claude
保留官方 OpenAI SDK。迁移只需更改 base_url 和模型名称。
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["KUNAVO_API_KEY"],
base_url="https://api.kunavo.com/v1", # the only line that changes
)
resp = client.chat.completions.create(
model="claude-sonnet-5",
messages=[{"role": "user", "content": "Explain quicksort in one paragraph."}],
)
print(resp.choices[0].message.content)使用 Node.js 调用 Claude
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.KUNAVO_API_KEY,
baseURL: "https://api.kunavo.com/v1",
});
const resp = await client.chat.completions.create({
model: "claude-sonnet-5",
messages: [{ role: "user", content: "Explain quicksort in one paragraph." }],
});
console.log(resp.choices[0].message.content);也可以使用 curl 调用 Claude
curl https://api.kunavo.com/v1/chat/completions \
-H "Authorization: Bearer $KUNAVO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-5",
"messages": [{"role": "user", "content": "Hello, Claude"}]
}'/v1/messages — 参见 Messages API 参考。Claude API key 无法使用
Claude API key 返回 401 authentication_error 时,几乎总是以下五种原因之一:端点所需的标头不正确、将密钥发送到了该密钥不适用的端点、环境变量中混入了空格或引号、密钥已撤销,或该密钥对应的 base URL 错误。
最常见的原因是标头不匹配。Anthropic 原生 API 要求使用 x-api-key 和 anthropic-version。包括 Kunavo 在内的 OpenAI 兼容端点要求使用 Authorization: Bearer。sk-ant- key 只能用于 api.anthropic.com,sk-kn- key 只能用于 api.kunavo.com。
| 症状 | 可能原因 | 修复方法 |
|---|---|---|
401 unauthorized | 密钥错误、已撤销,或向该端点发送时使用了错误的标头 | 在 /app/keys 重新创建密钥,并使用 Authorization: Bearer sk-kn-… 发送 |
402 insufficient_ | 余额为空或已达到单个密钥的支出上限 | 充值或提高该密钥的上限 |
model not found | slug 错误 | 使用 claude-sonnet-5 这样的精确 slug;浏览 /models |
429 rate limit | 短时间内请求过多 | 暂停后使用指数延迟重试 |
以下每种错误都有专门的深入说明,其中包含准确的错误 JSON、所有已知原因和可直接复制粘贴的修复方法:401 invalid api key、429 rate_limit_error、credit balance too low / 402、529 overloaded 和 model_not_found。
不使用信用卡调用 Claude API
Anthropic 为标准 Claude API 账号接受主流信用卡,仅向企业客户提供账期付款,因此直接使用 Anthropic 时,实际需要准备一张信用卡。
Kunavo 余额可以通过以下任一方式充值,完全无需信用卡:ACH bank debit (US bank accounts, settles in 3–5 business days), Alipay (mainland China), WeChat Pay (mainland China), UPI (India), Pix (Brazil), iDEAL (Netherlands), Bancontact (Belgium), EPS (Austria), MB WAY (Portugal), Satispay (Italy), BLIK (Poland), Bacs Direct Debit (United Kingdom, settles in several business days), Pay by Bank (United Kingdom, Ireland and Finland), Crypto (stablecoins) (US-dollar checkouts)。Kunavo 以美元定价充值金额,并由 Stripe 在结账页面进行货币换算,因此巴西用户可以扫描 Pix 付款码,以雷亚尔金额支付,无需寻找支持国际购物的信用卡。也可以使用信用卡关联的钱包,但我们有意不将其列入该列表,因为依赖信用卡的钱包无法解决这里的问题。完整的支付方式列表请参见 计费参考。
选择哪个 Claude 模型
- claude-haiku-4-5 — 成本最低、速度最快,适合高吞吐量的分类和客服任务。Kunavo 对 Claude Haiku 4.5 的定价为:每 1M 输入 token $0.70,每 1M 输出 token $3.50。
- claude-sonnet-5 — 大多数推理、检索和编程任务的均衡默认选择:最新一代 Sonnet,在编程和智能体任务方面接近 Opus 水平。Kunavo 对 Claude Sonnet 5 的定价为每 1M token $1.40 / $7.00,Anthropic 的标价为 $2.00 / $10.00。
- claude-sonnet-4-6 — 上一代 Sonnet,适合已针对其调优的提示。Kunavo 对 Claude Sonnet 4.6 的定价为每 1M token $2.10 / $10.50。
- claude-opus-5 — 适用于深度推理和长上下文任务。Kunavo 对 Claude Opus 5 的定价为每 1M token $3.50 / $17.50,Anthropic 的标价为 $5.00 / $25.00。
- claude-fable-5 — Anthropic 能力最强的模型,适用于前沿推理和长周期智能体,于 2026 年 9 月 1 日发布。Kunavo 对该模型的定价为每 1M token $7.00 / $35.00,Anthropic 的标价为 $10.00 / $50.00。上一代版本 claude-fable-5 仍以相同费率提供服务。
API key 安全检查清单
- 切勿在客户端暴露 API key。 所有调用都应通过开发者控制的服务器进行代理。
- 每个项目或环境使用一个 API key,这样密钥泄露时可以撤销该密钥,而不影响其他所有内容。
- 每季度轮换 API key。 Kunavo 允许同时使用多个有效密钥,因此轮换时可以保留一段平稳的重叠期。
常见问题
如何获取 Anthropic Claude API key?
如需获取 Anthropic Claude API key,请登录 Claude Console(platform.claude.com),打开 Settings → API keys,然后点击 Create Key。Anthropic API key 以 sk-ant- 开头,创建时只显示一次,因此必须立即复制并妥善保存。Anthropic 的控制台已从 console.anthropic.com 迁移至 platform.claude.com,密钥页面位于 platform.claude.com/settings/keys。向 https://api.anthropic.com 发送请求时,Anthropic API key 通过 x-api-key 标头和 anthropic-version 标头进行身份验证,而不是通过 Authorization: Bearer 标头。
Anthropic API key 和 Claude API key 是同一种密钥吗?
Anthropic API key 和 Claude API key 是同一种凭证的两种称呼。Anthropic 是公司名称,Claude 是模型系列名称,而在 Claude Console 中创建的密钥(sk-ant-...)用于验证 Claude API 调用。Kunavo API key(sk-kn-...)则是另一家公司提供的不同凭证,可通过一个 OpenAI 兼容端点调用相同的 Claude 模型,以及 GPT 和媒体模型。
Claude API 免费吗?
Claude API 并非长期免费。Anthropic 的定价常见问题说明,新用户会获得少量免费额度用于测试 API;Anthropic 未公布该额度的具体数额,而且除此之外没有免费套餐,因此初始额度用完后,Claude API 按 token 计费。Kunavo 也不会向新账号赠送免费额度:Kunavo 账号至少需充值 $10,余额永不过期,失败的 4xx 和 5xx 调用一律不计费。
为什么我的 Claude API key 无法使用?
Claude API key 返回 401 authentication_error 时,几乎总是以下五种原因之一:端点所需的标头不正确、将密钥发送到了不适用的端点、环境变量中混入了空格或引号、密钥已撤销,或 base URL 错误。Anthropic 的原生 API(api.anthropic.com)要求使用 x-api-key 和 anthropic-version;OpenAI 兼容端点则要求使用 Authorization: Bearer。sk-ant- 密钥只能用于 api.anthropic.com,sk-kn- Kunavo 密钥只能用于 api.kunavo.com。
不使用信用卡可以调用 Claude API 吗?
Anthropic 为标准 Claude API 账户接受主要信用卡,仅向企业客户提供发票,因此直接使用 Anthropic 的实际要求是必须有信用卡。Kunavo 可通过多种渠道充值,无需信用卡:ACH bank debit (US bank accounts, settles in 3–5 business days), Alipay (mainland China), WeChat Pay (mainland China), UPI (India), Pix (Brazil), iDEAL (Netherlands), Bancontact (Belgium), EPS (Austria), MB WAY (Portugal), Satispay (Italy), BLIK (Poland), Bacs Direct Debit (United Kingdom, settles in several business days), Pay by Bank (United Kingdom, Ireland and Finland), Crypto (stablecoins) (US-dollar checkouts)。Kunavo 以美元标价充值金额,Stripe 会在结账页面进行货币兑换,因此巴西买家可以用雷亚尔支付美元标价。两种方式都不提供持续的免费访问 — 调用 Claude 时,两边都需要支付令牌费用。
我可以使用 OpenAI SDK 调用 Claude 吗?
可以通过 Kunavo 的 OpenAI 兼容端点,使用官方 OpenAI SDK 调用 Claude。将 OpenAI SDK 的 base_url 指向 https://api.kunavo.com/v1,传入 Kunavo key 作为 bearer token,并将 model 设为 claude-sonnet-5 等 Claude slug。Anthropic 自己的 api.anthropic.com 不接受 OpenAI 格式的聊天补全请求,因此直接调用 Claude 必须使用 Anthropic SDK 或原生 Messages API。
Anthropic API key 和 Kunavo API key 有什么区别?
Anthropic API key 只能调用 Claude 模型,费用由 Anthropic 收取。Kunavo API key 可通过一个 OpenAI 兼容 API 调用 Claude、GPT、图像、视频和音频模型,费用统一从一个由 Stripe 充值的余额中扣除。Anthropic API key 需要 Anthropic 账号;Kunavo API key 不需要。
应该从哪个 Claude 模型开始使用?
从 claude-sonnet-5 开始,它适合作为大多数推理、检索和编程任务的均衡默认选择。对于低成本、高吞吐量的分类和客服任务,可改用 claude-haiku-4-5。复杂推理可使用 claude-opus-5;只有在需要前沿推理和长周期智能体时,才使用 Anthropic 能力最强的模型 claude-fable-5。
Claude API 的费用是多少?
Anthropic 按 token 对 Claude API 计费,费率因模型级别而异 — Claude Haiku 4.5 最便宜,Claude Fable 5 最贵。Kunavo 提供相同的 Claude 模型,且所有模型的价格都低于 Anthropic 标价:Claude Opus 5 每 1M token 收费 $3.50 / $17.50,Anthropic 则为 $5.00 / $25.00;Claude Haiku 4.5 收费 $0.70 / $3.50,Anthropic 则为 $1.00 / $5.00;Claude Sonnet 5 收费 $1.40 / $7.00,Anthropic 则为最初推出时的 $2.00 / $10.00 费率,该费率于 2026 年 8 月 31 日被 Anthropic 设为永久标准价格。
Kunavo 是 Anthropic 的一部分吗?
Kunavo 是转售这些模型访问权限的独立网关。Kunavo 不是 Anthropic、Google 或 OpenAI,也不训练或托管所提供的模型。
Kunavo 是什么,不是什么
Kunavo 是一个独立且兼容 OpenAI 的 AI API 网关:只需一个 API 密钥和一个按量付费余额,即可调用 Claude、GPT 以及图像、视频和音频模型,无需为每个提供商单独开设账户。
Kunavo 是转售这些模型访问权限的独立网关。Kunavo 不是 Anthropic、Google 或 OpenAI,也不训练或托管所提供的模型。
Anthropic 在 platform.claude.com 发布的官方文档是了解 Anthropic 产品、定价和政策的权威来源。本页转载 Anthropic 已发布的操作流程,并注明每项信息的核实日期,同时列出 Kunavo 提供的替代方案。