使用手册/系统开发者

系统开发者 友好 API

OpenAI 兼容格式,支持所有主流编程语言,让开发更简单

快速开始

1

注册账号

访问官网注册账号,获取 API Key

访问 https://openhubs.com 注册
2

获取密钥

在控制台创建 API Key

控制台 → API Keys → 创建新密钥
3

安装 SDK

选择您熟悉的编程语言安装 SDK

npm install @openhubs/sdk
4

开始调用

编写代码,调用 AI API

openhubs.chat.create({ model: "gpt-5.4-mini" })

API 端点

POST/v1/chat/completions对话补全 - 发送对话消息,获取 AI 回复
GET/v1/models列出模型 - 获取可用模型列表
POST/v1/embeddings向量嵌入 - 将文本转换为向量
POST/v1/images/generations图像生成 - 生成 AI 图像
POST/v1/completions文本补全 - 续写文本内容

SDK 下载

JavaScript / TypeScript官方
vv2.1.010K+/日
Python官方
vv2.1.015K+/日
Go官方
vv1.5.03K+/日
Java社区
vv1.3.02K+/日
Rust社区
vv0.9.01K+/日
PHP社区
vv1.2.0800+/日

代码示例

import { OpenHubs } from '@openhubs/sdk';

const client = new OpenHubs({
  apiKey: process.env.OPENHUBS_API_KEY,
  baseURL: 'https://api.open-hubs.com/v1'
});

// 发送对话
const response = await client.chat.completions.create({
  model: 'gpt-5.4-mini',
  messages: [
    { role: 'system', content: '你是专业的AI助手' },
    { role: 'user', content: '你好,请介绍一下你自己' }
  ],
  temperature: 0.7,
  max_tokens: 2000
});

console.log(response.choices[0].message.content);

最佳实践

使用流式响应

对于长文本生成,使用流式响应可以显著提升用户体验

stream: true

妥善保管 API Key

不要在客户端代码中硬编码 API Key,使用环境变量

process.env.OPENHUBS_API_KEY

实现重试机制

网络不稳定时,实现指数退避重试提高稳定性

maxRetries: 3

合理设置 Temperature

创意任务用 0.7-0.9,准确任务用 0.1-0.3

temperature: 0.7

善用缓存

对于相同的问题,使用缓存减少 API 调用成本

cache: true

控制 Token 数量

设置合理的 max_tokens,避免不必要的费用

max_tokens: 1000

常见问题

如何获取 API Key?

注册账号后,访问控制台 → API Keys → 创建新密钥即可。请妥善保管您的密钥,不要泄露给他人。

OpenHubs API 和 OpenAI API 的区别?

OpenHubs API 完全兼容 OpenAI API 格式,您只需修改 base URL 即可无缝迁移。我们还提供更多模型选择和更优惠的价格。

支持流式响应吗?

支持!使用 SSE(Server-Sent Events)技术,支持流式返回 token,适合聊天机器人和实时应用场景。

如何控制 API 调用成本?

可以通过设置 max_tokens、使用更小的模型、启用缓存等方式控制成本。企业版还提供额度管理和预警功能。

有调用频率限制吗?

免费用户每秒 10 次,专业版每秒 300 次,企业版无限制。超额后会自动限流,建议实现重试机制。