Source: https://wiki.niceai.dev/guide/faq

# 常见问题 FAQ

这里汇总了使用 NiceAI 时最常被问到的问题，每个问题都用一段话直接回答。更详细的说明请点击文中链接。

## 什么是 API 中转？

API 中转是在用户和模型厂商之间转发 API 请求的服务。你使用中转方提供的接口地址和密钥，按 OpenAI 或 Anthropic 的官方格式发送请求，中转方把请求转发给上游模型并返回结果。NiceAI 就是这样一个中转平台，一个密钥可以调用 Claude、GPT、Gemini 等模型。 如何挑选见 [如何选择靠谱的 API 中转](https://wiki.niceai.dev/guide/tech/choose-api-relay)。

## Claude Code 国内能用吗？

能用。Claude Code 通过 `ANTHROPIC_BASE_URL` 和 `ANTHROPIC_AUTH_TOKEN` 两个环境变量决定请求发到哪里。把 `ANTHROPIC_BASE_URL` 设为 `https://api.niceai.dev`（不加 `/v1`）、`ANTHROPIC_AUTH_TOKEN` 设为 NiceAI 密钥，写进 `~/.claude/settings.json` 即可。几种接法的对比见 [Claude Code 国内怎么用](https://wiki.niceai.dev/guide/tech/claude-code-china)。

## 用 API 中转会不会封自己的 Claude 账号？

不会牵连。使用中转时客户端用的是中转方的密钥，不登录你自己的 Claude 账号。请求内容会经过中转服务器，请不要发送密码、密钥等敏感信息。更多见 [用 API 中转安全吗](https://wiki.niceai.dev/guide/tech/relay-safety-faq)。

## NiceAI 兼容 OpenAI 接口吗？

兼容。NiceAI 提供 OpenAI 兼容接口（Chat Completions 和 Responses，地址 https://api.niceai.dev/v1）、Anthropic Messages 接口（地址 https://api.niceai.dev，不加 /v1）和 Gemini 接口（地址 https://api.niceai.dev/v1beta）。原本支持这些协议的 SDK 和客户端，只需改 Base URL 和 API 密钥即可使用。

## 支持哪些客户端？

凡是允许自定义 Base URL 的 OpenAI、Anthropic 或 Gemini 客户端都可以使用，包括 Claude Code、Codex CLI、Gemini CLI、Cursor、VS Code Copilot、Cline、Roo Code、Kilo Code、Continue、Zed、Aider、OpenCode、Cherry Studio、ChatBox、LobeChat、NextChat、Open WebUI、Dify、n8n、沉浸式翻译、Obsidian Copilot，以及 OpenAI 和 Anthropic 官方 SDK。控制台还支持一键导入 CC Switch 和 Magpie。 详见 [支持的客户端一览](https://wiki.niceai.dev/guide/clients/)。

## 怎么计费？倍率是什么意思？

NiceAI 按实际用量计费，没有月费。每次请求的费用按模型官方价格计算，再乘以密钥所在分组的倍率，即实际扣费 = 官方价格计算的费用 × 倍率。支持提示词缓存的模型，命中缓存的部分按更低单价计费。各分组的实时倍率以控制台显示为准。 详见 [分组与倍率说明](https://wiki.niceai.dev/guide/billing-groups)。

## 分组是什么？应该选哪个？

分组决定密钥能调用哪些模型和协议。一般来说，Claude Code 和 Anthropic SDK 用 Claude 分组，Codex 和 OpenAI SDK 用 OpenAI 分组，Gemini CLI 用 Gemini 分组。不同分组的线路和倍率可能不同，以控制台的分组说明为准。

## 支持哪些付款方式？

支持支付宝、微信和 USDT。充值 ¥1 到账 1 额度，按实际用量扣除。

## 可以退款吗？

充值后 7 天内，未消耗的余额可以申请退款，已消耗的部分不退。具体流程以控制台说明为准。

## 请求返回 401 怎么办？

401 表示认证失败。检查密钥是否复制完整、是否带了多余空格、是否已被禁用或删除，以及请求头格式：OpenAI 兼容协议用 Authorization: Bearer 密钥，Anthropic 协议用 x-api-key。 更多错误码见 [常见错误码对照](https://wiki.niceai.dev/guide/error-codes)。

## 请求返回 404 怎么办？

404 大多是 Base URL 的 /v1 写错了。OpenAI 兼容客户端要带 /v1，Anthropic 协议和 Claude Code 不带 /v1，会自动补全路径的客户端（如 Cherry Studio、CC Switch 中的 Codex）不要手动加。另一种可能是模型名写错，请以模型广场为准。 详见 [接口地址要不要加 /v1](https://wiki.niceai.dev/guide/v1-404)。

## 请求返回 429 怎么办？

429 表示请求过于频繁或上游暂时限流。降低并发，并用指数退避重试（例如间隔 1 秒、2 秒、4 秒）；响应头有 retry-after 时按它等待。

## 为什么短问题也消耗几千输入 token？

Claude Code、Codex 这类编程工具每次请求都会自动附带系统提示、工具定义和项目上下文，所以即使只问一句，输入 token 也可能有几千。这是客户端的正常行为，命中提示词缓存后这部分费用会明显降低。 详见 [为什么 Claude Code 一句话也要几千输入 token](https://wiki.niceai.dev/guide/tech/claude-code-input-tokens)。

## 我的请求数据安全吗？

作为中转服务，请求需要经过 NiceAI 再转发给上游模型提供方。建议不要在请求中发送密码、密钥、身份证号等敏感信息，并妥善保管自己的 API 密钥。关于数据处理和日志的具体政策，以 NiceAI 官网公布的条款为准。

## 可用模型和价格在哪里看？

可用模型列表在 NiceAI 模型广场（https://niceai.dev/model-plaza）查看，各分组的实时倍率在控制台查看。也可以调用 GET https://api.niceai.dev/v1/models 查询当前密钥可用的模型。

## 有 API 接口文档吗？怎么在代码里调用？

有。NiceAI 的请求格式与 OpenAI、Anthropic、Gemini 官方接口一致，用官方 SDK 并把 Base URL 换成 NiceAI 地址即可。见 [API 接口总览](https://wiki.niceai.dev/guide/api/)，以及 [流式输出](https://wiki.niceai.dev/guide/api/streaming)、[工具调用](https://wiki.niceai.dev/guide/api/tools)、[图片输入](https://wiki.niceai.dev/guide/api/vision)、[限流与重试](https://wiki.niceai.dev/guide/api/rate-limits) 等专题。

## API 密钥泄露了怎么办？

立即在控制台 [API 密钥](https://niceai.dev/keys) 页面删除或禁用该密钥，再创建新密钥替换到各个工具里，并查看使用记录确认是否有异常调用。平时的防护方法见 [API 密钥安全最佳实践](https://wiki.niceai.dev/guide/key-security)。

## 下一步

- [快速开始](https://wiki.niceai.dev/guide/quick-start)
- [术语表](https://wiki.niceai.dev/guide/glossary)
