📖 使用指南

萌包子的AI网关是一个「AI 模型网关」：我们帮你接好了各种大模型，你只需要用一个统一的 API Key，就能在任意支持 OpenAI 或 Anthropic 接口的软件里调用它们。所有模型按豆子计费，价格透明，随用随扣。

🚀 快速开始

从零开始只需要三步，全程不到两分钟：

登录账号：点击右上角「登录」，用 UniPass 账号登录（还没有账号？在登录页注册一个就行）。
创建 API Key：进入密钥中心，点击「＋新建密钥」，复制生成的 sk-xxx。密钥只显示一次，请立即保存好。
在 AI 客户端里填写地址和 Key：把你常用的 AI 软件（Cherry Studio / ChatBox / OpenWebUI 等）的接口地址填成下面的 Base URL，API Key 填刚才复制的那串即可。不知道怎么填？直接看免代码接入教程。

Base URL（接口地址）

http://ai.mbaozi.cn/v1

所有客户端 / SDK 都填这个地址，末尾记得带 /v1。

💬 智能对话

「智能对话」是萌包子的个人助理：它实时了解萌包子的站点、最近动态和开发项目，你有任何想问的直接提问即可，萌包子会实时检索最新信息后回答。

进入对话：点击顶部导航「对话」，用 UniPass 账号登录即可使用（不需要 API Key）。
直接提问：比如「你有哪些站点？」「最近更新了什么？」「有哪些游戏？」「开源好物站有哪些项目？」；也可以点下方的快捷问题直接试。
实时检索：萌包子回答前会先标出检索来源（🔍 标签），再基于最新信息回答；对话自动保存，随时可回来继续。

🤖 模型支持

以下是当前实际启用的模型，接口协议（OpenAI / Anthropic）与计费方式在表格中标注。计费有三种方式：免费（额度内免费）、按量（输入/输出/缓存分开计费）、按次（固定每次扣豆）。

模型名称	厂商	接口协议	计费	价格	上下文
deepseek-v4-flash-free限时免费	DeepSeek	🅾️ OpenAI ◈ Anthropic	免费	普通用户每天 100K tokens 订阅用户每天 1000K tokens	—
gpt5.4-mini-free限时免费	OpenAI	🅾️ OpenAI	免费	普通用户每天 100K tokens 订阅用户每天 1000K tokens	—
gpt5.6-luna-free限时免费	OpenAI	🅾️ OpenAI	免费	普通用户每天 100K tokens 订阅用户每天 1000K tokens	—
mimo-v2.5	小米	🅾️ OpenAI ◈ Anthropic	按量	输入 1.0 🫘/K tokens 输出 2.0 🫘/K tokens 缓存 0.02 🫘/K tokens	—
mimo-v2.5-free限时免费	小米	🅾️ OpenAI ◈ Anthropic	免费	普通用户每天 100K tokens 订阅用户每天 1000K tokens	—

模型会不定期上新/调整价格，一切以模型广场实时显示为准。在客户端里切换模型时，选择上面的名称即可（比如 deepseek-v4-flash-free）。

🧩 免代码接入

如果你不想写代码，直接用现成的 AI 客户端软件即可。网关同时支持 OpenAI 兼容接口和 Anthropic 接口，绝大多数客户端都能接入。跟着填三个东西就能通：服务商、Base URL、API Key。认准这几个配置项，其它 AI 客户端同理。

客户端通常提供两种连接模式：OpenAI 兼容（地址填 http://ai.mbaozi.cn/v1）或 Anthropic（地址填 http://ai.mbaozi.cn/，不带 /v1）。选哪个取决于你用的客户端，用 Anthropic 原生模式接入的客户端会自动走 x-api-key 鉴权，网关一样认。

🖥️

Cherry Studio

桌面端 AI 客户端，界面清爽，Windows / Mac 都支持。

服务商 OpenAI（兼容模式）

API 地址 http://ai.mbaozi.cn/v1

API Key sk-你的密钥

打开 Cherry Studio，进入设置 → 模型服务，点击「添加模型服务」。
提供商选择 OpenAI，服务名称随便填（比如 AIGateway）。
API 地址填上面的 http://ai.mbaozi.cn/v1，API Key 填你的 sk-xxx。
保存后回到对话页，在右上角模型下拉里选择 deepseek-v4-flash-free，即可开始聊天。

