> ## Documentation Index
> Fetch the complete documentation index at: https://docs.moxus.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 技术支持

> 本文档说明问题排查方法与技术支持渠道。

本文档说明问题排查方法与技术支持渠道。

## 自助排查

在寻求人工支持前，建议先按以下步骤自助排查，多数问题可自行解决。

1. 查看用量日志。调用失败或扣费异常时，[用量日志](/zh/platform/dashboard-and-usage) 记录了每次调用的结果与失败原因，是最直接的排查依据。
2. 查阅常见问题。[常见问题](/zh/overview/faq) 汇总了大部分高频问题及处理方法。
3. 核对基础配置：
   * Base URL 是否正确（`https://moxus.ai` 或 `https://moxus.ai/v1`）。
   * 密钥是否正确、是否包含 `Bearer ` 前缀、是否被禁用或过期。
   * 模型名称是否与模型广场完全一致。
   * 账户余额是否充足。

## 排查清单

调用出错时，可按下表逐项确认。

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

## 错误信息说明

API 返回的错误通常采用以下结构：

```json theme={null}
{
  "error": {
    "message": "错误的具体描述",
    "type": "错误类型",
    "code": "错误码"
  }
}
```

其中 `message` 字段通常直接说明问题原因（如余额不足、模型不存在、密钥无效）。常见错误码的含义参见 [常见问题](/zh/overview/faq)。

## 联系方式

若自助排查后仍未解决，可通过以下渠道获取支持：

* 关于（About）页面：平台的 About 页面通常提供官方联系方式、社区链接、服务条款与隐私政策。
* 社区渠道：若平台提供社群（如交流群、论坛），可在社区提交问题。

提交问题时，建议提供以下信息以便定位（不得提供完整的 API 密钥或账户密码）：

* 所用模型名称。
* 调用的大致时间。
* 完整的错误返回信息（`message` 部分）。
* 用量日志中对应记录的截图（敏感信息可打码）。

## 安全须知

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

## 相关文档

* [常见问题](/zh/overview/faq)
* [用量日志](/zh/platform/dashboard-and-usage)
* [账户与 API 密钥](/zh/platform/account-and-keys)