Client SDKs
Client SDKs
轻量、类型安全的官方客户端库，覆盖 Chat Completions、Responses、Anthropic Messages 和 Models 等最新 API。
安装
| 语言 | 包名 | 安装命令 |
|---|---|---|
| TypeScript / Node.js | @hypershub/sdk | npm install @hypershub/sdk |
适用场景
当你需要直接、高效地访问模型推理，并希望自己管理应用逻辑时，选择 Client SDK：
- OpenAI 兼容 — Create a chat completion / Create a response
- Anthropic Messages — Create a message，支持 Claude 原生格式
- Models — List models / Retrieve model，查询可用模型与单个模型详情
- 流式响应 — AsyncGenerator 封装，无需手动解析 SSE
SDK 刻意保持精简，与平台 REST API 接口一一对应，并提供完整类型安全，无需对抗额外抽象层。
快速示例
import { HypersHub } from '@hypershub/sdk'
const client = new HypersHub({ apiKey: process.env.HYPERSHUB_API_KEY })
// Create a chat completion
const chat = await client.chat.completions.create({
model: 'claude-sonnet-4-6',
messages: [{ role: 'user', content: 'Explain quantum computing in one sentence.' }],
})
console.log(chat.choices[0].message.content)
// Create a response
const response = await client.responses.create({
model: 'gpt-5.4',
input: 'Explain edge computing in three bullet points.',
})
console.log(response.output)
// List models
const models = await client.models.list()
console.log(models.data.map((model) => model.id))SDK vs 直接 HTTP 请求
| Client SDK | HTTP 直接请求 | |
|---|---|---|
| 类型安全 | 完整 TypeScript 类型 | 需要自行定义 |
| 认证处理 | 自动注入 Bearer Token | 手动设置 Header |
| 流式响应 | AsyncGenerator 封装 | 需要手动解析 SSE |
| 错误处理 | 类型化错误类 | 需要手动判断状态码 |
| 安装 | npm install @hypershub/sdk | 无需额外依赖 |