概览

{{NAME}} 是一个组织内部的 API 中转与分发平台。你无需直连各家大模型厂商，只要把请求发到本平台，平台会完成鉴权、限流、配额校验与转发，并统一记录用量与日志。

快速开始

三步即可完成第一次调用：

1. 获取 API Key

登录管理面板 {{DASHBOARD}}，进入「API Key」页面创建。创建后密钥 仅展示一次，请立即保存。

2. 配置客户端

把 Base URL 指向 {{BASE}}/v1，密钥填入你的 sk-hub-...。任何兼容 OpenAI 的 SDK / 工具都可直接使用。

3. 发起请求

curl {{BASE}}/v1/chat/completions \
  -H "Authorization: Bearer sk-hub-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "你好"}]
  }'

接入信息

认证方式

平台支持两种等价的鉴权头，任选其一即可：

方式一：标准 Bearer（推荐）

Authorization: Bearer sk-hub-xxxxxxxxxxxxxxxx

方式二：x-api-key 头

x-api-key: sk-hub-xxxxxxxxxxxxxxxx

调用示例

cURL

curl {{BASE}}/v1/chat/completions \
  -H "Authorization: Bearer sk-hub-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {"role": "system", "content": "你是一个乐于助人的助手"},
      {"role": "user", "content": "用一句话介绍你自己"}
    ],
    "temperature": 0.7
  }'

Python（OpenAI 官方 SDK）

from openai import OpenAI

client = OpenAI(
    base_url="{{BASE}}/v1",
    api_key="sk-hub-你的密钥",
)

resp = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)

Node.js

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "{{BASE}}/v1",
  apiKey: "sk-hub-你的密钥",
});

const resp = await client.chat.completions.create({
  model: "gpt-4o",
  messages: [{ role: "user", content: "你好" }],
});
console.log(resp.choices[0].message.content);

流式（Python）

from openai import OpenAI

client = OpenAI(base_url="{{BASE}}/v1", api_key="sk-hub-你的密钥")

stream = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "写一首短诗"}],
    stream=True,
)
for chunk in stream:
    delta = chunk.choices[0].delta.content
    if delta:
        print(delta, end="", flush=True)

请求参数

请求体与 OpenAI Chat Completions 保持一致，平台原样透传给你的上游供应商。常用字段：

流式响应

当请求体包含 "stream": true 时，平台以 text/event-stream 返回 SSE，逐块透传上游内容：

data: {"id":"chatcmpl-...","choices":[{"delta":{"content":"你"}}]}

data: {"id":"chatcmpl-...","choices":[{"delta":{"content":"好"}}]}

data: [DONE]

模型路由

平台支持管理员配置「模型路由」：把某个请求模型名转发到指定供应商的指定模型。你只需按平台约定的模型名调用，实际由哪个供应商处理由管理员配置决定。

{ "model": "gpt-4o", "messages": [{"role": "user", "content": "你好"}] }

平台会自动改写为上游模型名并转发，你的代码无需任何改动。若模型名未被任何路由命中，则按默认路由规则透传给对应供应商。

配置字段填写指南（管理员）

本节说明管理面板中「供应商」「路由配置」「模型路由」三个表单里每个输入框应该填什么。普通调用方无需关心，由管理员配置一次即可。

一、供应商（「供应商」页）

代表一家上游厂商的连接信息，是整个平台转发的基础。

二、路由配置（「路由模型」页）

把「对外平台路径」映射到「某供应商的某个上游路径」。

三、模型路由（「供应商」页底部「模型路由配置」）

把「请求模型名」覆盖路由到另一家供应商，并改写为上游支持的模型名。

完整示例：接入小米 MiMo，并让 mimo-* 走它

配好后，调用方使用 model: "mimo-v2.6-pro" 或 "mimo-v2.6-flash" 均会被路由到小米 MiMo，最终地址为 https://token-plan-cn.xiaomimimo.com/v1/chat/completions。

错误码

失败时返回 JSON，结构与 OpenAI 兼容：

{
  "error": {
    "code": 40100,
    "message": "API Key 无效"
  }
}

限流与配额

平台有两层限制，均由管理员配置：

常见问题

Q：能用任何 OpenAI SDK 吗？

可以。只要支持自定义 base_url 与 api_key 即可，本平台保持 OpenAI 兼容。

Q：为什么会返回 40400「没有匹配的路由规则」？

说明请求路径未被平台定义为路由。请确认路径（如 /v1/chat/completions）已在管理面板「路由模型」页中配置，或联系管理员添加。

Q：管理员新增路由时提示「该平台路径已存在」，但我想让同一路径走不同厂商？

这是设计使然：同一平台路径只能有一条路由（它是该路径的默认去向）。要让同一路径下不同模型走不同供应商，请保留这条默认路由，改在「供应商 → 模型路由配置」中按模型名添加映射（见 配置字段填写指南）。

Q：为什么会返回 40300「本组织暂无可用的上游供应商」？

平台按组织隔离路由，组织用户只会使用本组织的供应商。出现该提示说明本组织尚未配置启用中的供应商（或供应商的「归属组织」与本组织不一致）。请联系管理员在本组织下新增并启用供应商；超级管理员不受此限制。

Q：为什么我的请求没有走我组织配置的供应商？

请检查两点：① 该供应商的 organization 是否与你所在组织一致且处于启用状态；② 若你要按模型名改写并指定供应商，对应「模型路由」的归属组织也须是本组织（全局模型路由对组织用户不生效）。本组织内存在多个可用供应商时，未命中模型路由的请求会走最早创建且启用中的那个。

Q：模型名应该填什么？

填写平台约定或管理员告知的模型名即可。若配置了模型路由，平台会自动改写到你实际使用的那家模型。

Q：密钥只显示一次，忘了怎么办？

出于安全考虑，平台不保存明文密钥。请在管理面板重新创建一个，并禁用旧的。

Q：如何查看我的用量？

登录管理面板，在「用量统计」与「请求日志」中查看调用明细与 token 消耗。

域名适配与扩展

本页为可移植文档：当平台部署到新域名时，只需修改页面顶部的一处配置即可全量替换。

修改方式

用文本编辑器打开本文件，找到顶部的 SITE 配置块：

const SITE = {
  base: "https://ai.muvocal.com",    // 网关对外域名（含协议，不要以 / 结尾）
  name: "API Gateway Hub",           // 平台名称
  dashboard: "https://ai.muvocal.com" // 管理面板地址
};

把 base 改为新域名（例如 https://api.example.com）后保存，页面内所有示例（Base URL、cURL、SDK 代码）会自动同步更新。

当前文档默认域名为 {{BASE}}。