常见问题

账号与密钥

Q：Key 创建后找不到了？
A：去 /console/keys — 所有 Token 都在这里列出，可以直接复制。如果需要换 Key，在同一页面创建新的、删掉旧的即可。

Q：Claude Code 和 Codex 要分别创建不同的 API Key 吗？
A：不用。一个 APIMaster Key 两个工具都能用。Claude Code 用 ANTHROPIC_AUTH_TOKEN（旧版用 ANTHROPIC_API_KEY）；Codex 把 Key 写在 ~/.codex/auth.json 的 OPENAI_API_KEY 字段。Key 格式相同，只是配置文件和变量名不一样。

Q：控制台面板白屏或登录后没有内容？
A：退出登录，重新登录 /login。主站重启后 session 会失效，重新登录是唯一修复方式。

价格

Q：通过 APIMaster 用 Claude API 实际要多少钱？
A：APIMaster 渠道比 Anthropic 官方定价低约 85%。Anthropic 官方价格：Haiku 4.5 $1/$5、Sonnet 4.6 $3/$15、Opus 4.8 $5/$25（输入/输出，每百万 token）。APIMaster 上 Sonnet 4.6 的实际价格约 $0.45/$2.25。各渠道价格实时变动，以模型广场为准。

Q：支持哪些支付方式？
A：支持 epay、PayPal、信用卡、USDT。最低充值 $1，没有月费或订阅费，用多少扣多少。

Q：大批量任务用哪个模型最便宜？
A：Claude Haiku 4.5（APIMaster 约 $0.15/$0.75）和 DeepSeek V4 Flash（约 $0.10/$0.20）是性价比最高的选项。简单分类、摘要、问答用 Haiku 够用；需要多步推理用 Sonnet 4.6。详见低价 LLM API 指南。

Q：有免费额度吗？
A：没有。最低充值 $1，余额无过期时间，不收月费，按 token 计费。

配置 — Claude Code

Q：怎么把 Claude Code 连到 APIMaster？
A：编辑 ~/.claude/settings.json（没有就新建）：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://apimaster.ai",
    "ANTHROPIC_AUTH_TOKEN": "你的 APIMaster Key"
  }
}

https://apimaster.ai 是站点根地址，不要加 /v1。如果你用的是旧版 Claude Code，把 ANTHROPIC_AUTH_TOKEN 换成 ANTHROPIC_API_KEY。配置好后运行 claude，用 /model claude-sonnet-4-6 切换模型。完整教程：Claude Code 配置。

Q：Claude Code 一直弹窗要我登录 Anthropic，怎么解决？
A：ANTHROPIC_BASE_URL 没有生效或填错了。必须是 https://apimaster.ai，不是 https://apimaster.ai/v1，也不是 https://apimaster.ai/v1。打开 ~/.claude/settings.json 检查这个值，同时确认文件路径对：Windows 在 %userprofile%\.claude，macOS/Linux 在 ~/.claude。

配置 — Codex

Q：怎么把 Codex 连到 APIMaster？
A：在 ~/.codex/ 下创建两个文件：

config.toml：

model_provider = "apimaster"
model = "gpt-5.4"

[model_providers.apimaster]
name = "apimaster"
base_url = "https://apimaster.ai/v1"
wire_api = "responses"
requires_openai_auth = true

auth.json：

{ "OPENAI_API_KEY": "你的 APIMaster Key" }

然后运行 codex。完整教程：Codex 配置。

配置 — 其他工具

Q：Dify / Open WebUI / LiteLLM 怎么接入？
A：三个工具都支持 OpenAI 兼容接口，把 base URL 设置为 https://apimaster.ai/v1，填入 APIMaster Key 即可。Dify：设置 → 模型供应商 → 添加自定义 OpenAI 兼容供应商。Open WebUI：设置 → 连接 → 添加 OpenAI API 连接。LiteLLM：在 model list 里设置 api_base=https://apimaster.ai/v1。对应教程：Dify、Open WebUI、LiteLLM。

