mirror of
https://github.com/AstrBotDevs/AstrBot
synced 2026-07-20 02:55:08 +08:00
fc33b3eb68
* docs: transfer AstrBotDevs/AstrBot-docs to AstrBotDevs/AstrBot * refactor: reorder imports and improve type hints in sync_docs_to_wiki.py and upload_doc_images_to_r2.py * feat: add GitHub Actions workflow to sync wiki with documentation Co-authored-by: Soulter <37870767+Soulter@users.noreply.github.com> Co-authored-by: anka-afk <110004162+anka-afk@users.noreply.github.com> Co-authored-by: zouyonghe <62183434+zouyonghe@users.noreply.github.com> Co-authored-by: shuiping233 <49360196+shuiping233@users.noreply.github.com> Co-authored-by: LIghtJUNction <106986785+LIghtJUNction@users.noreply.github.com> Co-authored-by: Sjshi763 <179909421+Sjshi763@users.noreply.github.com> Co-authored-by: xiewoc <70128845+xiewoc@users.noreply.github.com> Co-authored-by: QingFeng-awa <151742581+QingFeng-awa@users.noreply.github.com> Co-authored-by: PaloMiku <96452465+PaloMiku@users.noreply.github.com> Co-authored-by: shangxueink <138397030+shangxueink@users.noreply.github.com> Co-authored-by: IGCrystal-A <244300990+IGCrystal-A@users.noreply.github.com> Co-authored-by: RC-CHN <67079377+RC-CHN@users.noreply.github.com> Co-authored-by: MC090610 <113341105+MC090610@users.noreply.github.com> Co-authored-by: Waterwzy <196913419+Waterwzy@users.noreply.github.com> Co-authored-by: Lanhuace-Wan <186303160+Lanhuace-Wan@users.noreply.github.com> Co-authored-by: LiAlH4qwq <61769640+LiAlH4qwq@users.noreply.github.com> Co-authored-by: HSOS6 <209910899+HSOS6@users.noreply.github.com> Co-authored-by: th-dd <162813557+th-dd@users.noreply.github.com> Co-authored-by: miaoxutao123 <81676466+miaoxutao123@users.noreply.github.com> Co-authored-by: nuomicici <143102889+nuomicici@users.noreply.github.com> Co-authored-by: nasyt233 <210103278+nasyt233@users.noreply.github.com> Co-authored-by: jlugjb <7426462+jlugjb@users.noreply.github.com> Co-authored-by: Raven95676 <176760093+Raven95676@users.noreply.github.com> Co-authored-by: Futureppo <180109455+Futureppo@users.noreply.github.com> Co-authored-by: MliKiowa <61873808+MliKiowa@users.noreply.github.com> Co-authored-by: Fridemn <150212937+Fridemn@users.noreply.github.com> Co-authored-by: BakaCookie520 <138355736+BakaCookie520@users.noreply.github.com> Co-authored-by: YumeYuka <125112916+YumeYuka@users.noreply.github.com> Co-authored-by: xming521 <32786500+xming521@users.noreply.github.com> Co-authored-by: ywh555hhh <121592812+ywh555hhh@users.noreply.github.com> Co-authored-by: stevessr <89645372+stevessr@users.noreply.github.com> Co-authored-by: roeseth <41995115+roeseth@users.noreply.github.com> Co-authored-by: ikun-1145141 <265925499+ikun-1145141@users.noreply.github.com> Co-authored-by: evpeople <54983536+evpeople@users.noreply.github.com> Co-authored-by: Yue-bin <60509781+Yue-bin@users.noreply.github.com> Co-authored-by: W1ndys <109416673+W1ndys@users.noreply.github.com> Co-authored-by: TheFurina <218887821+TheFurina@users.noreply.github.com> Co-authored-by: Seayon <12275933+Seayon@users.noreply.github.com> Co-authored-by: OnlyblackTea <38585636+OnlyblackTea@users.noreply.github.com> Co-authored-by: ocetars <74854972+ocetars@users.noreply.github.com> Co-authored-by: railgun19457 <117180744+railgun19457@users.noreply.github.com> Co-authored-by: JunieXD <107397009+JunieXD@users.noreply.github.com> Co-authored-by: advent259141 <197440256+advent259141@users.noreply.github.com> Co-authored-by: Doge2077 <91442300+Doge2077@users.noreply.github.com> Co-authored-by: Bocity <23430545+Bocity@users.noreply.github.com> Co-authored-by: Aurora-xk <192227833+Aurora-xk@users.noreply.github.com>
69 lines
2.5 KiB
Markdown
69 lines
2.5 KiB
Markdown
# 接入 AIHubMix
|
||
|
||
[AIHubMix](https://aihubmix.com/?aff=4bfH) 是一个多模型 AI API 聚合平台，通过统一接口可调用 OpenAI、Claude、Gemini、DeepSeek、Kimi 等主流模型，同时支持语音、嵌入、重排序等多种能力。
|
||
|
||
API 格式完全兼容 OpenAI，只需修改 API Base 和 Key 即可接入。**部分模型免费，可直接用于开发测试。**
|
||
|
||
## 获取 API Key
|
||
|
||
1. 前往 [AIHubMix](https://aihubmix.com/?aff=4bfH) 注册账号
|
||
2. 登录后在控制台 → API Keys 页面创建一个新的 Key
|
||
|
||
|
||
## 在 AstrBot 中配置
|
||
|
||
进入 AstrBot 管理面板，点击左栏 **服务提供商 → 新增提供商 → OpenAI**。
|
||
|
||
填写以下信息：
|
||
|
||
| 配置项 | 值 |
|
||
|--------|-----|
|
||
| API Base URL | `https://aihubmix.com/v1` |
|
||
| API Key | 你在 AIHubMix 获取的 Key |
|
||
|
||
保存后，点击该 provider 卡片，添加你需要的模型。
|
||
|
||
|
||
## 推荐模型
|
||
|
||
### 免费模型 🆓
|
||
|
||
以下模型完全免费，适合开发测试和轻量场景：
|
||
|
||
| 模型 ID | 说明 |
|
||
|---------|------|
|
||
| `gpt-4.1-free` | GPT-4.1 免费版 |
|
||
| `gemini-3-flash-preview-free` | Gemini 3 Flash 免费版 |
|
||
| `coding-glm-5-free` | GLM-5 代码模型免费版 |
|
||
| `coding-minimax-m2.5-free` | MiniMax M2.5 代码模型免费版 |
|
||
|
||
### 付费模型（常用推荐）
|
||
|
||
| 模型 ID | 提供商 | 说明 |
|
||
|---------|--------|------|
|
||
| `gpt-5.4` | OpenAI | 最新旗舰模型 |
|
||
| `claude-sonnet-4-6` | Anthropic | 擅长推理和代码 |
|
||
| `gpt-5.3-chat-latest` | OpenAI | 高性能对话模型 |
|
||
| `deepseek-v3.2` | DeepSeek | 高性价比 |
|
||
| `kimi-k2.5` | Moonshot | 长上下文 |
|
||
| `gemini-3.1-pro-preview` | Google | 多模态 |
|
||
|
||
> 完整模型列表请查看 [AIHubMix 文档](https://doc.aihubmix.com)。
|
||
|
||
## 不只是聊天模型
|
||
|
||
AIHubMix 同时支持以下能力，均可在 AstrBot 中配置：
|
||
|
||
| 能力 | AstrBot 配置位置 |
|
||
|------|-----------------|
|
||
| 语音转文字 (STT) | 服务提供商 → 语音转文字 |
|
||
| 文字转语音 (TTS) | 服务提供商 → 文字转语音 |
|
||
| 嵌入 (Embedding) | 服务提供商 → 嵌入 |
|
||
| 重排序 (Rerank) | 服务提供商 → 重排序 |
|
||
|
||
所有能力使用同一个 API Key 和 API Base，无需额外配置。
|
||
|
||
## 设为默认
|
||
|
||
前往 **配置 → 提供商设置**，将「默认聊天模型提供商」改为刚创建的 AIHubMix 提供商，保存即可。
|