API 文档 一个 Key,两种格式:Anthropic Messages(https://api.apivai.com)和 OpenAI(https://api.apivai.com/v1)。
简短回答 APIVAI 是按量付费的 Claude 和 GPT API 网关,一个 API 密钥支持两种格式:Anthropic Messages 格式用 https://api.apivai.com(Claude Code、Anthropic SDK,接口 /v1/messages);OpenAI 格式用 https://api.apivai.com/v1(接口 /v1/chat/completions、/v1/responses、/v1/models)。密钥放在 Authorization: Bearer 或 x-api-key 请求头中,模型 ID 从 GET /v1/models 中选,长任务请用流式输出。
代理 https://api.apivai.com/v1— 兼容 OpenAI 的 API 端点(Claude + GPT)
ANTHROPIC https://api.apivai.com— Anthropic Messages 格式(Claude Code、Anthropic SDK),不带 /v1
快速开始 Claude API 认证 Chat Completions 模型 流式传输 工具集成 编辑器与 Agent 常见问题 故障排查
2 分钟上手 APIVAI 提供兼容 Anthropic 和 OpenAI 格式的 API 代理。只需设置两个环境变量即可开始。
1. 获取 API 密钥 在 apivai.com 注册并充值,然后在控制台页面创建 API 密钥。
2. 设置 Base URL # Anthropic format (Claude Code, Anthropic SDK): https://api.apivai.com
# OpenAI format (OpenAI SDK, Cursor, Codex CLI): https://api.apivai.com/v1
# For Anthropic SDK / Claude Code:
export ANTHROPIC_BASE_URL="https://api.apivai.com"
export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"
# For OpenAI SDK / Cursor:
export OPENAI_BASE_URL="https://api.apivai.com/v1"
export OPENAI_API_KEY="YOUR_API_KEY"
3. 开始使用 Claude Code (Mac/Linux)
ANTHROPIC_AUTH_TOKEN="YOUR_KEY" \
ANTHROPIC_BASE_URL="https://api.apivai.com" \
claude
Claude Code (Windows PowerShell)
$env:ANTHROPIC_AUTH_TOKEN="YOUR_KEY"
$env:ANTHROPIC_BASE_URL="https://api.apivai.com"
claude
如果终端里已经设置了 ANTHROPIC_API_KEY,请先删除,否则会用它代替 APIVAI 密钥:unset ANTHROPIC_API_KEY(PowerShell:Remove-Item Env:ANTHROPIC_API_KEY)。
支持的模型
claude-fable-5-1 claude-fable-5 claude-fable-5-2 claude-opus-5 claude-opus-4-8 claude-opus-4-7 claude-opus-4-6 claude-opus-5-5 claude-sonnet-4-6 claude-sonnet-5-5 claude-sonnet-5 claude-haiku-4-5 claude-haiku-5-5 gpt-6-astra gpt-6.2-astra gpt-5.6-sol gpt-5.6-terra gpt-6.2-sol gpt-6.1-sol gpt-6-sol gpt-6.1-terra gpt-5.6-luna gpt-6-luna
Claude Messages API(Anthropic 原生格式) 使用标准的 Anthropic Messages API,只需修改 base_url 和 api_key。
BASE URL https://api.apivai.com
Python (Anthropic SDK) import anthropic
client = anthropic.Anthropic(
api_key="YOUR_API_KEY",
base_url="https://api.apivai.com"
)
message = client.messages.create(
model="claude-sonnet-4-6",
max_tokens=1024,
messages=[{"role": "user", "content": "Hello!"}]
)
print(message.content[0].text)
cURL (Messages API) curl https://api.apivai.com/v1/messages \
-H "x-api-key: YOUR_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-4-6",
"max_tokens": 1024,
"messages": [{"role": "user", "content": "Hello!"}]
}'
cURL(流式输出) curl https://api.apivai.com/v1/messages \
-H "x-api-key: YOUR_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-4-6",
"max_tokens": 1024,
"stream": true,
"messages": [{"role": "user", "content": "Hello!"}]
}'
获取模型列表 curl https://api.apivai.com/v1/models \
-H "x-api-key: YOUR_API_KEY" \
-H "anthropic-version: 2023-06-01"
可用的 Claude 模型
claude-fable-5-1最强
claude-opus-5-5强大
claude-sonnet-5-5性价比最高
claude-sonnet-4-6热门
claude-haiku-4-5最快
认证 所有 API 请求需要在 Authorization 头中以 Bearer token 传递 API 密钥(Authorization: Bearer YOUR_API_KEY)。也可以用 x-api-key 请求头传递,Anthropic SDK 和 Claude Code 就是这样发送的。
登录后在控制台获取密钥。
curl https://api.apivai.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-4-6",
"messages": [{"role": "user", "content": "Hello!"}]
}'
使用 OpenAI SDK from openai import OpenAI
client = OpenAI(
api_key="YOUR_API_KEY",
base_url="https://api.apivai.com/v1"
)
response = client.chat.completions.create(
model="claude-sonnet-4-6",
messages=[{"role": "user", "content": "Hello!"}]
)
print(response.choices[0].message.content)
POST /v1/chat/completions 创建聊天补全。兼容 OpenAI chat completions 格式。
请求体 modelstring 必需 模型 ID(例如 claude-sonnet-4-6)
messagesarray 必需 消息对象数组,每项包含 role 和 content
temperaturenumber 采样温度(0-2,Claude 模型为 0-1),默认 1
max_tokensinteger 最多生成的 token 数
streamboolean 开启 SSE 流式输出,默认 false
top_pnumber 核采样(nucleus sampling)参数
{
"model": "claude-sonnet-4-6",
"messages": [
{"role": "system", "content": "You are a helpful assistant."},
{"role": "user", "content": "Explain quantum computing"}
],
"temperature": 0.7,
"max_tokens": 1024
}
可用模型 所有模型(Claude + GPT)都可以通过同一个接口 /v1/chat/completions 调用;Claude 模型也可以用 /v1/messages(Anthropic 格式),GPT 模型也可以用 /v1/responses(Codex CLI 使用)。在请求中填写模型 ID 即可。
全部模型的价格和说明 →
流式传输 (SSE) 设置 stream: true 即可通过 Server-Sent Events(SSE)实时接收生成的 token。
长任务(思考时间长、输出多)请务必用流式:不用流式时,超过 100 秒还没有返回的请求会被网络中途断开;用流式时,即使模型长时间思考,连接也会一直保持。
from openai import OpenAI
client = OpenAI(
api_key="YOUR_API_KEY",
base_url="https://api.apivai.com/v1"
)
stream = client.chat.completions.create(
model="claude-sonnet-4-6",
messages=[{"role": "user", "content": "Hello!"}],
stream=True
)
for chunk in stream:
if chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="")
编辑器与 Agent 以下工具均支持 OpenAI 兼容的 base URL 和 Key。模型请从 GET /v1/models 的结果中选择,并先用小任务验证——Agent 类工具的 token 消耗较大。
Codex CLI # ~/.codex/config.toml (Windows: %USERPROFILE%\.codex\config.toml)
model = "gpt-6.1-sol"
model_provider = "apivai"
[model_providers.apivai]
name = "APIVAI"
base_url = "https://api.apivai.com/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"
# macOS / Linux
OPENAI_API_KEY="YOUR_APIVAI_API_KEY" codex "explain what this repo does in two sentences"
# Windows PowerShell
$env:OPENAI_API_KEY="YOUR_APIVAI_API_KEY"; codex "explain what this repo does in two sentences"
Codex 依赖 Responses 接口(/v1/responses),APIVAI 已支持该接口,工具调用和流式输出均可正常使用。
Cline 设置项 填写内容 API Provider OpenAI Compatible Base URL https://api.apivai.com/v1 API Key 你的 APIVAI API Key Model GET /v1/models 返回的模型 ID
Aider export OPENAI_API_BASE="https://api.apivai.com/v1"
export OPENAI_API_KEY="YOUR_APIVAI_API_KEY"
# the openai/ prefix sends every model, Claude included, through APIVAI
aider --model openai/claude-sonnet-5-5
日常修改用便宜的模型通常就够了,遇到较难的改动再切换到更强的模型。
Continue.dev 编辑 ~/.continue/config.yaml(Windows:%USERPROFILE%\.continue\config.yaml;旧的 config.json 格式已弃用),添加一个模型条目。使用 provider: openai 时,apiBase 以 /v1 结尾,Claude 和 GPT 的模型 ID 都能用。完整步骤见 Continue 配置教程 。
# ~/.continue/config.yaml
name: My Config
version: 0.0.1
schema: v1
models:
- name: Claude Sonnet 5.5 (APIVAI)
provider: openai
model: claude-sonnet-5-5
apiBase: https://api.apivai.com/v1
apiKey: YOUR_APIVAI_API_KEY
roles:
- chat
- edit
- apply
开始前的检查 base URL 中 /v1 有且仅有一个。 所选模型在当前模型列表中。 工具进程确实能读取到 Key(环境变量或设置项)。 不要把 Key 写进项目文件、共享配置或截图里。 更多说明:OpenAI 兼容 API · Claude API 代理
常见问题 在哪里获取 API Key? 注册账号并充值后,在控制台中创建 Key。
如何选择模型? 用你的 Key 调用 GET /v1/models,使用返回结果中的模型 ID。不要照抄旧笔记或截图里的模型名,可用模型会变化。
应该用哪个 base URL? OpenAI 风格的工具和 SDK 用 https://api.apivai.com/v1;Anthropic SDK 和 Claude Code 用 https://api.apivai.com(它们会自动拼接 /v1/messages)。
可以用在 Cursor 或其他编辑器 Agent 上吗? 可以。只要工具支持 OpenAI 兼容接入,就能使用同样的 base URL、Key 和模型选择流程。
可以直接在浏览器前端代码里调用吗? 不要在前端代码里暴露密钥。请通过你自己的后端转发请求,并在后端做好鉴权和限流。
Key 泄露了怎么办? 立即在控制台删除或重置该 Key,把它从日志和代码仓库中清除,并更新所有用到它的环境。
为什么输出 token 比我收到的文字多? 模型在回答前会先思考,思考功能默认开启。思考用掉的 token 计入输出 token,按输出价格计费。如果回复为空或被截断,说明输出上限(max_tokens)被思考用完了,请把它设为 4096 或更高。
为什么示例里的密钥是占位符? 占位符可以避免凭据被提交到代码仓库。请只在本地环境或密钥管理工具中替换 YOUR_APIVAI_API_KEY。示例中的模型 ID(如 claude-sonnet-5-5 和 gpt-6.1-sol)是真实可用的,也可以换成 GET /v1/models 返回的任何 ID。
故障排查 请按顺序排查:本地配置、模型列表、最小对话请求。在接口、Key 和模型全部跑通之前,请保持请求尽量简单。
1. 检查模型列表 curl -i https://api.apivai.com/v1/models \
-H "Authorization: Bearer $APIVAI_API_KEY"
如果这一步失败,请先解决鉴权或 base URL 的问题,再测试其他内容。
2. 发送最小对话请求 curl -i -X POST https://api.apivai.com/v1/chat/completions \
-H "Authorization: Bearer $APIVAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-5-5",
"messages": [{"role": "user", "content": "Return one short sentence."}]
}'
状态码对照 状态码 常见原因 排查方向 401 Key 缺失或无效 确认 Key 已设置,并以 Authorization: Bearer <key> 发送。 402 insufficient_quota 密钥额度已用完,或剩余额度不足以调用该模型(密钥里需要剩:Fable 约 $12,Opus 约 $7,Sonnet 4.6 约 $4) 在控制台给密钥增加额度(余额不够先充值),或改用更便宜的模型。 403 该 Key 所属的账户已被停用 请联系客服(support@apivai.com)。 404 base URL 或路径错误 确认 /v1 只出现一次,路径为 /messages、/chat/completions、/responses 或 /models。 408 网络或客户端超时 在同一终端重试,再换个网络试试。 429 触发密钥频率限制(每分钟次数,或同时请求太多) 降低并发、加入退避重试,或把任务分到几个密钥上。 503 / 529 overloaded_error 模型暂时过载 等几秒后重试,多次重试之间逐渐拉长间隔。 524 非流式请求耗时超过约 100 秒 长回答(max_tokens 较大、长时间推理)请使用 "stream": true,流式不会被中断;非流式请求超时后重试会再次计费。 5xx 服务端错误 稍后重试,并记录时间以便联系客服。
所有错误码的原因和解决方法见 Claude API 错误码 。
为什么返回 404 Not Found? 最终请求地址不对,通常是 /v1 少了、多了或重复了。请求必须到达 https://api.apivai.com/v1/messages、/v1/chat/completions、/v1/responses 或 /v1/models;Claude Code 和 Anthropic SDK 填 https://api.apivai.com,OpenAI 风格的工具填 https://api.apivai.com/v1。
为什么密钥返回 401? 密钥缺失、填错、已删除,或者发请求的进程读取不到它。使用 Claude Code 时,终端里残留的 ANTHROPIC_API_KEY 会优先于 APIVAI 密钥生效,请先删除。
为什么返回 402 或 429? 402 insufficient_quota 表示密钥额度已用完,或剩余额度不足以调用该模型:最贵的几个模型需要密钥里剩得更多(Fable 约 $12,Opus 约 $7,Sonnet 4.6 约 $4),低于这个数会被拒绝。给密钥增加额度,或改用更便宜的模型。密钥在还剩一点额度时就会停用,删除密钥后剩余部分会退回账户余额。429 表示触发了密钥的频率限制:每分钟 60 次,或同时请求太多(同时处理 5 个,多出来的排队;同时超过 20 个会被拒绝)。降低频率并退避重试,或者把并行的任务分到几个密钥上。密钥剩余预算较少时,贵模型能同时运行的请求数也会变少:这时 429 会写明能同时几个,给密钥追加预算就能多跑。
为什么长请求返回 524? 不用流式的请求超过约 100 秒会在中途被断开。长请求请加上 "stream": true,流式输出不会被中断。
为什么流式输出没有内容? 通常是客户端没有按流读取响应,或者跳过了不含文本的数据块。请检查:
请求体中包含 "stream": true。 HTTP 客户端是逐段读取响应体的。 先确认非流式请求可用,以区分是解析问题还是鉴权、模型问题。 部分数据块只包含元信息或结束原因,没有文本。 为什么回复为空或被截断? 思考功能默认开启,思考用掉的 token 也计入输出上限。max_tokens 设得太小时,模型可能把上限全部用在思考上,没有返回正文,但这次请求仍会计费。
结束原因为 "length"(或 stop_reason 为 "max_tokens"),说明达到了上限。 把 max_tokens 设为 4096 或更高;长回答或写代码时设为 8192 或更高。 只按实际用掉的 token 计费,上限设大本身不会多花钱。 为什么 curl 返回 JSON 解析错误? 命令行引号经常导致 JSON 解析错误。可以把请求体写入文件,再用 --data @body.json 发送。
curl -i -X POST https://api.apivai.com/v1/chat/completions \
-H "Authorization: Bearer $APIVAI_API_KEY" \
-H "Content-Type: application/json" \
--data @body.json
联系客服前请准备 HTTP 状态码和接口路径(切勿提供 Key)。 大致的时间和时区。 去除密钥和隐私内容后的请求体与响应体。 运行环境及版本,如 Python 或 Node.js。 工具集成 APIVAI 可作为官方 API 的即插即用替代。只需在您常用的工具中更改 base URL。
Claude Code 运行 Claude Code 前设置两个环境变量。
export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"
export ANTHROPIC_BASE_URL="https://api.apivai.com"
claude
Cursor 打开 Cursor 设置 → Models → Override OpenAI Base URL:
Base URL: https://api.apivai.com/v1
API Key: YOUR_API_KEY
OpenAI Python SDK 使用 OpenAI SDK 加上我们的 Base URL,即可调用包括 Claude 在内的所有模型。
from openai import OpenAI
client = OpenAI(
api_key="YOUR_API_KEY",
base_url="https://api.apivai.com/v1"
)
response = client.chat.completions.create(
model="claude-sonnet-4-6",
messages=[{"role": "user", "content": "Hello!"}]
)
Anthropic Python SDK 使用官方 Anthropic SDK,只需修改 Base URL。
import anthropic
client = anthropic.Anthropic(
api_key="YOUR_API_KEY",
base_url="https://api.apivai.com"
)
message = client.messages.create(
model="claude-sonnet-4-6",
max_tokens=1024,
messages=[{"role": "user", "content": "Hello!"}]
)
cURL 用 curl 直接调用 API。
curl https://api.apivai.com/v1/messages \
-H "x-api-key: YOUR_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-4-6",
"max_tokens": 1024,
"messages": [{"role": "user", "content": "Hello!"}]
}'