Q：Cursor 怎么接入？
A：Cursor → 设置 → 模型 → 添加自定义 OpenAI 兼容供应商，base URL 填 https://apimaster.ai/v1，粘贴 Key，选择支持的模型里的模型 id。详见 Cursor 指南。

报错排查

Q：提示 model not found，怎么办？
A：模型 id 拼写错误或该 id 对你的账号不可用。去支持的模型复制准确的 id，不要手动输入，同时确认账号有余额。

Q：base_url 要不要带 /v1？
A：要带：所有 OpenAI 兼容工具（Codex、Cline、Cursor、Open WebUI、Dify、LiteLLM）用 https://apimaster.ai/v1。不要带：只有 Claude Code 用 https://apimaster.ai。这是最常见的配置错误。

Q：Key 是对的，还是 401 Unauthorized，为什么？
A：通常是 Key 里混入了不可见字符。先粘贴到纯文本编辑器，重新复制一遍，再写入配置文件。另外确认控制台余额大于零。

Q：/v1/messages 和 /v1/chat/completions 有什么区别，我该用哪个？
A：/v1/messages 是 Anthropic 协议，Claude Code 和 anthropic Python SDK 用这个。/v1/chat/completions 是 OpenAI 兼容协议，其他所有工具用这个。APIMaster 两种都支持。如果出现 route not found，通常是客户端协议和 base URL 不匹配。

模型验证

Q：怎么确认某个渠道真的在用它声称的模型？
A：用API Key 测试工具 — 填入任意接口地址和 Key，它会跑指纹探针，输出最可能的模型类别和 TrustScore。也可以在模型广场看各渠道的历史检测记录，多次通过周度检测的渠道更可靠。

Q：TrustScore 是什么意思？
A：指这个渠道返回的内容与声称模型的行为模式匹配的概率估计值。90% 以上说明输出模式高度一致；低于 70% 建议换渠道或多次测试。这是风险信号，不是法律凭证。

Q：供应商可以伪造模型名称吗？
A：可以。任何供应商都能给路由贴任意模型标签。这就是为什么 APIMaster 做行为指纹检测而不只看 API 返回的 model 字段。上生产流量前，先用测试工具跑几次。

安全

Q：用测试工具时，你们会保存我的 API Key 吗？
A：不会。指纹测试只用你的 Key 发测试请求，不持久化存储。提交测试时请使用权限受限的 Key，不要用有账单管理权限的主 Key。

Q：低价 API 供应商有哪些潜在风险？
A：三类常见问题：①实际路由到比声称更弱的模型，输出质量悄悄下降；②用量统计不准，导致预算失控；③限流阈值低，压测才会暴露。在模型广场看渠道的检测历史，是上线前最快的排查方式。

对比

Q：APIMaster 和 OpenRouter 有什么区别，该选哪个？
A：OpenRouter 的模型覆盖面更广（200+ 对 APIMaster 的 50+ 主流模型）。APIMaster 的核心差异是指纹验证——对每个上架渠道做周度行为检测——以及 USDT 和 epay 支付，OpenRouter 不支持这两种。如果你需要大量小众模型，OpenRouter 更全；如果你需要模型真实性保证和灵活支付方式，APIMaster 更合适。

Q：APIMaster 和 Anthropic 官方 API 的区别是什么？
A：官方 API 有厂商背书的模型真实性、直接技术支持、最新功能优先访问权，但需要 Anthropic 账号，价格是全额官方定价。APIMaster 便宜约 85%，不需要 Anthropic 账号，支付方式更灵活，但多一跳中转延迟，且靠指纹检测而非官方保证来验真。合规敏感的生产环境用官方 API；成本敏感的开发和批处理场景用 APIMaster。

账单

Q：最终实际扣费以哪里为准？
A：模型广场价格是参考展示，实际扣费以控制台用量日志和订单记录为准。如果广场显示价格和账单不符，账单是准确的。

---

还有问题？去联系我们，附上报错截图、使用的工具名称和你填写的 base_url 值。