📘 ComputerHub API 文档

完全兼容 OpenAI API 格式,一个 Key 调用 25+ 主流模型。零迁移成本,三步即可上手。

🤖
25+
可用模型
5
上游供应商
🔄
100%
OpenAI 兼容
💰
¥10
新用户赠送

请求架构 — 你的请求如何到达模型

👨‍💻 你的应用
Python / Node / cURL
🔀 ComputerHub
API 网关 www.computerhubtoken.com
DeepSeek
硅基流动
AI智算

🚀 快速开始 — 三步上手

1

🔑 注册并获取 API Key

注册账号 → 登录控制台 → 进入「API 密钥」页面 → 点击「新建密钥」→ 复制生成的 sk-xxx Key(仅显示一次!)

🎁 新用户送 ¥10 红包,可直接调用所有模型
2

🔗 配置 Base URL(一行代码)

将你代码中的 https://api.openai.com/v1 替换为 Base URL https://www.computerhubtoken.com/v1
即向 POST https://www.computerhubtoken.com/v1/chat/completions 发送请求(OpenAI 兼容 SDK 会自动补全 /chat/completions 路径)

💡 只改 base_url 和 api_key,其他代码不用动
3

🎯 发起第一个请求

用你的 ComputerHub Key 替换原有 Key,选择模型,发送请求。搞定!

✅ 支持 Python / Node.js / Go / Java / cURL 等

📋 复制即用的代码示例

cURL
Python
Node.js
Go
📋 复制
# 在终端中直接运行 — 调用 DeepSeek-V3 模型
curl -X POST https://www.computerhubtoken.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-api-key-here" \
  -d '{
    "model": "DeepSeek-V3",
    "messages": [
      {"role": "user", "content": "你好,请介绍一下你自己"}
    ],
    "max_tokens": 500
  }'
# Python — 使用官方 openai SDK(推荐)
from openai import OpenAI

# 初始化客户端(只需改这两个参数)
client = OpenAI(
    api_key="sk-your-api-key-here",
    base_url="https://www.computerhubtoken.com/v1",
)

# 发起对话请求
response = client.chat.completions.create(
    model="DeepSeek-V3",       # 可替换为任意支持的模型
    messages=[
        {"role": "user", "content": "你好,请介绍一下你自己"}
    ],
    max_tokens=500,
)

# 打印回复
print(response.choices[0].message.content)
// Node.js — 使用官方 openai SDK(推荐)
import OpenAI from "openai";

// 初始化客户端(只需改这两个参数)
const client = new OpenAI({
  apiKey: "sk-your-api-key-here",
  baseURL: "https://www.computerhubtoken.com/v1",
});

// 发起对话请求
const response = await client.chat.completions.create({
  model: "DeepSeek-V3",     // 可替换为任意支持的模型
  messages: [
    { role: "user", content: "你好,请介绍一下你自己" },
  ],
  max_tokens: 500,
});

console.log(response.choices[0].message.content);
// Go — 使用标准库 net/http
package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "io"
    "net/http"
)

func main() {
    payload := map[string]any{
        "model": "DeepSeek-V3",
        "messages": []map[string]string{
            {"role": "user", "content": "你好!"},
        },
        "max_tokens": 500,
    }
    body, _ := json.Marshal(payload)
    req, _ := http.NewRequest(
        "POST", "https://www.computerhubtoken.com/v1/chat/completions",
        bytes.NewReader(body),
    )
    req.Header.Set("Authorization", "Bearer sk-your-api-key-here")
    req.Header.Set("Content-Type", "application/json")
    resp, _ := http.DefaultClient.Do(req)
    defer resp.Body.Close()
    data, _ := io.ReadAll(resp.Body)
    fmt.Println(string(data))
}
零迁移成本:如果你已经在使用 OpenAI SDK(任何语言),只需要修改初始化时的 base_url 和 api_key,其余业务代码完全不用动。

🔑 认证 & API 密钥

ComputerHub 使用标准的 Bearer Token 认证方式,与 OpenAI 完全一致。

获取密钥步骤

1

登录控制台

访问 登录页面,使用你的账号密码登录

2

创建密钥

进入「API 密钥」→ 点击「新建密钥」→ 设置名称和用途 → 确认创建

3

复制保存

立即复制生成的 sk-xxx 密钥(关闭后无法再次查看完整内容)

认证格式

HTTP 请求头📋 复制
Authorization: Bearer sk-your-api-key-here
Content-Type: application/json
⚠️
安全提醒:不要将 API Key 提交到 Git 仓库、写在客户端代码或暴露在浏览器前端。建议通过环境变量或密钥管理服务存储。

