Docs · Integrations

Open WebUI with TopxAI: one OpenAI connection, every model

2026-09-19

Add https://ai.topxea.com/v1 as an OpenAI API connection in Open WebUI; the model list fills from /v1/models and every text model is ready to chat.

Open WebUI treats any OpenAI-compatible endpoint as an "OpenAI API connection" and lists its models from /v1/models. One connection brings in every TopxAI text model.

In the admin panel

Admin Panel → Settings → Connections.
Under OpenAI API, add a connection: URL https://ai.topxea.com/v1, key sk-... (a TopxAI key on the Auto route).
Save. The model picker now lists the models your key can call.

With environment variables

For a Docker deployment, the same two values as variables:

docker run -d -p 3000:8080 \
  -e OPENAI_API_BASE_URL=https://ai.topxea.com/v1 \
  -e OPENAI_API_KEY=sk-... \
  -v open-webui:/app/backend/data \
  --name open-webui ghcr.io/open-webui/open-webui:main

What is listed

/v1/models returns the models the key's route can serve: on the Auto route, every text model and the image models. Jev is listed only for keys on the TypeSafe route and is not usable from a chat window, since it answers typed questions through /v1/systemone, not chat.

Images

Open WebUI's image generation setting also takes an OpenAI-compatible endpoint. Use the same URL and key and set the model to gpt-image-2.5-sunburst or gpt-image-2.5-flare; images bill per picture by size, as on the image generation page.

If it fails

401: the key is wrong or was pasted with a space. 402: the balance is empty. 403: the model id is not sold here or is not on this key's route. See Common error responses.
The model works in curl but not in the tool: that page lists the usual causes, one per tool.

Models: gpt-image-2.5-sunburst, gpt-image-2.5-flare · Models & pricing

Previous: opencode with TopxAI: a custom provider in opencode.json · Next: LobeChat with TopxAI: the OpenAI proxy address

Other languages: 简体中文