API 接入文档

OHUB 对外暴露一个 OpenAI 兼容的 Base URL。调用方只需要替换 API Key、Base URL 和模型 ID，即可接入后台已配置的模型渠道。

当前线上代理路径为 /ohub/v1/，会转发到内部 relay 服务的 /v1/。调用方不需要关心内部端口和容器。

以下示例使用当前系统真实 Token 前缀 sk-hy-。完整 Token 只在创建时展示一次。

curl https://ohub.goodpoint.top/ohub/v1/chat/completions \
  -H "Authorization: Bearer sk-hy-YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [
      { "role": "system", "content": "你是一个严谨的技术助手。" },
      { "role": "user", "content": "用一句话介绍 OHUB。" }
    ],
    "stream": false
  }'

成功时返回 OpenAI 兼容 JSON。若请求失败，响应体会包含 error.message、error.type 等字段。

所有模型调用接口都必须在 HTTP Header 中携带 Bearer Token：

Authorization: Bearer sk-hy-YOUR_TOKEN

当前系统生成格式为 sk-hy-{32位随机十六进制字符}，数据库只保存 SHA-256 哈希，完整 Token 无法二次查看。

请求参数

messages 参数

响应字段

{
  "id": "chatcmpl-xxx",
  "object": "chat.completion",
  "created": 1710000000,
  "model": "deepseek-v4-flash",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "OHUB 是一个 OpenAI 兼容的统一模型网关。"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 20,
    "completion_tokens": 18,
    "total_tokens": 38
  }
}

设置 stream: true 后，接口以 Server-Sent Events 返回增量内容。客户端应逐行读取 data: 事件，直到收到 [DONE]。

curl https://ohub.goodpoint.top/ohub/v1/chat/completions \
  -H "Authorization: Bearer sk-hy-YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [{ "role": "user", "content": "写一段欢迎语" }],
    "stream": true
  }'

data: {"id":"chatcmpl-xxx","object":"chat.completion.chunk","choices":[{"delta":{"content":"你好"},"index":0}]}

data: {"id":"chatcmpl-xxx","object":"chat.completion.chunk","choices":[{"delta":{"content":"，欢迎使用 OHUB"},"index":0}]}

data: [DONE]

请求中的 model 不是展示名称，而是模型 ID。模型 ID 必须同时满足：

• 模型管理中存在并启用。
• 渠道 Ability 映射中存在同名模型。
• Token 的允许模型包含该模型，或允许模型为 *。
• Token 分组与 Ability 映射分组一致，默认建议使用 default。

请求中的模型 ID 必须与上方可用模型列表中的 modelId 完全一致，否则会返回 403 或 503 错误。

OHUB 的 Base URL 已包含 /v1，OpenAI SDK 中请直接填写完整 Base URL。

Node.js

import OpenAI from 'openai'

const client = new OpenAI({
  apiKey: process.env.OHUB_API_KEY,
  baseURL: 'https://ohub.goodpoint.top/ohub/v1',
})

const completion = await client.chat.completions.create({
  model: 'deepseek-v4-flash',
  messages: [
    { role: 'user', content: '你好，OHUB' },
  ],
})

console.log(completion.choices[0]?.message?.content)

Python

from openai import OpenAI

client = OpenAI(
    api_key="sk-hy-YOUR_TOKEN",
    base_url="https://ohub.goodpoint.top/ohub/v1",
)

completion = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[{"role": "user", "content": "你好，OHUB"}],
)

print(completion.choices[0].message.content)

排查优先级：先看 HTTP 状态码，再看 error.type，最后看 error.message 中的上游原始提示。

Token 支持配置额度、并发、RPM、TPM、允许模型、IP 白名单和黑名单。调用前系统会进行 Token 校验、模型权限校验和余额预检查。