跳到主要内容

常见问题

适用范围：HangToken 当前线上服务　最后核验：2026-08-26

**最快排查法：**先用“5 分钟快速开始”中的最小 cURL 测试。同一 Key 和模型在 cURL 成功，通常说明问题位于客户端配置。

401：认证失败​

确认 Key 未带引号或空格、未禁用；OpenAI 使用 Authorization: Bearer，Anthropic/Gemini 使用各自请求头。

402：余额不足​

分别检查账户余额和令牌自身额度；充值后重新发送失败请求。

403：无模型权限​

调用 /v1/models，改用返回的模型；检查 Key 的模型范围与分组。

404：接口不存在​

查看客户端最终 URL。OpenAI Base URL 常为 /v1，Anthropic/Gemini 根地址通常不含 /v1。

429：请求过多​

降低并发，使用带随机抖动的指数退避；不要立即无限重试。

超时或流式中断​

延长读取超时，检查代理是否缓冲 SSE；缩短输入或切换模型进行对照。

上下文超限​

减少历史消息、附件和工具描述；不要只提高输出上限。

模型参数不支持​

移除 temperature、response_format、tools 等可选字段，从最小请求逐项加回。

5xx：服务异常​

有限重试；持续发生时记录北京时间、模型、状态码、耗时和请求 ID。

Key 疑似泄露​

立即撤销并重建，检查异常消费、来源和调用日志，然后联系支持。

联系支持前准备​

  • 问题发生时间与时区、模型名称、接口路径和状态码。
  • 客户端、操作系统和版本号。
  • 已脱敏请求与响应；Key 只保留末尾 4 位。
  • 是否能用最小 cURL 复现。