安全最佳实践

🔐

环境变量存储

将 Key 存储在 .env 或系统环境变量中,代码中通过 os.environ 读取

🏷️

分环境隔离

开发/测试/生产使用不同的 Key,避免互相影响

📊

设置配额上限

为每个 Key 设置合理的月度预算,防止意外超额消费

🔄

定期轮换

定期更换 Key,禁用不再使用的旧密钥

🤖 模型列表

ComputerHub 聚合了来自 3 个活跃供应商25 个模型,覆盖文本对话、深度推理、视觉理解、视频生成、向量化等场景。

📝 文本对话模型

文本DeepSeek-V364K · DeepSeek
文本DeepSeek-V3.264K · 硅基流动
文本DeepSeek-V4-Flash64K · DeepSeek
文本DeepSeek-V4-Pro64K · DeepSeek
文本Qwen3.5-397B-A17B128K · 阿里通义
文本Qwen3-32B128K · 阿里通义
文本GLM-5.2128K · 智谱
文本MiniMax-M2.51M · MiniMax
文本Nex-N2-ProNex · 硅基流动
文本Kimi-K2.7-Code128K · 月之暗面
文本GLM-4-Flash128K · AI智算
免费GLM-Z1-Flash免费 · AI智算
文本Intern-S2-PreviewAI智算

🧠 深度推理模型

推理DeepSeek-R164K · DeepSeek
推理DeepSeek-R1-SF64K · 硅基流动
推理DeepSeek-V3.1-Terminus推理增强 · 硅基流动

👁️ 视觉理解模型(多模态)

视觉Qwen2.5-VL-72B图像理解 · 硅基流动
视觉Qwen2.5-VL-32B图像理解 · 硅基流动
视觉Qwen2.5-VL-7B图像理解 · 硅基流动
视觉GLM-4V-Flash图像理解 · AI智算
视觉Qwen-Coder-32B代码理解 · 硅基流动

🎬 视频生成模型

视频MiniMax-Hailuo-02文生视频 · AI智算
视频GLM-CogView3-Flash图像生成 · AI智算

📐 向量嵌入模型

向量BGE-Large-ZH1024维 · 中文优化
向量BGE-M31024维 · 多语言
💡
如何选择? 日常对话选 DeepSeek-V3DeepSeek-V4-Flash;复杂推理选 DeepSeek-R1;图像理解选 Qwen2.5-VL-72B;视频生成选 MiniMax-Hailuo-02

💡 常见场景快速参考

根据你的使用场景,直接复制对应的代码模板。

🗣️ 智能客服 / 对话机器人

Python📋 复制
from openai import OpenAI

client = OpenAI(api_key="sk-xxx", base_url="https://www.computerhubtoken.com/v1")

# 流式输出,适合实时对话
stream = client.chat.completions.create(
    model="DeepSeek-V3",
    messages=[{"role": "user", "content": "我的订单什么时候发货?"}],
    stream=True,   # 开启流式
    temperature=0.7,
)
for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

🔬 复杂推理 / 数学 / 代码分析

Python📋 复制
from openai import OpenAI

client = OpenAI(api_key="sk-xxx", base_url="https://www.computerhubtoken.com/v1")

response = client.chat.completions.create(
    model="DeepSeek-R1",     # 推理模型
    messages=[
        {"role": "system", "content": "你是一个数学专家,请逐步推导并给出答案。"},
        {"role": "user", "content": "证明根号2是无理数"}
    ],
    max_tokens=8000,           # 推理模型需要更大的 token 预算
)
print(response.choices[0].message.content)

🖼️ 图像理解(看图说话)

Python📋 复制
from openai import OpenAI

client = OpenAI(api_key="sk-xxx", base_url="https://www.computerhubtoken.com/v1")

response = client.chat.completions.create(
    model="Qwen2.5-VL-72B",    # 视觉模型
    messages=[{
        "role": "user",
        "content": [
            {"type": "text", "text": "这张图片里有什么?请详细描述。"},
            {"type": "image_url", "image_url": {"url": "https://example.com/photo.jpg"}}
        ]
    }],
)
print(response.choices[0].message.content)

📝 文本向量化(RAG / 语义搜索)

Python📋 复制
from openai import OpenAI

client = OpenAI(api_key="sk-xxx", base_url="https://www.computerhubtoken.com/v1")

response = client.embeddings.create(
    model="BGE-Large-ZH",         # 中文向量化模型
    input="人工智能正在改变世界",
)
vector = response.data[0].embedding
print(f"向量维度: {len(vector)}, 前5维: {vector[:5]}")

🎬 视频生成

