MB ModelBridge 文档
获取 API Key

API 使用文档

从注册到调用大模型。

注册后你会获得一把 `mbk_...` API Key。把它放进请求头,就可以用 OpenAI 兼容格式调用 ChatGPT、Claude、Gemini、Grok、DeepSeek、通义千问、Kimi 等模型。

快速开始

三步完成第一次调用

1

注册账号

打开注册页,填写名称、邮箱、密码。如果站点开启邀请码,需要同时填写邀请码。

https://ai.tinydou.top/register
2

保存 API Key

注册成功后会显示一把 `mbk_...` Key。完整 Key 只显示一次,请立即保存。

3

调用统一接口

把 `mbk_...` 放到请求头 `Authorization: Bearer`,模型可先使用 `openai/gpt-5.5`。

curl https://ai.tinydou.top/api/v1/chat/completions \
  -H "Authorization: Bearer mbk_替换成用户自己的APIKey" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-5.5",
    "messages": [
      {
        "role": "user",
        "content": "介绍下你自己"
      }
    ]
  }'

接口说明

OpenAI 兼容请求格式

POST/api/v1/chat/completions
GET/api/v1/models
POST/v1/chat/completions
GET/api/health

认证方式:使用注册得到的 `mbk_...`,格式为 `Authorization: Bearer mbk_xxx`。

模型名称:请求体里的 `model` 决定调用哪个模型,例如 `openai/gpt-5.5`、`anthropic/claude-3-5-sonnet`、`qwen/qwen-plus`。

自动路由:不想手动挑模型时,可以使用 `router/auto`、`router/fast`、`router/reasoning`、`router/economy`。

查看模型:访问 `/api/v1/models` 可获取当前站点开放的模型列表。

模型名称

常用 model 填法

ChatGPTopenai/gpt-5.5
ChatGPTopenai/gpt-4o
Claudeanthropic/claude-3-5-sonnet
Geminigoogle/gemini-1.5-pro
Grokxai/grok-3
DeepSeekdeepseek/deepseek-chat
通义千问qwen/qwen-plus
Kimimoonshot/moonshot-v1-128k
智谱清言zhipu/glm-4-plus
豆包doubao/doubao-1.5-pro
开源通道mistral/mistral-large
开源通道novita/meta-llama-3.1-8b

SDK 示例

JavaScript 和 OpenAI SDK

const response = await fetch("https://ai.tinydou.top/api/v1/chat/completions", {
  method: "POST",
  headers: {
    Authorization: "Bearer mbk_替换成用户自己的APIKey",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    model: "openai/gpt-5.5",
    messages: [
      { role: "user", content: "写一个 AI 产品上线清单" }
    ]
  })
});

const data = await response.json();
console.log(data.choices[0].message.content);
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "mbk_替换成用户自己的APIKey",
  baseURL: "https://ai.tinydou.top/api/v1"
});

const completion = await client.chat.completions.create({
  model: "openai/gpt-5.5",
  messages: [
    { role: "user", content: "请用三句话解释大模型中转站" }
  ]
});

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

路由调用

让系统自动选择合适模型

用量在控制台查看
curl https://ai.tinydou.top/api/v1/chat/completions \
  -H "Authorization: Bearer mbk_替换成用户自己的APIKey" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "router/auto",
    "messages": [
      { "role": "user", "content": "Write a short product announcement in English." }
    ]
  }'

流式输出

stream: true

curl -N https://ai.tinydou.top/api/v1/chat/completions \
  -H "Authorization: Bearer mbk_替换成用户自己的APIKey" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-5.5",
    "stream": true,
    "messages": [
      { "role": "user", "content": "给我一个 5 步学习计划" }
    ]
  }'

常见问题

调不通时先看这里

为什么返回测试响应?

这表示站点当前只返回测试响应。请联系服务方开启真实模型调用。

为什么提示 401 或 invalid_api_key?

请求头里的 `Authorization` 不对。普通用户必须使用注册页生成的 `mbk_...`,格式是 `Authorization: Bearer mbk_xxx`。

用户需要 OpenAI Key 吗?

不需要。你只需要使用本站生成的 `mbk_...` API Key。

模型临时不可用怎么办?

可以改用 `router/auto` 或其他同类模型,例如从 `openai/gpt-5.5` 切换到 `anthropic/claude-3-5-sonnet`。

控制台

管理 Key、用量和余额

用量概览查看 Today / 7 日 / 30 日 Token 消耗和费用变化。
API Key 管理创建、禁用、删除 Key,并设置预算、模型白名单和 IP 白名单。
Playground同一 Prompt 并排测试多个模型,导出 curl、JavaScript、Python 代码。
数据导出导出最近调用 JSON 或 CSV,便于团队对账和分析。