常见问题
这里整理使用 NUSI 时经常遇到的问题和处理方式,帮助你快速找到答案。按提示仍无法解决时,可以第一时间点击页面右下角的小助手联系支持。
开始使用
NUSI 是什么?
NUSI 是 AI 模型接入服务。你可以把它配置到 Codex、Claude Code CLI 等现成工具,也可以在自己的应用、脚本或内部系统中调用 API。账户、密钥、用量和费用在 NUSI 中独立管理。
我应该从哪里开始?
先注册并登录控制台,创建一个 API 密钥。然后根据你的场景选择“配置 AI 工具”或“API 开发接入”,按照对应指南填入 API 密钥和当前 Base URL。
“配置 AI 工具”和“API 开发接入”有什么区别?
“配置 AI 工具”是把 NUSI 连接到 Codex、Claude Code CLI 等现成工具,完成配置后,直接在工具里使用 AI。 查看上手指南
“API 开发接入”是通过代码调用模型,把 AI 能力接入你自己的应用、脚本或服务,适合需要开发或自动化的场景。 查看 OpenAI 兼容接口 · 查看 Anthropic 兼容接口
API 密钥和 Base URL 分别做什么?
API 密钥让 NUSI 确认你的账户身份,以及你可以使用哪些模型服务。Base URL 是连接 NUSI 的服务地址,让你使用的 AI 工具或应用找到我们提供的服务。两者一起配置后,工具或应用才能以你的账户身份调用服务。
当前支持哪些模型,应该如何选择?
想了解当前支持哪些模型或 AI 服务,可以查看控制台当前展示的列表和对应服务的官方页面;如果仍有疑问,请联系小助手确认。
调用与模型
不同供应商的模型可以一起用吗?
可以在同一个 NUSI 账户中管理不同模型的调用,但每个应用仍需按照它使用的接口协议和模型配置接入。请根据模型与应用选择 OpenAI 兼容接口或 Anthropic 兼容接口,不要把“一个账户”理解为所有供应商都使用同一套原生配置。
“价格优先”和“稳定优先”有什么区别?
价格优先会在满足基础可用条件的渠道中优先提供更优价格;稳定优先只使用达到更高响应率、响应速度和长尾稳定标准的渠道。两者调整的是服务保障档位,不是模型本身的回答能力。
企业或团队用户并发量、用户量较大,可以定制服务吗?
可以。如果并发量或用户量较大,可以联系小助手沟通定制化服务方案,具体能力和可用性以确认结果为准。
某个渠道故障时会发生什么?
如果某个供应商暂时不稳定,系统会尝试切换到其他可用的服务来源。你可以先等待片刻后重试;如果仍然无法使用,请联系小助手。
今天调用速度很慢怎么办?
响应速度可能受当前网络环境、请求内容长度、服务负载或工具重试影响。先确认本地网络和工具配置正常并重试一次;如果仍然持续缓慢,请联系小助手。
感觉模型降智了怎么回事?
新模型上线或调用并发量较大时,模型供应商的官方服务可能因承载压力出现间歇性波动。这类官方服务波动属于模型供应商侧的问题,不代表 NUSI 降低了模型规格。我们不会主动降低模型规格或替换你选择的模型;调度引擎会持续监测服务表现,在同一模型和价格条件下优先选择表现更好的可用渠道。如果持续感觉回答质量下降,请联系小助手核查具体原因。
价格、充值与退款
充值完成后,余额没有更新怎么办?
先确认支付已完成,再刷新控制台并查看充值记录。若余额仍未更新,请向小助手提供支付时间和订单信息,以便核对。
价格、折扣或实际扣费为什么会变化?
模型价格和折扣可能会受到上游服务价格、采购成本、市场供需和并发负载等因素影响,因此不同时段可能出现变化。请以控制台当前展示的价格和使用记录中的实际扣费为准;如果记录与页面展示不一致,可以联系小助手核对。团队用户还可以在“团队设置”的“限额”中设置使用上限,控制扣费风险。
价格为什么可以低于官方参考价?
不同模型的上游报价、采购成本和市场供需情况不同,因此 NUSI 的价格可能低于官方参考价。这不会改变你选择的模型;可调用模型的最新信息请以控制台展示为准。
价格变化会影响已经开始的请求吗?
请求开始后不会中途改价,该次请求按开始时的价格计费。价格后续如有调整,只适用于新开始的请求,不会追溯修改已产生的费用。
输入、输出和缓存读取 Token 怎么计费?
一次调用可能包含本次新增的输入、模型生成的输出,以及复用缓存的上下文。首次处理一段可复用的长上下文时,上游会在内部建立缓存;后续请求命中相同上下文时记为缓存读取,通常比重新处理这段内容更便宜。缓存读取不是摘要,模型仍会使用完整上下文。首次建立缓存时会产生缓存写入;同一段内容在一次调用中不会同时重复计为普通输入和缓存写入。输入、输出和缓存读取均按实际 Token 用量计费,单价以请求开始时控制台展示为准。
请求失败也会扣费吗?
如果失败前没有产生上游确认的可结算用量,则不形成应收费用;如果上游已经确认产生可结算用量,即使请求最终失败,已发生的部分仍可能按实际用量计费。
工具看起来卡住没有回答,为什么使用记录还在增加?
界面暂时没有显示最终回答,不代表工具已经停止调用。Codex、Claude Code CLI 等工具可能仍在进行推理、读取文件、调用工具、重试或发起后续请求;实际产生的输入、输出和缓存读取 Token 会汇总至消费明细。平台不会按等待时长对单个请求持续计费,使用记录只会在上游返回可结算用量后写入。若不希望继续产生新调用,请先在工具中停止当前任务,再到控制台“使用记录”按时间查看请求、模型和 Token 用量;仍无法判断时,请提供发生时间、所用工具、模型名称和脱敏后的请求记录给小助手排查。
页面显示的折扣与实际扣费不一致怎么办?
先按请求时间核对控制台“使用记录”中的模型、Token 类型、Token 用量和实际扣费。如果记录与页面展示仍不一致,请联系小助手核对。
企业或团队用户支持对公发票和对公转账吗?
可以联系小助手沟通对公发票和对公结算方式,具体流程和所需资料以确认结果为准。
常见失败排查
配置后仍然无法调用怎么办?
先自行确认 API 密钥、Base URL、模型名称和接口协议是否匹配,并重启对应工具。仍然无法调用时,请直接联系小助手。
返回 401、402 或 5xx 服务错误怎么办?
这类错误请第一时间联系小助手,不要反复修改配置;联系时提供报错时间、模型名称和状态码即可。
返回 403 错误怎么办?
403 通常表示当前请求未获得可用额度,可能与账户余额或模型调用权限有关。请先查看控制台余额和可调用模型;仍无法调用时,联系小助手。
返回 429 错误怎么办?
同时在线人数较多或处于使用高峰时,资源暂时吃紧,可能出现 429 错误。偶尔出现通常无需额外操作,调度引擎会自动调度,任务一般会继续运行。如果持续出现 429 错误,或已经影响工作效率,请联系小助手处理。
无法访问服务怎么办?
可能与当前网络环境、工具配置或服务状态有关。先确认本地网络、Base URL 和 API 密钥配置正常,再重试一次;仍无法访问时,请联系小助手。
提示“正在重新连接”或“stream disconnected before completion”怎么办?
如果看到 “stream disconnected before completion: Upstream service temporarily unavailable”,表示当前连接暂时中断,工具正在自动重试。先等待本次重试完成,不要连续重复提交;如果多次重试后仍未恢复,请联系小助手,并提供发生时间、使用的工具和提示内容。
终端提示找不到 node 或 npm
重新安装 Node.js LTS。安装结束后关闭所有 PowerShell 或 Terminal 窗口,再新开一个窗口执行 node -v 和 npm -v。只有 node 可用而 npm 不可用,通常说明安装不完整。
终端提示找不到 codex 或 claude
重新执行对应的 npm 全局安装命令,确认没有报错,然后关闭并重新打开终端,再检查版本号。
点击配置按钮没有反应
先确认 CC Switch 已安装并正在运行;再次点击配置按钮时允许浏览器打开外部应用。如果始终没有弹窗,检查系统是否已将 ccswitch:// 协议关联到 CC Switch。
控制台能登录,但工具无法使用
依次确认 API 密钥完整有效、CC Switch 当前启用的是刚完成的配置、配置目标与实际工具一致。修改后应重启对应工具。
密钥无效或未正确填写
检查 API 密钥是否完整、是否已启用,并确认前后没有空格。若密钥可能泄露或已被删除,请创建新密钥后重新配置。
接口地址、路径或模型不匹配
确认 Base URL 为当前控制台提供的地址,并检查请求路径、CC Switch 配置目标和目标模型是否在当前组织的可调用范围内。
还没有完成第一次调用?返回从 0 到 1 指南
NUSI 上手指南 · 持续更新中 ·