跳到正文
小月神 API
返回首页

HELP & ANSWERS

API 常见问题

遇到接入或用量问题时,可以从下面这些检查项开始。具体权限和费用以你当前账号的配置为准。

API Key 在哪里创建?

登录本站控制台后,在 API 密钥页面创建。创建后确认密钥所属分组、有效期和限制;应用应使用这个 API Key,而不是后台登录密码。

打开 API 密钥管理

Base URL 要不要带 /v1?

取决于客户端如何拼接请求地址,以及本站提供的 API 前缀。若客户端要求 API 基础地址,通常填写控制台提供的完整 Base URL;若客户端自动追加 /v1,则不要重复填写。

排查时查看最终请求 URL,确认没有 /v1/v1、重复端点或丢失的代理路径。不要把其他网站的示例域名当作本站地址。

查看地址配置示例

为什么某个模型不可用?

模型可见性与调用权限取决于密钥所属分组、账号状态、站点配置和渠道可用性。请从当前账号的可用模型清单中复制准确模型标识。

首页的品牌展示是平台界面的一部分,不保证每个账号、每个分组或任意时间都能调用全部模型。

收到 401 应该检查什么?

检查 API Key 是否复制完整、是否过期或已撤销,并核对请求发送到了正确站点。对于要求 Bearer 鉴权的接口,请发送 Authorization: Bearer <API_KEY>,避免额外空格、换行或重复 Bearer。

其他接口格式可能使用不同鉴权头,应以对应接入说明为准。不要通过公开消息发送密钥来排查。

收到 403 与 401 有什么区别?

403 通常表示调用被权限或策略拒绝。除核对密钥外,还应检查模型是否属于允许的分组、密钥是否有限制、账号是否可用,以及站点是否设置其他访问策略。

HTTP 状态码只是排查入口;请结合响应中的具体错误说明定位原因。

收到 429 可以一直重试吗?

请先检查错误说明和控制台限制。429 可能涉及请求频率、并发、配额或上游限制,持续密集重试往往会延长恢复时间。

降低并发,按 Retry-After(如有)等待,或使用带随机抖动的退避策略。如果是额度或账号限制,先解决对应限制,再重试。

费用按照哪个标准计算?

以本站当前分组的价格、倍率、计费配置和用量记录为准。第三方供应商的官网价格不一定等于本站实际扣费。

核对费用时应使用同一条请求的模型、输入输出用量、缓存相关用量和计费记录;有疑问时向管理员提供请求标识和时间。

打开用量记录

缓存读取、缓存写入一定会显示吗?

不一定。是否显示以及如何计费,取决于上游返回的用量、模型支持和本站分组配置。本站日志中的计费字段也不一定等同于上游实际创建缓存的结果。

下游平台是否展示或收取缓存费用,由它对响应字段的支持和自身计费配置决定。不能仅凭本站显示了某个字段就推定下游一定按相同规则扣费。

反馈问题时需要提供什么?

提供请求时间、使用的模型标识、HTTP 状态码、错误信息和请求标识(如有),并说明客户端名称、版本和配置的地址格式。

请隐藏完整 API Key、密码、用户个人信息及敏感请求内容。接入指南列出了从地址到用量的完整检查顺序。

返回接入指南