Sakrylle API

简体中文

English

简体中文

English

主题

Open WebUI ​

想用 Sakrylle 官方托管、无需自己部署的 Web 应用？请见 Sakrylle Web——本页介绍的是自建 Open WebUI 并以 API Key 接入 Sakrylle 的用法。

Open WebUI 是一个自托管的 Web 聊天前端（前身 Ollama WebUI），支持任何 OpenAI 兼容的后端。把 Sakrylle 配成一个外部 Connection，团队就能在浏览器里共享使用。

前置准备 ​

  1. 已部署 Open WebUI（Docker / pip 安装均可，参考官方文档）
  2. 用管理员账户登录 Open WebUI
  3. 在 Sakrylle 控制台 创建一个 API Key

配置步骤 ​

1. 进入连接管理 ​

  1. 登录 Open WebUI 后，点击右上角头像 → 管理员面板（Admin Panel）
  2. 顶部导航 → 设置（Settings）
  3. 左侧菜单 → 连接（Connections）

2. 添加 OpenAI 兼容连接 ​

  1. 在 OpenAI API 区块点击 + 添加新连接
  2. 填写：
    • URL：https://api.sakrylle.com/v1
    • API 密钥（Key）：你的 Sakrylle Key
    • 前缀 ID（Prefix ID，可选）：建议填 sakrylle，可让模型在下拉里以 sakrylle.gpt-5.6-sol 形式区分，避免和其它后端重名
  3. 模型 ID（Model IDs / Filter）：手动添加你要用的模型名
    • gpt-5.6-sol
    • gpt-5.4
    • gpt-5.5
    • 需要 Claude 的话另开一个 Anthropic 连接（见下）
  4. 点击 保存 / 连接旁的刷新图标做连通性测试

Open WebUI 默认会调 GET /v1/models 自动发现模型；Sakrylle 的 /v1/models 返回的是控制台已配置的模型，所以理论上不用手动加。但有些 Open WebUI 版本会按 owned_by 分组，手动设置 Model IDs 过滤可以让列表更整洁。

3. Anthropic 连接 ​

如果你想在 Open WebUI 里同时用 Claude 原生接口：

  1. 同样的 Connections 页面再加一条
  2. URL：https://api.sakrylle.com/v1（Open WebUI 的 OpenAI 兼容连接也能透传 Claude 模型，因为 Sakrylle 的 /v1/chat/completions 后端会路由到 Anthropic 上游）
  3. 模型 ID：手动填 claude-haiku-4-5-20251001、claude-sonnet-4-6 等

如果你的部署里另外装了支持 Anthropic 原生 endpoint 的插件 / pipeline，按插件文档配置 https://api.sakrylle.com 作为 base，对应模型用 claude-* 名称。

4. 用户使用 ​

普通用户登录后，在聊天界面顶部模型下拉里能看到 sakrylle.gpt-5.6-sol 等条目，选中即可对话。

用户权限与配额 ​

Open WebUI 自身的用户管理与 Sakrylle 的 API Key 是两层概念：

  • 整个 Open WebUI 实例共用一个 Sakrylle Key 计费
  • 想给不同用户分别计费，需要在 Open WebUI 里给每个用户单独配 Connection（每人一个 Sakrylle Key），而不是在 Sakrylle 端做 per-user

常见问题 ​

  • 连接保存后模型下拉为空：检查 URL 有没有写错，是否带了 /v1；按 刷新 重新拉模型列表
  • 401 鉴权失败：Key 错或被删；新建一个替换
  • 模型 ID 不在下拉里：在 Connections 里找到你的 Sakrylle 条目，把模型加进 Model IDs 过滤，或留空让自动发现处理
  • 流式响应被截断：检查反向代理（Nginx / Traefik）的 proxy_buffering 是否关闭，proxy_read_timeout 是否够长
  • 402 余额不足：到 Sakrylle 控制台 充值