Client SDKs
Client SDKs
轻量、类型安全的官方客户端库，覆盖 Chat Completions、Responses、Anthropic Messages、Gemini 和 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 原生格式
- Gemini — Generate content / Stream generate content
- 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: '用一句话解释量子计算。' }],
})
console.log(chat.choices[0].message.content)
// Create a response
const response = await client.responses.create({
model: 'gpt-5.4',
input: '用三个要点解释边缘计算。',
})
console.log(response.output)
// Generate content
const gemini = await client.gemini.generateContent({
model: 'gemini-3.1-pro-preview',
contents: [{ role: 'user', parts: [{ text: '介绍一下太阳系。' }] }],
})
console.log(gemini.candidates[0]?.content.parts[0])
// 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 | 无需额外依赖 |