白云 API 教程：Open WebUI 接入指南
配置步骤、适用前提与常见兼容问题。 附完整检查步骤、实操验证和错误处理。
Open WebUI 接入指南
使用前准备
在密钥管理单独创建此工具专用的调用密钥，确认账户已完善且 DK 余额足够。客户端版本会影响入口名称，本页按配置项说明；以当前版本实际界面为准。
配置步骤
以管理员进入后台设置的连接页面，添加 OpenAI API 连接，填写本站 Base URL 和密钥。保存后刷新模型列表；连接权限与用户可用模型由你自己的 Open WebUI 管理员设置。
| 配置项 | 填写内容 |
|---|---|
| Base URL | https://api.baiyun.si/v1 |
| API Key | 此客户端专用的调用密钥 |
| 模型示例 | gpt-6-luna |
| 普通聊天协议 | OpenAI Compatible Chat Completions |
| Codex 供应商协议 | Responses |
最小验证
先关闭联网搜索、图片、附件、知识库及自动执行工具，发送一句普通文本。核对客户端确实选用了本站供应商，再到用量日志查看本次模型与消费。客户端连通性按钮可能只检查模型列表，不能替代一次真实聊天。
常见问题
地址要求完整 endpoint 时，Chat 地址应为 https://api.baiyun.si/v1/chat/completions；要求 Base URL 时用表中地址。出现 /v1/v1 或重复 /chat/completions 时先改地址。401 核对密钥与生效供应商；429 停止并行测试后等待；404 核对协议和模型，不要将不支持的协议伪装成另一个模型。
能力与数据
本页提供配置指引，未对每个客户端版本完成真人全功能测试。自定义模型不保证享有客户端官方模型的补全、工具或订阅功能。第三方客户端可能上传会话或配置同步数据，使用前查看其隐私设置；不要公开导出含密钥的配置。
实操前的检查清单
- 准备自己的账户与调用密钥，不使用他人的共享凭据。
- 记录客户端版本、系统和准备使用的模型，便于排查时复现。
- 保存原配置或截图，隐藏密钥、验证码与私人内容。
- 确认测试可能消费少量 DK，先用一句话、一次请求开始。
- 查阅当前模型广场与状态页，再决定是否启用更多功能。
详细排查：按顺序缩小问题范围
先确认账户已完善、密钥有效、DK 余额足够，再核对协议、地址与模型。用同一密钥做一次最小文本请求；它成功以后，才逐项恢复附件、工具或自动重试。客户端配置保存后重新打开会话，避免旧会话仍使用先前供应商。
怎样确认本节已经学会
不要只检查「配置保存成功」提示。你应能说清当前 Base URL、密钥用途、选用模型和请求协议，能在相应控制台核对自己的操作结果。客户端教程以一次实际纯文本响应和对应日志为初步完成标准；账户教程以安全信息完善为标准；计费教程以本金、通道费与 DK 的对应关系核对为标准。
如果出现错误，记录发生时间、HTTP 状态、脱敏错误内容以及实际期待的结果。不要截图整页密钥，也不要把密码和验证码交给其他人。对 401 应先解决认证，对 400 应先解决参数，对 429 应停止密集重试，对 404 应核对请求路径与上游是否实现，不能用重新充值解决所有报错。
一个适合练习的小任务
在自己的测试环境完成本节的最小步骤，用文字记录「原来怎么设置、改了哪一项、看到了什么结果」。不把生产数据、真实付款或不可恢复的命令当练习。遇到超出本节的功能，先查看对应协议教程，再考虑添加功能；一次只变更一个配置，容易判断哪一步导致错误。
下一步与版本边界
返回完整学习地图 · API 站精简配置 · 本站实时状态。
教程于2026年10月9日整理。具体界面与能力可能随客户端和上游版本变化；配置指引不等于所有客户端版本已经实测通过。本站余额消费、QQ / 支付宝登录及已开放通路以实际页面为准；压缩接口此前的上游 404、生图尚无可用渠道等限制不要理解为配置文件能自动消除。