跳转到主要内容
本文档说明问题排查方法与技术支持渠道。

​
自助排查

在寻求人工支持前，建议先按以下步骤自助排查，多数问题可自行解决。
  1. 查看用量日志。调用失败或扣费异常时，用量日志 记录了每次调用的结果与失败原因，是最直接的排查依据。
  2. 查阅常见问题。常见问题 汇总了大部分高频问题及处理方法。
  3. 核对基础配置：
    • Base URL 是否正确（https://moxus.ai 或 https://moxus.ai/v1）。
    • 密钥是否正确、是否包含 Bearer 前缀、是否被禁用或过期。
    • 模型名称是否与模型广场完全一致。
    • 账户余额是否充足。

​
排查清单

调用出错时，可按下表逐项确认。
检查项确认方式
密钥有效在 API 密钥页面确认密钥状态为启用且未过期
余额充足在钱包页面查看余额，在密钥页面查看该密钥额度上限是否用尽
模型可用在模型广场确认模型存在且所属分组有权限
地址正确确认 Base URL 拼写与 /v1 后缀
网络正常确认可正常访问平台首页
参数合法确认请求体为合法 JSON，且必填字段（model、messages）完整

​
错误信息说明

API 返回的错误通常采用以下结构： 
{
  "error": {
    "message": "错误的具体描述",
    "type": "错误类型",
    "code": "错误码"
  }
}
其中 message 字段通常直接说明问题原因（如余额不足、模型不存在、密钥无效）。常见错误码的含义参见 常见问题。

​
联系方式

若自助排查后仍未解决，可通过以下渠道获取支持：
  • 关于（About）页面：平台的 About 页面通常提供官方联系方式、社区链接、服务条款与隐私政策。
  • 社区渠道：若平台提供社群（如交流群、论坛），可在社区提交问题。
提交问题时，建议提供以下信息以便定位（不得提供完整的 API 密钥或账户密码）：
  • 所用模型名称。
  • 调用的大致时间。
  • 完整的错误返回信息（message 部分）。
  • 用量日志中对应记录的截图（敏感信息可打码）。

​
安全须知

  • 不得向任何人（包括自称客服的人员）提供完整的 API 密钥或账户密码。正规客服不会索取上述信息。
  • 不得将密钥公开发布于聊天群、论坛或代码仓库。需展示时应对密钥打码处理。
  • 如怀疑密钥泄露，应立即在密钥页面删除并重新创建。

​
相关文档