帮助
常见问题
使用 NoviaHub 时最常遇到的问题：账户与登录、API Key、地址填写、模型、余额与费用、流式与推理。
登录框里的「注册」是灰色的，点不了？
Section titled “登录框里的「注册」是灰色的，点不了？”鼠标移上去如果提示「注册已关闭」，说明网站当前没有开放新用户注册。已有账户可以正常登录。关于账户的问题，可以发邮件到 support@noviahub.com。
忘记密码，或者不想输密码？
Section titled “忘记密码，或者不想输密码？”登录框里有「忘记密码？」，可以通过邮箱验证码重设密码；也可以点「验证码登录」，用邮箱收到的验证码直接登录。验证码登录只适用于已经注册过的账户。详见登录与账户。
API Key
Section titled “API Key”API Key 泄露了怎么办？
Section titled “API Key 泄露了怎么办？”马上到「API 密钥」页面删除这把 Key，再新建一把，并把用到它的地方换成新 Key。删除后，旧 Key 会立即失效。之后可以在使用日志里按「令牌名称」筛选，检查泄露期间有没有异常调用。
一把 Key 能同时给多个工具用吗？
Section titled “一把 Key 能同时给多个工具用吗？”能，但建议一个工具一把 Key。这样某一把出问题时只需停用它；在使用日志里也能按 Key 分开看各个工具花了多少。
调用返回 401 Invalid token？
Section titled “调用返回 401 Invalid token？”说明 NoviaHub 没认出这把 Key，常见原因有：
- Key 复制得不完整，或多了空格、换行；
- Key 已被禁用、已过期或已耗尽（到「API 密钥」页面看它的状态）；
- 放 Key 的请求头用错了，例如在
/v1/chat/completions上用了x-api-key。
详见错误码与排查。
base URL 到底填什么？
Section titled “base URL 到底填什么？”| 协议 | base URL |
|---|---|
| OpenAI（Chat Completions、Responses、Images） | https://noviahub.com/v1 |
| Anthropic（Claude Code 等） | https://noviahub.com |
| Gemini | https://noviahub.com |
填错的典型表现：
- OpenAI 的地址漏了
/v1：会收到一个网页（HTML），程序报「无法解析 JSON」； - Anthropic、Gemini 的地址多了
/v1：返回 404Invalid URL。
详见接口地址与协议选择。
模型名要写成 openai/gpt-... 这种带厂商前缀的形式吗？
Section titled “模型名要写成 openai/gpt-... 这种带厂商前缀的形式吗？”不需要。直接用 模型&价格 上显示的模型 ID，例如 deepseek-v4-flash、claude-sonnet-5。模型详情页的模型 ID 旁边有复制按钮。
返回 503 No available channel for model ...？
Section titled “返回 503 No available channel for model ...？”最常见的原因是模型名写错了（大小写、连字符、多了空格）。请从模型详情页复制模型 ID。如果确认模型名没错，说明这个模型暂时没有可用的线路，请稍后再试或联系客服。
在工具里拉取模型列表时，少了一些模型？
Section titled “在工具里拉取模型列表时，少了一些模型？”/v1/models 只返回这把 Key 能用的模型。如果 Key 设置了「模型限制」，列表里就只有被允许的那几个。可以编辑 Key，调整或清空「模型限制」。
怎么让模型多想一会儿，或者别思考？
Section titled “怎么让模型多想一会儿，或者别思考？”在模型名后加修饰符，例如 deepseek-v4-flash@effort:high、claude-sonnet-5@thinking:off；也可以用各协议原生的推理参数。详见推理与思考。
在哪里看余额、怎么充值？
Section titled “在哪里看余额、怎么充值？”在控制台的「钱包」页面。余额以美元（$）显示；可以在线充值（Stripe、支付宝、微信支付、Heleket 加密货币），也可以使用兑换码。详见钱包与充值。
每次调用花了多少钱，在哪里看？
Section titled “每次调用花了多少钱，在哪里看？”在控制台的「使用日志」页面，每一行是一次调用，「费用」一列就是花费。点「详情」可以看到单价、Token 数量和计算结果。详见计费说明。
余额明明还有钱，却提示「预扣费额度失败」？
Section titled “余额明明还有钱，却提示「预扣费额度失败」？”NoviaHub 在请求开始前会先按估算值预扣一笔钱。余额少于这笔预扣时，请求会被拒绝，返回 403，提示「预扣费额度失败, 用户剩余额度: …, 需要预扣费额度: …」。充值后即可恢复。如果提示的是「用户额度不足」，说明余额已经用完。详见计费说明。
请求失败了会扣钱吗？
Section titled “请求失败了会扣钱吗？”不会。整个请求失败时，预扣的钱会全部退回。
流式输出最后多了一段 choices 是空的数据，程序报错？
Section titled “流式输出最后多了一段 choices 是空的数据，程序报错？”这是 NoviaHub 默认附带的用量数据。你可以在代码里先判断 choices 是否为空，或者在请求里加上 "stream_options": {"include_usage": false} 关掉它。详见流式输出。
支持 Claude Code、Codex、Cursor 这些工具吗？
Section titled “支持 Claude Code、Codex、Cursor 这些工具吗？”支持。各工具的配置步骤见集成。
- 邮箱：support@noviahub.com
- Discord：discord.gg/zQ3HRH9sz6
报告问题时，请附上错误信息里的 request id、发生时间和调用的模型。不要发送你的 API Key。