开发者常见问题：API Key、Base URL 与计费

这里是最常被问到的问题，每条都链接到详细说明。

#Base URL 应该填什么？

OpenAI 类客户端和 SDK：https://bigmodel.io/v1。Anthropic 类客户端（Claude Code、Anthropic SDK）：https://bigmodel.io，不带 /v1，因为客户端会自己加 /v1/messages。重复 /v1 会导致 404。见 快速开始。

#API Key 找不到了，需要新建吗？

不需要。打开 API Keys 点复制按钮，随时可以复制完整 Key。如果怀疑 Key 泄露，先停用再新建。见 认证与 API Key。

#为什么模型返回 503“No available accounts”？

这是 BigModel.io 对 Key 无法使用的模型的返回：要么 ID 拼错，要么 Key 所在分组不提供该模型。从 模型目录 复制 ID（小写、保留点号），并用 GET /v1/models 核对。见 错误码。

#分组是什么？为什么调用 /v1/messages 返回 404？

每个 Key 属于一个分组，分组决定模型、端点和倍率。GLM、DeepSeek 分组只提供 /v1/chat/completions，所以 Claude Code（Messages）和 Codex CLI（Responses）需要使用提供这些端点的分组的 Key。

#能在 Claude Code 里用 GLM、Kimi 或 DeepSeek 吗？

可以。设置 ANTHROPIC_BASE_URL=https://bigmodel.io、把 ANTHROPIC_AUTH_TOKEN 设为你的 Key、ANTHROPIC_MODEL 设为模型 ID，并使用提供 /v1/messages 的分组的 Key。见 Claude Code。

#余额为 0 时为什么返回 403？

付费模型以及 GET /v1/models 等接口要求余额大于 0，余额为 0 时返回 403。标价 $0 的模型在 chat、messages、responses 接口上仍可调用，余额为 0 期间有每分钟次数限制。任意金额 充值 即可使用付费模型。见 试用额度与免费模型。

#如何计费？

按 Token 以美元计费：输入、输出、缓存读取和缓存写入 Token 按模型价格计算，再乘以分组倍率。失败的请求不扣费。每笔扣费都在 用量 中。见 计费与充值。

#可以用什么方式付款？

在 充值 页面付款，可用方式以结账页为准，例如支付宝和 USDT（TRC20、ERC20、BEP20）。余额始终以美元计。

#可以退款吗？

未使用的套餐可在购买后 24 小时内退款。USDT 支付不可退款，赠送额度没有现金价值。见 退款政策。

#能限制单个 Key 的消费吗？

可以。每个 Key 都能设置美元额度和 5 小时、1 天、7 天消费窗口，还有有效期和 IP 规则。窗口是固定窗口，不是滚动窗口。见 限额与速率。

#一直收到 429，怎么办？

先看错误码。API_KEY_QUOTA_EXHAUSTED、USAGE_LIMIT_EXCEEDED 和窗口类信息（“限额已用完”）重试也不会恢复。“Too many pending requests”和“Concurrency limit exceeded”说明并行请求太多；RPM 限制会返回 Retry-After。见 限额与速率。

#OpenRouter 的代码能直接用吗？

大多可以，改 Base URL 和 Key 即可。支持 provider/model 形式的 ID、models 备选数组以及 HTTP-Referer / X-Title；provider 对象、transforms 和 route 会被忽略。见 从 OpenRouter 迁移。

#提示内容会被保存或用于训练吗？

成功请求的提示和输出透传给模型供应商，交付后不保留。失败请求的请求体在去除凭据后最多保留 30 天，用于排查问题。提示内容不会用于训练。供应商可能按其自身条款保留数据。见 隐私政策。

#怎么知道某个模型是否正常？

状态页 按模型展示 24 小时、7 天和 30 天的可用性、延迟和首 Token 时间。

#怎么联系支持？

在控制台 支持 提交，或发邮件到 support@bigmodel.io，一个工作日内回复。请附上 X-Request-ID、时间、模型、端点和错误响应体；见 错误码。

#常见问题排查

这里没有我的问题。 先搜索文档，再联系 支持。

这里的回答和我看到的不一致。 以错误信息和控制台为准，并告诉我们，我们会修正页面。

#相关文档

• 概览
• API 快速开始
• 错误码