cURL📋 复制
curl -X POST https://www.computerhubtoken.com/v1/video_generation \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxx" \
  -d '{
    "model": "MiniMax-Hailuo-02",
    "input": {
      "prompt": "一只猫在沙滩上奔跑,夕阳背景",
      "duration": 6,
      "resolution": "720p"
    }
  }'

🔗 LangChain 集成

Python📋 复制
from langchain_openai import ChatOpenAI

llm = ChatOpenAI(
    model="DeepSeek-V3",
    api_key="sk-xxx",
    base_url="https://www.computerhubtoken.com/v1",
    temperature=0.7,
)
response = llm.invoke("用一句话解释量子计算")
print(response.content)

💬 对话补全 API

核心端点:创建对话补全请求。完全兼容 OpenAI Chat Completions API

POST /v1/chat/completions

请求参数

参数类型必填说明
modelstring必填模型 ID,如 DeepSeek-V3DeepSeek-R1Qwen2.5-VL-72B
messagesarray必填对话消息数组,每条含 role(system/user/assistant) 和 content
max_tokensinteger可选最大生成 Token 数,默认 4096(推理模型建议 ≥ 8000)
temperaturefloat可选采样温度 0~2,默认 1.0(值越低输出越确定)
top_pfloat可选核采样概率,默认 1.0(建议与 temperature 二选一)
streamboolean可选是否流式返回(SSE),默认 false
stoparray/string可选停止序列,遇到这些词时停止生成

请求示例

Request Body (JSON)📋 复制
{
  "model": "DeepSeek-V3",
  "messages": [
    {"role": "system", "content": "你是一个专业的技术文档撰写助手。"},
    {"role": "user",   "content": "解释 RESTful API 的设计原则"}
  ],
  "max_tokens": 2048,
  "temperature": 0.7,
  "stream": false
}

响应示例

200 OK Response📋 复制
{
  "id": "chatcmpl-abc123def456",
  "object": "chat.completion",
  "created": 1721148800,
  "model": "DeepSeek-V3",
  "choices": [{
    "index": 0,
    "message": {
      "role": "assistant",
      "content": "RESTful API 是一种基于 HTTP 协议的软件架构风格..."
    },
    "finish_reason": "stop"
  }],
  "usage": {
    "prompt_tokens": 28,
    "completion_tokens": 512,
    "total_tokens": 540
  }
}
💡
推理模型特殊说明:使用 DeepSeek-R1 等推理模型时,响应可能包含 reasoning_content 字段(思考过程)。建议设置 max_tokens ≥ 8000 以避免思考过程被截断。

流式输出 (SSE)

设置 "stream": true 即可启用 Server-Sent Events 流式响应,逐 token 返回结果,适合聊天机器人等实时交互场景。

Python 流式示例

Python — 逐字输出📋 复制
from openai import OpenAI

client = OpenAI(api_key="sk-xxx", base_url="https://www.computerhubtoken.com/v1")

stream = client.chat.completions.create(
    model="DeepSeek-V3",
    messages=[{"role": "user", "content": "写一首关于未来的诗"}],
    stream=True,
)

# 逐块打印,实现打字机效果
for chunk in stream:
    content = chunk.choices[0].delta.content
    if content:
        print(content, end="", flush=True)

Node.js 流式示例

Node.js — async iterator📋 复制
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-xxx",
  baseURL: "https://www.computerhubtoken.com/v1",
});

const stream = await client.chat.completions.create({
  model: "DeepSeek-V3",
  messages: [{ role: "user", content: "讲一个短故事" }],
  stream: true,
});

// 使用 for await...of 逐块处理
for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}
💡
何时使用流式? 聊天界面、实时翻译、语音合成、长文本生成等需要「打字机效果」的场景。简单的一次性任务(如分类、提取)不需要开启。

📐 向量化 API (Embeddings)

将文本转换为高维向量,用于语义搜索、RAG 检索、聚类分析等场景。

POST /v1/embeddings

请求示例

Request📋 复制
{
  "model": "BGE-Large-ZH",
  "input": ["ComputerHub 是一个算力聚合分发平台", "AI 模型调用服务"]
}

响应示例

Response📋 复制
{
  "object": "list",
  "data": [
    {
      "object": "embedding",
      "index": 0,
      "embedding": [-0.0241, 0.0128, 0.0037, ...]  // 1024 维浮点数
    },
    {
      "object": "embedding",
      "index": 1,
      "embedding": [-0.0183, 0.0201, -0.0072, ...]
    }
  ],
  "model": "BGE-Large-ZH",
  "usage": { "prompt_tokens": 24, "total_tokens": 24 }
}
💡
可用模型:BGE-Large-ZH(中文优化,1024维)、BGE-M3(多语言,1024维)。中文场景推荐前者。

