常见问题

API 地址应该填哪个？

API Base URL 通常填写 https://hyperapi.cc/v1。如果客户端自动添加 /v1，填写 https://hyperapi.cc。

https://docs.hyperapi.cc 是文档站地址，不接收模型 API 请求。

401：令牌无效或未提供

确认 Authorization: Bearer ... 请求头已发送，令牌来自 Hyper API 控制台，没有多余空格或换行，且未过期、删除或禁用。账号密码与其他平台的令牌不能代替本站令牌。

403：没有权限

检查令牌的模型限制、分组及 IP 限制。使用代理或服务器发起请求时，出口 IP 可能与个人电脑不同。

模型不存在，或没有可用渠道

从 模型与价格 及 /v1/models 返回结果中确认模型 ID。检查大小写、后缀、接口类型和令牌分组。暂时没有可用渠道时，可以稍后再试或换用已有权限的其他模型。

余额足够，为什么仍提示额度不足？

账户余额、令牌额度、有效期和分组是不同条件。请逐项检查，具体原因以响应正文及控制台记录为准。

429：请求过多

降低并发、增加调用间隔，检查是否有多个应用共享令牌；阅读错误正文以区分限流、额度和上游容量问题。不要无限立即重试。

502 / 503 / 504 或响应超时

这通常需要检查网关、渠道和上游状态。先用简短请求测试，记录发生时间和模型，结合使用日志判断。适当增加客户端超时，对临时错误采用有限次数的退避重试。

为什么没有显示流式输出？

确认请求中包含 "stream": true，cURL 使用 --no-buffer，应用按 SSE 解析数据。自建代理和客户端缓冲也可能导致内容最后一次性出现。

模型价格或分组倍率以哪里为准？

以 主站模型与价格、控制台当时显示以及实际使用日志为准。文档中的请求和响应示例不构成价格或可用性承诺。

反馈问题时提供什么？

通过主站提供的联系入口反馈，并附上：

• 发生时间与时区。
• 客户端名称、版本和请求接口路径。
• 模型 ID、HTTP 状态码与错误正文。
• 可复现的最小请求，以及请求 ID（如果响应提供）。

提交前请隐藏 API 令牌、账号隐私信息和不需要共享的对话内容。