Skip to content

常见问题 FAQ ​

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

什么是 API 中转? ​

API 中转是在用户和模型厂商之间转发 API 请求的服务。你使用中转方提供的接口地址和密钥,按 OpenAI 或 Anthropic 的官方格式发送请求,中转方把请求转发给上游模型并返回结果。NiceAI 就是这样一个中转平台,一个密钥可以调用 Claude、GPT、Gemini 等模型。 如何挑选见 如何选择靠谱的 API 中转。

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 国内怎么用。

用 API 中转会不会封自己的 Claude 账号? ​

不会牵连。使用中转时客户端用的是中转方的密钥,不登录你自己的 Claude 账号。请求内容会经过中转服务器,请不要发送密码、密钥等敏感信息。更多见 用 API 中转安全吗。

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。 详见 支持的客户端一览。

怎么计费?倍率是什么意思? ​

NiceAI 按实际用量计费,没有月费。每次请求的费用按模型官方价格计算,再乘以密钥所在分组的倍率,即实际扣费 = 官方价格计算的费用 × 倍率。支持提示词缓存的模型,命中缓存的部分按更低单价计费。各分组的实时倍率以控制台显示为准。 详见 分组与倍率说明。

分组是什么?应该选哪个? ​

分组决定密钥能调用哪些模型和协议。一般来说,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。 更多错误码见 常见错误码对照。

请求返回 404 怎么办? ​

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

请求返回 429 怎么办? ​

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

为什么短问题也消耗几千输入 token? ​

Claude Code、Codex 这类编程工具每次请求都会自动附带系统提示、工具定义和项目上下文,所以即使只问一句,输入 token 也可能有几千。这是客户端的正常行为,命中提示词缓存后这部分费用会明显降低。 详见 为什么 Claude Code 一句话也要几千输入 token。

我的请求数据安全吗? ​

作为中转服务,请求需要经过 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 接口总览,以及 流式输出、工具调用、图片输入、限流与重试 等专题。

API 密钥泄露了怎么办? ​

立即在控制台 API 密钥 页面删除或禁用该密钥,再创建新密钥替换到各个工具里,并查看使用记录确认是否有异常调用。平时的防护方法见 API 密钥安全最佳实践。

下一步 ​

NiceAI · 稳定的 AI 大模型 API 中转站