🎬 视频生成 API

根据文字描述生成短视频,当前支持 MiniMax 海螺和 GLM CogView3 图像生成。

POST /v1/video_generation

请求示例

Request Body📋 复制
{
  "model": "MiniMax-Hailuo-02",
  "input": {
    "prompt": "一只橘猫在樱花树下奔跑,慢动作,电影质感",
    "duration": 6,
    "resolution": "720p",
    "negative_prompt": "模糊,低质量,变形"
  }
}
⏱️
注意:视频生成通常需要 30~120 秒的处理时间,请耐心等待响应。生成时长和分辨率会影响处理时间和费用。

🔀 智能路由

ComputerHub 的核心能力——每次请求自动选择最优供应商渠道。

路由策略一览

策略工作方式适用场景
cost_optimal综合价格 + 延迟 + 可用率加权评分大多数场景(默认推荐 ✅)
lowest_latency优先选择延迟最低的渠道实时对话、客服机器人
failover_only主渠道优先,故障时自动切换有主备需求的企业部署
大多数情况下你不需要关心路由。系统默认使用 cost_optimal 策略,会自动为你选择性价比最高的渠道。只有在有特殊需求时才需要手动指定策略。

🛡️ 故障转移

当某个上游供应商出现故障时,系统自动切换到其他可用渠道,保障你的服务不中断。

🔌

自动检测

持续监控各渠道健康状态,错误率超阈值自动触发熔断

🔄

透明重试

5xx 错误或超时时自动重试其他渠道,最多 2 次,对调用方无感

📊

转移追踪

响应头包含 X-ComputerHub-Failover 标记是否发生了故障转移

💰

不重复计费

重试产生的费用不计入账单,只按最终成功的渠道收费

🐛 错误码速查

HTTP错误码含义解决方法
400ERR_4001请求参数错误检查 JSON 格式和必填字段
401ERR_4011API Key 无效确认 Key 正确且未过期
401ERR_4012Key 已被禁用联系管理员或在控制台重新启用
403ERR_4031无权访问该模型升级套餐或更换模型
429ERR_4291频率超限降低请求频率或升级套餐
429ERR_4292配额用完充值或等待下月额度刷新
402ERR_4021余额不足前往控制台充值
503ERR_5031所有渠道不可用稍后重试,系统正在恢复
504ERR_5041请求超时增大超时时间或简化请求

🚦 速率限制

套餐RPM
(请求/分钟)
TPM
(Token/分钟)
并发
开发者(免费)1010K3
专业版500500K50
企业版无限制无限制无限制
响应头中的限流信息
X-RateLimit-Limit: 500        # 该窗口内允许的最大请求数
X-RateLimit-Remaining: 487  # 剩余可用请求数
X-RateLimit-Reset: 1721148860 # 窗口重置时间戳 (Unix)

💰 计费说明

按量计费,精确到每个 Token。不额外加价。

计费公式

Billing Formula
总费用 = 输入Token × 输入单价 + 输出Token × 输出单价

费率要点

  • 价格透明:与各 Provider 官方价格一致,不额外加价
  • 缓存命中免费:语义缓存命中的请求不收费
  • 重试不收费:故障转移的重试请求不计入账单
  • 货币:统一以人民币 (CNY) 结算
🎁
新用户福利:注册即送 ¥10 红包,约可调用 DeepSeek-V3 数千次,足够完成开发和测试。

🛠️ SDK & 工具

ComputerHub 100% 兼容 OpenAI SDK,无需安装任何额外的专用库。

官方 SDK 安装

语言SDK 包名安装命令
Pythonopenaipip install openai
Node.jsopenainpm install openai
Gogo-openaigo get github.com/sashabaranov/go-openai
Javaopenai-javaimplementation 'com.theokanning:openai-java'
Rustasync-openaicargo add async-openai
.NET/C#openai-dotnetdotnet add package OpenAI
Dartopenai-dartdart pub add openai
Kotlinopenai-kotlinimplementation("com.aallam.openai:openai-client")

框架集成

🦜🔗

LangChain

langchain_openai.ChatOpenAI → 改 base_url 即可

🤗

Transformers / LlamaIndex

所有基于 OpenAI SDK 的框架均兼容

🌊

Flowise / Dify

在 OpenAI 兼容配置中填入 ComputerHub 地址

Vercel AI SDK

OpenAIProvider 自定义 baseUrl

更多 SDK 详情和示例代码,请访问 SDK 下载页面 →