文档 · 接入指南

Open WebUI 接 TopxAI：一个 OpenAI 连接，全部模型

2026-09-19

在 Open WebUI 里把 https://ai.topxea.com/v1 加为 OpenAI API 连接；模型列表从 /v1/models 读取，所有文本模型直接可聊。

Open WebUI 把任何 OpenAI 兼容端点当作一个「OpenAI API 连接」，模型从 /v1/models 读取。一个连接就把 TopxAI 的全部文本模型接进来。

在管理面板里

1. Admin Panel 里的 Settings，再进 Connections。
2. 在 OpenAI API 下添加连接：地址 https://ai.topxea.com/v1，密钥 sk-...（自动路由的 TopxAI 密钥）。
3. 保存。模型选择器里现在列出密钥能调的模型。

用环境变量

Docker 部署时，同样两个值写成变量：

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

列出的是什么

/v1/models 返回密钥线路能提供的模型：自动路由下是全部文本模型加图像模型。Jev 只在 TypeSafe 线路的密钥下列出，而且不能在聊天窗口里用，它通过 /v1/systemone 回答带类型的问题，不是聊天。

图像

Open WebUI 的图像生成设置同样接受 OpenAI 兼容端点。用同一个地址和密钥，模型填 gpt-image-2.5-sunburst 或 gpt-image-2.5-flare；按张、按尺寸计费，见图像生成。

不通时

• 401：密钥错了，或粘贴时带了空格。402：余额为零。403：这个模型 ID 不在售，或不在这把密钥的线路上。详见常见错误响应。
• curl 能通、工具不通：这一页按工具列出常见原因。

模型：gpt-image-2.5-sunburst, gpt-image-2.5-flare · 模型与价格

相关

• 接入你的 SDK
• 创建 API 密钥并选择线路
• curl 能跑通，工具里却报错
• 常见错误响应
• LobeChat 接 TopxAI：OpenAI 代理地址
• Cherry Studio 接入 TopxAI：首次对话与端点设置
• 图片生成
• GPT Image 2.5 Sunburst API pricing
• GPT Image 2.5 Flare API pricing

上一页：opencode 接 TopxAI：opencode.json 里的自定义供应商 · 下一页：LobeChat 接 TopxAI：OpenAI 代理地址

其他语言：English