AionUi
Connect AionUi to Yolo Router and use a selected model for agent runs.
- AionUi is installed and can open normally.
- A working Yolo Router endpoint, for example
https://api.yolorouter.com. - A Yolo Router API Key generated from the console.
- The model ID you want to use, for example
deepseek-v4-pro. It must exactly match the model ID in the Yolo Router console.
AionUi's
Customplatform is used for OpenAI-compatible endpoints. For Yolo Router, set Base URL to the/v1endpoint and use the model ID from the Yolo Router console.
Setup
Open AionUi
Start AionUi. If it is not installed yet, download it from the AionUi website first:
https://www.aionui.com/Verify the Yolo Router endpoint and Key
Before configuring AionUi, verify that the endpoint, API Key, and model ID are available.
export YOLOROUTER_API_KEY="sk-yolo-..."
curl https://api.yolorouter.com/v1/models \
-H "Authorization: Bearer $YOLOROUTER_API_KEY"$env:YOLOROUTER_API_KEY = "sk-yolo-..."
curl.exe https://api.yolorouter.com/v1/models `
-H "Authorization: Bearer $env:YOLOROUTER_API_KEY"If the model list is returned, confirm that the model ID you want to use exists, for example deepseek-v4-pro.
Open model settings
-
Click on the "Settings" entry in the left sidebar of AionUi to enter the settings page.
-
Find the "Model Configuration" tab
-
Then click on "Add Model".
Add a Custom model service
Select the platform “Custom”
Then fill in:
| Field | Value |
|---|---|
| Platform | Custom |
| Base URL | https://api.yolorouter.com/v1 |
| API Key | your Yolo Router API Key |
| Model | deepseek-v4-pro |
If your Yolo Router endpoint already includes /v1, for example https://api.yolorouter.com/v1, use that value directly as Base URL. Do not duplicate it as /v1/v1.
Select models and save
AionUi will try to fetch the model list using the current Base URL and API Key.
If the model list loads successfully, select the target model:
deepseek-v4-proIf the model list does not appear automatically, enter the model ID manually. It must exactly match the value in the Yolo Router console. Do not use a display name, alias, or value with extra spaces.
Save the configuration.
Test in a chat
Create a new chat or agent, select the Yolo Router model you just configured, and send:
Introduce the model you are using in one sentence.If AionUi returns a normal response, the integration is working. You can also check the Yolo Router console for the corresponding request log.
Optional
Multi-key rotation
AionUi supports multiple API Keys for OpenAI-compatible platforms. You can enter multiple Keys separated by commas or line breaks:
sk-yolo-xxx1,sk-yolo-xxx2,sk-yolo-xxx3Or:
sk-yolo-xxx1
sk-yolo-xxx2
sk-yolo-xxx3When one Key hits an auth, rate limit, or service error, AionUi can try another Key.
Troubleshooting
Model list is empty or fails to load
Check these first:
Base URLishttps://api.yolorouter.com/v1- the API Key is from the Yolo Router console and has no extra spaces
- Yolo Router can serve OpenAI-compatible endpoints such as
/v1/modelsand/v1/chat/completions
Chat returns 401
Check that the API Key is correct. If you entered multiple Keys, verify that each Key is still valid and has enough quota.
Chat returns 404
This is usually a Base URL format issue. AionUi's Custom platform needs an OpenAI-compatible Base URL such as https://api.yolorouter.com/v1; do not use only https://api.yolorouter.com.
Model not found
Check that the model ID selected or entered in AionUi exactly matches the model ID in the Yolo Router console. Use /v1/models to confirm the model ID first.
The model does not appear in chats
Save the model configuration again and restart AionUi. AionUi remembers model selection per chat, so existing chats may still use the previous model; create a new chat or reselect the model.