💬

ChatBox

跨平台 AI 聊天客户端，支持桌面和手机。

服务商 OpenAI API

API Host http://ai.mbaozi.cn/v1

API Key sk-你的密钥

打开 ChatBox，进入设置 → 模型，点击「添加自定义模型」或选择 OpenAI API。
API Host 填上面的 http://ai.mbaozi.cn/v1，API 密钥填你的 sk-xxx。
模型名称填 deepseek-v4-flash-free（客户端会自动拉取可用模型列表的话，也可以直接下拉选择）。
保存后新建对话，即可开始使用。

🌐

OpenWebUI

开源网页版 AI 聊天界面，适合自部署团队使用。

接口类型 OpenAI API

API 地址 http://ai.mbaozi.cn/v1

API Key sk-你的密钥

以管理员登录 OpenWebUI，进入管理面板 → 设置 → 外部连接。
「OpenAI API」一栏：URL 填 http://ai.mbaozi.cn/v1，API Key 填你的 sk-xxx。
保存后刷新页面，即可选择 deepseek-v4-flash-free 使用。

💡 小提示

部分客户端会自动在地址后面补 /v1，如果你填了完整地址反而报错，就只填站点域名 http://ai.mbaozi.cn/（不带末尾的 v1）试试。用 Anthropic 原生模式接入时，地址填 http://ai.mbaozi.cn/（SDK 会自动拼 /v1/messages）。还有问题？看看文末的常见问题。

💻 开发者接入

接口支持 OpenAI 与 Anthropic 两种协议，均按透传方式转发——请求原样透传到上游渠道，响应原样返回，因此各种参数（temperature / max_tokens / stream / tools 等）与官方完全一致。

两种协议对应的入口地址与鉴权方式：

协议	入口	鉴权头
OpenAI	http://ai.mbaozi.cn/v1/chat/completions	`Authorization: Bearer sk-xxx`
Anthropic	http://ai.mbaozi.cn/v1/messages	`x-api-key: sk-xxx`

方式一：OpenAI Python SDK

安装官方 SDK：

pip install openai

最小示例（把 sk-你的密钥 换成你自己的 Key）：

# 示例：发送第一条消息

from openai import OpenAI

client = OpenAI(

    base_url="http://ai.mbaozi.cn/v1",

    api_key="sk-你的密钥",

)

resp = client.chat.completions.create(

    model="deepseek-v4-flash-free",

    messages=[{"role": "user", "content": "你好"}],

)

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

方式二：Anthropic Python SDK

安装官方 SDK：

pip install anthropic

最小示例：

# 示例：发送第一条消息（Anthropic 协议）

from anthropic import Anthropic

client = Anthropic(

    base_url="http://ai.mbaozi.cn/v1",

    api_key="sk-你的密钥",

)

resp = client.messages.create(

    model="deepseek-v4-flash-free",

    max_tokens=1024,

    messages=[{"role": "user", "content": "你好"}],

)

print(resp.content[0].text)

方式三：curl 命令行

发一条 OpenAI 协议对话请求：

curl http://ai.mbaozi.cn/v1/chat/completions \

  -H "Authorization: Bearer sk-你的密钥" \

  -H "Content-Type: application/json" \

  -d '{"model": "deepseek-v4-flash-free", "messages": [{"role": "user", "content": "你好"}]}'

发一条 Anthropic 协议对话请求：

curl http://ai.mbaozi.cn/v1/messages \

  -H "x-api-key: sk-你的密钥" \

  -H "Content-Type: application/json" \

  -H "anthropic-version: 2023-06-01" \

  -d '{"model": "deepseek-v4-flash-free", "max_tokens": 1024, "messages": [{"role": "user", "content": "你好"}]}'

查看当前可用的模型列表（OpenAI 风格，Bearer 鉴权）：

curl http://ai.mbaozi.cn/v1/models \

  -H "Authorization: Bearer sk-你的密钥"

查看模型列表（Anthropic 风格，x-api-key 鉴权）：

curl http://ai.mbaozi.cn/v1/models \

  -H "x-api-key: sk-你的密钥"

