接入 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 提供商，保存即可。