Soulter
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>
2.5 KiB
2.5 KiB
接入 AIHubMix
AIHubMix 是一个多模型 AI API 聚合平台，通过统一接口可调用 OpenAI、Claude、Gemini、DeepSeek、Kimi 等主流模型，同时支持语音、嵌入、重排序等多种能力。
API 格式完全兼容 OpenAI，只需修改 API Base 和 Key 即可接入。部分模型免费，可直接用于开发测试。
获取 API Key
- 前往 AIHubMix 注册账号
- 登录后在控制台 → 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 |
多模态 |
完整模型列表请查看 AIHubMix 文档。
不只是聊天模型
AIHubMix 同时支持以下能力，均可在 AstrBot 中配置：
| 能力 | AstrBot 配置位置 |
|---|---|
| 语音转文字 (STT) | 服务提供商 → 语音转文字 |
| 文字转语音 (TTS) | 服务提供商 → 文字转语音 |
| 嵌入 (Embedding) | 服务提供商 → 嵌入 |
| 重排序 (Rerank) | 服务提供商 → 重排序 |
所有能力使用同一个 API Key 和 API Base，无需额外配置。
设为默认
前往 配置 → 提供商设置，将「默认聊天模型提供商」改为刚创建的 AIHubMix 提供商，保存即可。