鉴权方式：OpenAI 协议用 Authorization: Bearer sk-xxx，Anthropic 协议用 x-api-key: sk-xxx，同一个 Key 两种方式都认。模型列表接口会按鉴权头自动返回对应协议风格的格式。想要流式输出？请求体里加 "stream": true 即可，响应以 SSE 原样流式返回。

🫘 计费说明

🆓

免费模型

额度内免费

按天/周/月免费额度，普通与订阅用户额度不同

🧮

按量计费

按 token 扣豆

输入/输出/缓存分开计费，用多少扣多少

🔢

按次计费

固定每次扣豆

每次调用固定扣 N 豆，不看用量

💰

余额在哪看

个人中心

右上角头像 → 个人中心查看豆子余额

费用怎么算？

不同模型采用不同计费方式（见模型支持表格）：

免费模型：在免费额度内调用不扣豆（如「普通用户每天 5K tokens」）；超额后可能被拒绝或按订阅额度继续免费。
按量模型：输入、输出、缓存分开计价，单位「豆 / 1K tokens」。一次请求费用 = 输入豆 + 输出豆 + 缓存豆。
按次模型：每次调用固定扣 N 豆，与用量无关。

关于扣豆：费用按实际用量累计到你的账户，累计满 1 豆才扣一次，不足 1 豆的部分会一直累积，达到 1 豆再扣。所以少量调用可能不会立即扣豆，余额会在累积后统一扣除，不会重复扣费。

tokens 可以理解为字数：1 个汉字约 0.5～1 个 token，1K tokens 大约等于几百字的中文对话。

余额不足（报 402）怎么办？

到个人中心查看豆子余额。
按页面提示充值豆子。
充好后重新发送刚才的请求即可，无需任何其他操作。

❓ 常见问题

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

API Key 出于安全考虑只完整显示一次，忘记后无法找回。去密钥中心把旧密钥删掉，再新建一个即可，过程不到半分钟。

🔑 报 401「无效的 API Key」是什么意思？

说明请求带的 Key 缺失或不正确。请检查：① 是不是完整复制了 sk- 开头的整串，有没有漏字符或多了空格；② 有没有把 Key 填到了错误的输入框；③ 密钥是否已被禁用或删除（去密钥中心看状态）。刚登录后首次使用，也可以先退出重新登录再试。

🔒 报 403「无权限」是什么意思？

网关本身一般不直接产生 403。如果你在客户端里看到 403，通常是这几个原因： ① 客户端或本地代理（VPN / 防火墙）拦截了请求，换网络或关掉代理再试； ② 使用的 API Key 已被禁用；③ 部分客户端对 OpenAI 兼容接口做了版本限制，升级客户端版本试试。

🫘 报 402「余额不足 / 扣费失败」是什么意思？

表示这次请求没能成功扣豆，常见原因有： ① 豆子余额不足——去个人中心充值后重新发送即可； ② 免费额度已用完——免费模型的免费 token/次数超限，需要等额度重置或切换付费模型； ③ 如果是「扣费状态未确认」，说明扣费网络波动，请求已放行但扣豆未确认，稍后查看余额是否已扣除，未扣可重试一次。

🤖 怎么切换模型？

在客户端对话页的模型下拉里直接选就行（列表来自上面「模型支持」里的可用模型）；写代码的话，把请求里的 model 参数换成目标模型名即可。可用模型以模型广场为准，如果下拉里没有某个模型，说明它当前未启用。

🚫 报 404「模型不存在」是什么意思？

说明你填写的模型名在当前网关里不存在或已下架。核对一下是否拼写正确，或者去模型广场看看当前实际有哪些模型可用。

⚠️ 报 502 / 503 是什么意思？

502 表示模型服务临时出错，稍等片刻重试即可； 503 表示登录状态异常，退出重新登录一般就能恢复。如果持续报错，请联系管理员。

报错速查表

状态码	含义	怎么办
401	Key 缺失或无效	检查 Key 是否完整、是否被禁用
402	扣费失败（余额不足）	个人中心充值后重试
403	无权限	检查 Key 状态、客户端/网络代理
404	模型不存在或不可用	核对模型名，以模型广场为准
502	上游渠道出错	稍后重试
503	服务/登录异常	退出重新登录