zh providers aihubmix
AIHubMix 是一个多模型 AI API 聚合平台，通过统一接口可调用 OpenAI、Claude、Gemini、DeepSeek、Kimi 等主流模型，同时支持语音、嵌入、重排序等多种能力。
API 格式完全兼容 OpenAI，只需修改 API Base 和 Key 即可接入。部分模型免费，可直接用于开发测试。
- 前往 AIHubMix 注册账号
- 登录后在控制台 → API Keys 页面创建一个新的 Key
进入 AstrBot 管理面板，点击左栏 模型提供商 → 对话 → 新增 → OpenAI Compatible。
填写以下信息：
| 配置项 | 值 |
|---|---|
| API Base URL | https://aihubmix.com/v1 |
| API Key | 你在 AIHubMix 获取的 Key |
填写提供商名称和 API Key，确认 API Base URL，点击「保存并获取模型」。在模型列表中点击所需模型右侧的 +，确认模型已启用；也可先「保存配置」，再通过「自定义模型」填写准确的模型 ID。点击已配置模型旁的「测试模型」按钮可检查是否可用。
以下模型完全免费，适合开发测试和轻量场景：
| 模型 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 地址及其他字段请按对应接口填写。
进入「配置文件」，选择要使用的配置文件，在「AI 配置」→「模型」中将「对话模型」设为刚添加的模型，点击右下角「保存配置」。此项用于 AstrBot 内置 AI。