Prerequisites
- Chatbox installed, or access to the Chatbox web or mobile app
- An AIOHub API key
- A group assigned to the API key that can access the Chat Completions model you want to use
- A positive account balance
Setup
1
Open model provider settings
Open Chatbox, click the settings entry in the sidebar, then open Model Provider.
2
Add a custom provider
Click Add or Add Custom Provider at the bottom of the provider list:
3
Enter API settings
Fill in the fields used by your Chatbox version:
If your Chatbox version labels the field as Base URL and expects
/v1 there, use https://api.aiohub.org/v1 and keep API Path as /chat/completions. Do not put /v1 in both fields.4
Add models
Add or enable the models you want to use:
Available models depend on the group assigned to your API key. Use the console model list and
/v1/models response as the source of truth.5
Check the connection
Save the provider, then click Check. If the check succeeds, return to the chat page and select the configured model.
6
Start chatting
Create a new conversation and send a short message. You can then open the AIOHub console Logs page to review the request and cost.
Recommended fields
Optional settings
- If automatic chat title generation creates extra requests, disable it in Chatbox settings or use a cheaper helper model.
- Vision, tool use, and image features depend on the Chatbox version, model capabilities, and the group assigned to the API key.
- If you only need basic text chat, verify that works before enabling advanced features.
Troubleshooting
Connection check fails
Connection check fails
Confirm the API key starts with
sk-, API Host includes https://, and API Path is /v1/chat/completions. If Host already includes /v1, use /chat/completions as the path.The request returns 404 or repeats path segments
The request returns 404 or repeats path segments
The usual cause is putting
/v1 in both API Host and API Path. The full AIOHub request URL should be https://api.aiohub.org/v1/chat/completions.Can Chatbox use Claude models through AIOHub?
Can Chatbox use Claude models through AIOHub?
Yes, when the model is available through the OpenAI Chat Completions-compatible path and visible to your API key. For native Claude Messages behavior, use a client with an Anthropic provider or Claude Cowork 3P.