接口概览

Hyper API 的兼容接口使用 HTTPS 和 Bearer 令牌。本版文档介绍模型列表和对话接口；其他能力以主站模型页面、对应模型支持的端点及实际返回为准。

服务地址

用途	地址
主站与控制台	https://hyperapi.cc
API Base URL	https://hyperapi.cc/v1
文档站	https://docs.hyperapi.cc

文档域名用于查阅指南；API 请求应发送到 hyperapi.cc。

常用端点

方法	路径	用途
GET	/v1/models	查询当前令牌返回的模型列表
POST	/v1/chat/completions	发送对话请求，适用于支持该接口的模型

模型列表

curl --fail-with-body 'https://hyperapi.cc/v1/models' \
  -H "Authorization: Bearer $HYPERAPI_API_KEY"

响应结构示意（MODEL_ID 为占位符）：

{
  "object": "list",
  "data": [
    { "id": "MODEL_ID", "object": "model" }
  ]
}

实际响应可能包含其他字段。不要依赖列表顺序，也不要把模型 ID 的显示名称当作请求中的模型标识。

错误处理

先检查 HTTP 状态码，再读取返回的错误正文。不同上游和接口可能返回不同的错误字段，应用应能处理非 JSON 错误或网关超时。

状态码	常见排查方向
400	JSON 格式、参数、上下文长度或接口与模型是否匹配
401	令牌缺失、错误、失效或已被删除
403	模型、分组、IP 等访问限制
404	请求路径错误，或目标模型 / 资源不存在
429	速率限制、额度或上游容量；结合错误正文判断
5xx	网关、渠道或上游服务异常

余额或额度问题不一定对应固定状态码，请优先阅读错误正文。具体步骤见 常见问题。