Open WebUI OpenAI-Compatible API Setup
Step 1: Preparation
Before you start, prepare your TaoDock API key, sufficient account quota and an exact model ID from the model catalog. See the quick start if this is your first integration.
You need permission to manage connections in Open WebUI.
- Open Settings → Admin → Connections.
- Add an OpenAI connection with URL
https://taodock.com/v1. - Enter your TaoDock API key and save.
- Verify the connection and fetch the model list, then select an available chat model.
- Return to chat and send a short test message.
If models do not appear automatically, add their full TaoDock IDs to the connection's Model IDs. See the Open WebUI connection guide for the current interface.
Verify a real request
Select a model under the TaoDock connection and send a short test message. Confirm that a normal response arrives and that a matching request appears in TaoDock request logs. Loading a model list verifies model discovery; sending a message may consume quota.
For Agent workflows, also follow the file tool verification. A normal text reply alone does not establish tool support.
Troubleshooting
| Symptom | What to check |
|---|---|
| HTML response or 404 | Use the API domain, check protocol selection and avoid duplicated version or endpoint paths |
| 401 or invalid key | Copy your complete, active TaoDock API key |
| Missing or unavailable model | Copy the exact model ID and check key restrictions and the selected group |
| Insufficient quota | Check both the account balance and API key quota |
| Chat works but tools fail | Verify the protocol, model capability and the application's tool permissions |
Return to all client integration guides or see the FAQ for more help.