Skip to content
This repository was archived by the owner on Mar 11, 2026. It is now read-only.

Commit bcc682f

Browse files
SoulterSoulter
committed
docs: enhance AIHubMix integration guide with detailed setup instructions and recommended models
1 parent b00d737 commit bcc682f

File tree

2 files changed

+125
-13
lines changed

2 files changed

+125
-13
lines changed

‎en/providers/aihubmix.md‎

Lines changed: 64 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,70 @@
1-
# AIHubMix
1+
# Connect AIHubMix
22

3-
AIHubMix provides a variety of models and convenient access methods, similar to OpenRouter. It offers ample daily free model calls, such as `gemini-3-flash-preview-free`, `gpt-4o-free`, `kimi-for-coding-free`, etc., making it suitable for individual developers and small project testing.
3+
[AIHubMix](https://aihubmix.com/?aff=4bfH) is a multi-model AI API gateway that provides unified access to OpenAI, Claude, Gemini, DeepSeek, Kimi and more through a single API key. Beyond LLM, it also supports speech, embedding, reranking and other capabilities.
44

5-
## Usage
5+
Fully compatible with the OpenAI API format — just change the API Base and Key to get started. **Some models are completely free for development and testing.**
66

7-
Click [this link](https://aihubmix.com/?aff=4bfH) to register an account.
7+
## Get an API Key
88

9-
After registration, click [this link](https://aihubmix.com/models) to select the model you want to access.
9+
1. Sign up at [AIHubMix](https://aihubmix.com/?aff=4bfH)
10+
2. Go to Console → API Keys to create a new key
1011

11-
## Integration
12+
![Get an API Key](https://github.com/user-attachments/assets/d717f21b-2805-4aff-ac90-f5c98f17cb79)
1213

13-
Open AstrBot WebUI -> Service Providers page, click "Add Provider", find and click `AIHubMix`, configure the API Key, select the model you want to access, and click "Save" to complete the setup.
14+
## Configure in AstrBot
15+
16+
Open the AstrBot dashboard , click **Providers → Add Provider → OpenAI**.
17+
18+
Fill in the following:
19+
20+
| Field | Value |
21+
|-------|-------|
22+
| API Base URL | `https://aihubmix.com/v1` |
23+
| API Key | Your AIHubMix key |
24+
25+
After saving, click the provider card to add models.
26+
27+
![Configure in AstrBot](https://github.com/user-attachments/assets/ee2fb8ba-652c-4e97-a781-42a9082ad7eb)
28+
29+
## Recommended Models
30+
31+
### Free Models 🆓
32+
33+
These models are completely free, great for development and testing:
34+
35+
| Model ID | Description |
36+
|----------|-------------|
37+
| `gpt-4.1-free` | GPT-4.1 free tier |
38+
| `gemini-3-flash-preview-free` | Gemini 3 Flash free tier |
39+
| `coding-glm-5-free` | GLM-5 coding model, free |
40+
| `coding-minimax-m2.5-free` | MiniMax M2.5 coding model, free |
41+
42+
### Paid Models (Popular)
43+
44+
| Model ID | Provider | Description |
45+
|----------|----------|-------------|
46+
| `gpt-5.4` | OpenAI | Latest flagship model |
47+
| `claude-sonnet-4-6` | Anthropic | Great for reasoning and code |
48+
| `gpt-5.3-chat-latest` | OpenAI | High-performance chat |
49+
| `deepseek-v3.2` | DeepSeek | Cost-effective |
50+
| `kimi-k2.5` | Moonshot | Long context |
51+
| `gemini-3.1-pro-preview` | Google | Multimodal |
52+
53+
> See the full model list at [AIHubMix Docs](https://doc.aihubmix.com).
54+
55+
## More Than Chat Models
56+
57+
AIHubMix also supports the following capabilities, all configurable in AstrBot:
58+
59+
| Capability | AstrBot Config Location |
60+
|------------|------------------------|
61+
| Speech-to-Text (STT) | Providers → Speech to Text |
62+
| Text-to-Speech (TTS) | Providers → Text to Speech |
63+
| Embedding | Providers → Embedding |
64+
| Reranking | Providers → Rerank |
65+
66+
All capabilities use the same API Key and API Base — no extra setup needed.
67+
68+
## Set as Default
69+
70+
Go to **Settings → Provider Settings**, set "Default Chat Model Provider" to your AIHubMix provider, and save.

‎zh/providers/aihubmix.md‎

Lines changed: 61 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,68 @@
11
# 接入 AIHubMix
22

3-
AIHuMix 是类似 OpenRouter 的第三方模型服务提供商，提供了丰富的模型选择和便捷的接入方式。并且提供充足的每日免费模型调用次数，如 `gemini-3-flash-preview-free`, `gpt-4o-free`, `kimi-for-coding-free` 等，适合个人开发者和小型项目测试使用。
3+
[AIHubMix](https://aihubmix.com/?aff=4bfH) 是一个多模型 AI API 聚合平台，通过统一接口可调用 OpenAI、Claude、Gemini、DeepSeek、Kimi 等主流模型，同时支持语音、嵌入、重排序等多种能力。
44

5-
## 使用
5+
API 格式完全兼容 OpenAI，只需修改 API Base 和 Key 即可接入。**部分模型免费，可直接用于开发测试。**
66

7-
点击[此链接](https://aihubmix.com/?aff=4bfH) 注册账户。
7+
## 获取 API Key
88

9-
注册完毕之后，点击[此链接](https://aihubmix.com/models)选择需要接入的模型。
9+
1. 前往 [AIHubMix](https://aihubmix.com/?aff=4bfH) 注册账号
10+
2. 登录后在控制台 → API Keys 页面创建一个新的 Key
11+
![获取 API Key](https://github.com/user-attachments/assets/d717f21b-2805-4aff-ac90-f5c98f17cb79)
1012

11-
## 接入
13+
## 在 AstrBot 中配置
1214

13-
打开 AstrBot WebUI -> 服务提供商页面，点击新增提供商，找到并点击 `AIHubMix`，配置 API Key 后，选择需要接入的模型，点击保存，即可完成创建。
15+
进入 AstrBot 管理面板，点击左栏 **服务提供商 → 新增提供商 → OpenAI**。
16+
17+
填写以下信息：
18+
19+
| 配置项 | 值 |
20+
|--------|-----|
21+
| API Base URL | `https://aihubmix.com/v1` |
22+
| API Key | 你在 AIHubMix 获取的 Key |
23+
24+
保存后，点击该 provider 卡片，添加你需要的模型。
25+
![在 AstrBot 中配置](https://github.com/user-attachments/assets/ee2fb8ba-652c-4e97-a781-42a9082ad7eb)
26+
27+
## 推荐模型
28+
29+
### 免费模型 🆓
30+
31+
以下模型完全免费，适合开发测试和轻量场景：
32+
33+
| 模型 ID | 说明 |
34+
|---------|------|
35+
| `gpt-4.1-free` | GPT-4.1 免费版 |
36+
| `gemini-3-flash-preview-free` | Gemini 3 Flash 免费版 |
37+
| `coding-glm-5-free` | GLM-5 代码模型免费版 |
38+
| `coding-minimax-m2.5-free` | MiniMax M2.5 代码模型免费版 |
39+
40+
### 付费模型（常用推荐）
41+
42+
| 模型 ID | 提供商 | 说明 |
43+
|---------|--------|------|
44+
| `gpt-5.4` | OpenAI | 最新旗舰模型 |
45+
| `claude-sonnet-4-6` | Anthropic | 擅长推理和代码 |
46+
| `gpt-5.3-chat-latest` | OpenAI | 高性能对话模型 |
47+
| `deepseek-v3.2` | DeepSeek | 高性价比 |
48+
| `kimi-k2.5` | Moonshot | 长上下文 |
49+
| `gemini-3.1-pro-preview` | Google | 多模态 |
50+
51+
> 完整模型列表请查看 [AIHubMix 文档](https://doc.aihubmix.com)。
52+
53+
## 不只是聊天模型
54+
55+
AIHubMix 同时支持以下能力，均可在 AstrBot 中配置：
56+
57+
| 能力 | AstrBot 配置位置 |
58+
|------|-----------------|
59+
| 语音转文字 (STT) | 服务提供商 → 语音转文字 |
60+
| 文字转语音 (TTS) | 服务提供商 → 文字转语音 |
61+
| 嵌入 (Embedding) | 服务提供商 → 嵌入 |
62+
| 重排序 (Rerank) | 服务提供商 → 重排序 |
63+
64+
所有能力使用同一个 API Key 和 API Base，无需额外配置。
65+
66+
## 设为默认
67+
68+
前往 **配置 → 提供商设置**，将「默认聊天模型提供商」改为刚创建的 AIHubMix 提供商，保存即可。

0 commit comments

Comments
 (0)