常见问题

怎么充值？额度在哪里看？

进入控制台的 钱包 页面，在「添加资金」选择金额并用 Stripe 支付，或用「有兑换码吗？」兑换。额度通常会实时到账。

额度与消费记录可以在两个地方核对：

• 钱包：查看当前剩余额度；
• 使用日志：按时间、模型、密钥查看每次调用的额度消耗。

如果充值后额度没有到账，请联系支持并提供注册邮箱、支付时间、支付渠道和订单截图。

API Key 怎么创建？填在哪里？

在控制台进入 API 密钥 页面，点击 创建 API 密钥。创建后在列表中点击 查看 即可复制 sk- 开头的完整密钥，请妥善保存；若丢失可删除后重新创建。

使用时把令牌填在客户端的 API Key 位置，或在代码中使用：

Authorization: Bearer sk-xxxxxxxxxxxxxxxx

不要把 API Key 放进前端代码、公开仓库、截图或聊天记录里。如果怀疑泄露，请立即删除旧令牌并创建新令牌。

Base URL 怎么填？要不要带 /v1？

jmds.dev 使用 OpenAI 兼容接口。标准 Base URL 是：

https://api.jmds.dev/v1

不同客户端处理方式略有差异：

• SDK 或代码调用：通常填完整的 https://api.jmds.dev/v1；
• Cherry Studio：通常填 https://api.jmds.dev，客户端会自动拼接路径；
• NextChat / 其他 Web 客户端：如果连接失败，尝试在地址末尾加上或去掉 /v1。

提示 401 / 未授权？

通常是令牌错误或已过期。请确认：

• Authorization 头格式为 Bearer sk-xxxx；
• API Key 是从 jmds.dev 控制台创建的完整 sk- 密钥；
• 令牌未被删除或过期；
• 没有多余的空格、换行或引号；
• 客户端没有把 Bearer 重复加了两次。

如果仍然失败，请提供注册邮箱、报错截图、模型名称、Base URL 和大概发生时间。

提示 403 / 无权访问？

403 通常表示当前令牌或分组没有访问该模型的权限。请确认：

• 模型名称拼写正确；
• 当前令牌没有限制可用模型；
• 当前账号/分组允许访问该模型；
• 客户端没有使用旧配置或旧令牌。

提示额度不足（insufficient quota）？

账户或令牌额度已耗尽。前往 充值与额度 充值，或检查令牌是否设置了过低的额度上限。

如果账号仍有余额，但只有某个应用报额度不足，优先检查该应用使用的 API Key 是否设置了单独额度上限。

提示模型不存在 / 无权访问？

• 确认模型名称拼写正确；
• 确认当前令牌 / 分组允许访问该模型。

支持哪些模型？

可在控制台的模型列表中查看当前可用模型及其价格。

如果客户端里没有自动拉取模型列表，可以手动填写控制台中显示的模型名称。价格和可用性以控制台为准。

Cherry Studio 怎么配置？

1. 打开 Cherry Studio 设置 → 模型服务；
2. 选择 OpenAI 或添加自定义 OpenAI 兼容服务；
3. API 地址填 https://api.jmds.dev，如果连接失败再试 https://api.jmds.dev/v1；
4. API Key 填 sk- 开头的令牌；
5. 添加或选择模型名称后保存。

NextChat 怎么配置？

在设置中选择 OpenAI 或自定义 OpenAI 兼容服务：

• API Key：填 sk- 开头的令牌；
• Base URL：先填 https://api.jmds.dev/v1；
• Model：填控制台模型列表里的模型名称。

如果请求路径异常或连接失败，尝试把 Base URL 改为 https://api.jmds.dev。

如何查看我的消费？

在 使用日志 页面可按时间、模型、密钥查看每次调用的额度消耗。

还有问题？

如果以上未能解决，请联系支持，并尽量一次性提供：

• 注册邮箱或账号；
• 完整报错码、报错文本或截图；
• 使用的模型名称；
• 客户端或代码里配置的 Base URL；
• 大概发生时间；
• 刚才执行的操作。

这些信息能帮助机器人和人工支持更快定位问题，避免反复追问。