API 参考
HypersHub 提供统一的 AI 模型接入网关,兼容多家 LLM 提供商。无需改动现有代码,即可使用 OpenAI 兼容格式或各厂商的原生接口。
接入地址
https://apiclaw.cc接口端点
Create a chat completionOpenAI 兼容
POST/v1/chat/completions
兼容 OpenAI 生态库与工具,支持所有模型。
ResponsesOpenAI 原生
POST/v1/responses
OpenAI Responses API 原生格式,支持 gpt-5.x 系列模型,支持流式与 Function Calling。
Create a messageClaude 原生
POST/v1/messages
Anthropic 原生格式,支持 Extended Thinking 与完整 Tool Use 能力。
Generate contentGemini 原生
POST/v1beta/models/{model}:generateContent
Google Gemini 格式,支持多模态、Function Calling 与 thinkingConfig。
Stream generate contentGemini 原生
POST/v1beta/models/{model}:streamGenerateContent
Google Gemini 流式格式,以 SSE 逐步返回生成内容。
List modelsOpenAI 兼容
GET/v1/models
列出当前 API Key 可访问的模型,兼容 OpenAI Models API。
Retrieve modelOpenAI 兼容
GET/v1/models/{model}
查询单个模型的详情。若该模型不在当前 API Key 的可访问范围内,返回 404。
OpenAPI 规范
完整的 HypersHub API 已使用 OpenAPI 规范进行描述,支持 YAML 和 JSON 两种格式:
上述规范文件可与 Swagger UI、 Postman 或任何兼容 OpenAPI 的代码生成工具配合使用,用于浏览接口文档或生成客户端 SDK。
鉴权方式
HypersHub 使用 API Key 对请求进行鉴权。你可以通过标准的 Authorization 请求头传递 API Key,也可以使用 Anthropic 或 Gemini 的原生鉴权头。
| 协议格式 | 请求头示例 |
|---|---|
| OpenAI | Authorization: Bearer $HY_API_KEY |
| Anthropic | x-api-key: $HY_API_KEY |
| Gemini | x-goog-api-key: $HY_API_KEY |

