AIPUT 文档
工具接入

Open WebUI

在 Open WebUI 管理员设置中添加 AIPUT 连接。

更新于

模型调用暂未开放

本页内容用于接入准备。调用开放后,请使用你自己的可用 Key,并把示例中的模型占位值换成模型广场中实际开放的型号。

需要哪种接口

普通对话(OpenAI Chat Completions)。在模型广场的「端点类型」里选择 Chat。

开始之前

  1. 完成实名认证,认证通过后重新登录一次。
  2. 在主站「API 密钥」页面创建一把 Key,复制并妥善保存。
  3. 在模型广场的「端点类型」筛选里选择 Chat(窄屏时点“筛选”按钮),从列出的模型中复制模型 ID。

另外需要一个已经部署好的 Open WebUI,以及它的管理员账号。

共用实例时注意费用

在 Open WebUI 管理员设置里填入的 Key,会被这个实例里所有用户的对话共用,这些调用都从这把 Key 所属 AIPUT 账户的余额扣费。请只把实例开放给你信任的人。

配置步骤

打开连接设置

用管理员账号登录 Open WebUI,打开 Settings → Admin → Connections。

添加连接

在 Manage OpenAI API Connections 旁点击添加(Add Connection),填写:

  • URL:https://api.aiput.top/v1
  • API Key:你的 AIPUT Key

保存后,确认这条连接的开关处于打开状态。

确认模型

Open WebUI 会自动读取可用模型。没有显示想用的模型时,可以在连接设置中手动添加模型 ID。

怎样确认配置成功

新建一个对话,在模型选择器中选择 AIPUT 的模型,发一句简短的问题,能收到回复就说明配置成功。

常见问题

现象处理
保存连接时报错URL 应以 /v1 结尾;部署 Open WebUI 的服务器要能访问互联网上的 AIPUT 地址
模型列表为空确认 Key 正确、账户已完成实名认证;也可以手动添加模型 ID
对话时提示"无可用渠道"账户还没有实名认证、模型 ID 写错,或模型当前不可用,见常见问题

本页按 2026 年 10 月的 Open WebUI 版本编写,界面和配置项可能随版本变化,以 Open WebUI 官方说明为准。Open WebUI 的名称和商标归其所有者所有,这里只表示兼容。