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

# HHAPI 技术支持指南：提交工单、支持渠道与问题报告清单

> 遇到技术问题或账号问题时，通过支持渠道联系 HHAPI 团队获取帮助。包含建议先自查的常见问题清单，以及提交支持请求时需要准备的详细信息列表。

当你在使用 HHAPI 过程中遇到无法自行解决的技术问题或账号问题时，可以通过本页介绍的渠道联系 HHAPI 团队获取帮助。提交时信息越详细，问题解决越高效。

<Tip>
  在联系支持之前，建议先查阅常见问题文档——大多数常见问题都可以在文档中找到解答：

  * [排查 401 / 403 / 429 鉴权与限流错误](/faq/auth-errors)
  * [Base URL 与 /v1 路径配置说明](/faq/base-url)
  * [模型不可用或返回错误的处理方法](/faq/model-unavailable)
  * [请求超时的原因与处理建议](/faq/timeout)
  * [流式输出异常的排查与修复](/faq/streaming-issues)
  * [浏览器跨域（CORS）问题说明](/faq/cors)
</Tip>

## 支持渠道

<CardGroup cols={2}>
  <Card title="文档搜索" icon="magnifying-glass">
    使用文档站顶部的搜索框，输入关键词快速查找相关文档。大多数常见问题均有对应的说明页面。
  </Card>

  <Card title="控制台支持" icon="headset">
    登录控制台（`<CONSOLE_URL>`）后，可通过控制台内的支持入口提交工单，描述你遇到的问题（待确认具体入口位置）。
  </Card>

  <Card title="其他渠道" icon="comments">
    其他支持渠道（如社区论坛、即时通讯群组等）待补充。请关注官方公告以获取最新联系方式。
  </Card>

  <Card title="查阅更新日志" icon="clock-rotate-left" href="/changelog">
    若遇到行为变更或模型不可用问题，可先查阅更新日志，确认是否为近期的版本变更所致。
  </Card>
</CardGroup>

## 提交问题时请提供以下信息

提交支持请求时，提供完整的上下文信息有助于团队快速定位和复现问题：

<Steps>
  <Step title="请求时间和频率">
    说明问题发生的时间（含时区）和复现频率，例如「2024-01-15 14:30 UTC+8，每次请求均复现」或「偶发，约 10% 的请求会出现」。
  </Step>

  <Step title="错误状态码和完整响应体">
    提供 HTTP 状态码（如 401、429、500）和完整的错误响应 JSON，例如：

    ```json theme={null}
    {
      "error": {
        "message": "Rate limit exceeded",
        "type": "rate_limit_error",
        "code": 429
      }
    }
    ```
  </Step>

  <Step title="使用的接口路径和请求参数">
    说明调用的接口（如 `POST /v1/chat/completions`）和请求参数（如 `model`、`max_tokens` 等），**隐去 API Key 后**粘贴请求体。
  </Step>

  <Step title="编程语言和 SDK 版本">
    说明你使用的编程语言、openai SDK 版本（如 `openai==1.35.0`）或其他 HTTP 客户端及版本号。
  </Step>
</Steps>

<Note>
  **请勿在支持渠道中发送你的 API Key 或账户密码。** HHAPI 支持团队不会要求你提供完整的 API Key。若你怀疑密钥已泄露，请立即在控制台（`<CONSOLE_URL>`）撤销旧密钥并重新生成。
</Note>

***

**相关资源**

* [更新日志](/changelog)
* [获取和管理 API Key](/api-key)