mirror of
https://github.com/AstrBotDevs/AstrBot
synced 2026-07-17 09:50:31 +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>
71 lines
2.5 KiB
Markdown
71 lines
2.5 KiB
Markdown
# Connect AIHubMix
|
|
|
|
[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.
|
|
|
|
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.**
|
|
|
|
## Get an API Key
|
|
|
|
1. Sign up at [AIHubMix](https://aihubmix.com/?aff=4bfH)
|
|
2. Go to Console → API Keys to create a new key
|
|
|
|
|
|
|
|
## Configure in AstrBot
|
|
|
|
Open the AstrBot dashboard , click **Providers → Add Provider → OpenAI**.
|
|
|
|
Fill in the following:
|
|
|
|
| Field | Value |
|
|
|-------|-------|
|
|
| API Base URL | `https://aihubmix.com/v1` |
|
|
| API Key | Your AIHubMix key |
|
|
|
|
After saving, click the provider card to add models.
|
|
|
|
|
|
|
|
## Recommended Models
|
|
|
|
### Free Models 🆓
|
|
|
|
These models are completely free, great for development and testing:
|
|
|
|
| Model ID | Description |
|
|
|----------|-------------|
|
|
| `gpt-4.1-free` | GPT-4.1 free tier |
|
|
| `gemini-3-flash-preview-free` | Gemini 3 Flash free tier |
|
|
| `coding-glm-5-free` | GLM-5 coding model, free |
|
|
| `coding-minimax-m2.5-free` | MiniMax M2.5 coding model, free |
|
|
|
|
### Paid Models (Popular)
|
|
|
|
| Model ID | Provider | Description |
|
|
|----------|----------|-------------|
|
|
| `gpt-5.4` | OpenAI | Latest flagship model |
|
|
| `claude-sonnet-4-6` | Anthropic | Great for reasoning and code |
|
|
| `gpt-5.3-chat-latest` | OpenAI | High-performance chat |
|
|
| `deepseek-v3.2` | DeepSeek | Cost-effective |
|
|
| `kimi-k2.5` | Moonshot | Long context |
|
|
| `gemini-3.1-pro-preview` | Google | Multimodal |
|
|
|
|
> See the full model list at [AIHubMix Docs](https://doc.aihubmix.com).
|
|
|
|
## More Than Chat Models
|
|
|
|
AIHubMix also supports the following capabilities, all configurable in AstrBot:
|
|
|
|
| Capability | AstrBot Config Location |
|
|
|------------|------------------------|
|
|
| Speech-to-Text (STT) | Providers → Speech to Text |
|
|
| Text-to-Speech (TTS) | Providers → Text to Speech |
|
|
| Embedding | Providers → Embedding |
|
|
| Reranking | Providers → Rerank |
|
|
|
|
All capabilities use the same API Key and API Base — no extra setup needed.
|
|
|
|
## Set as Default
|
|
|
|
Go to **Settings → Provider Settings**, set "Default Chat Model Provider" to your AIHubMix provider, and save.
|