Sakrylle API

简体中文

English

简体中文

English

主题

LobeChat ​

简介 ​

LobeChat 是一个开源的多模型 AI 聊天 Web UI，由 LobeHub 维护，支持 Web、桌面（Tauri）、自托管 Docker 等多种部署方式，原生提供 OpenAI / Anthropic / Google 等多种服务商的「自定义端点」配置。Sakrylle API 兼容 OpenAI 协议，可作为其中一个自定义 OpenAI 提供商接入。

前置准备 ​

  1. 准备一个可用的 LobeChat 实例：可以使用官方在线版、自托管 Docker，或本地启动开发版。
  2. 在 https://ai1.sakrylle.com 创建账号并参考 API Keys 生成 sk-xxxxxxxxxxxxxxxx 密钥。
  3. 想好要启用的模型 ID（例如 gpt-5.6-sol、claude-haiku-4-5-20251001）。

配置步骤 ​

LobeChat 的中英文 UI 文案：「设置 / Settings」「AI 服务商 / AI Providers」「OpenAI」「API Key」「API 代理地址 / API Proxy Address」。

  1. 打开 LobeChat，点击右上角头像或左侧栏底部的「设置 (Settings)」。

  2. 在左侧分组里选择「AI 服务商 (AI Providers)」。

  3. 找到列表中的「OpenAI」并点击展开。

  4. 在「OpenAI」面板中按下表填写：

    字段填写值
    API Keysk-xxxxxxxxxxxxxxxx
    API 代理地址 (API Proxy Address / Base URL)https://api.sakrylle.com/v1
    使用客户端请求模式 (Client Mode)推荐保持开启，浏览器直连

  5. 在同一面板的「模型列表 (Model List)」处点击「获取模型列表 (Fetch Model List)」，等待请求完成；如果列表没有自动出现你想要的模型，点击「+ 自定义添加 (Add Custom Model)」，输入完整的模型 ID（如 gpt-5.6-sol、claude-haiku-4-5-20251001），保存。

  6. 在面板顶部打开「启用 (Enabled)」开关，确认 OpenAI 服务商已启用。

  7. 返回聊天页，点击对话顶部的模型选择器，将默认模型切换到刚刚添加的 Sakrylle 模型即可开始使用。

Tips：如果你已经在 LobeChat 内启用了多个服务商并希望命名更清晰，可以在 OpenAI 面板的「展示名 (Display Name)」处把它改名为 Sakrylle，方便在模型选择器里识别。

自托管：通过环境变量预置 ​

如果你使用 Docker / Vercel 自托管 LobeChat，可在部署时直接注入环境变量，避免每位用户重复填写：

bash
docker run -d -p 3210:3210 \
  -e OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxx \
  -e OPENAI_PROXY_URL=https://api.sakrylle.com/v1 \
  -e OPENAI_MODEL_LIST=+gpt-5.6-sol,+claude-haiku-4-5-20251001 \
  lobehub/lobe-chat

OPENAI_MODEL_LIST 使用 +模型ID 增加模型，更多语法见官方模型列表配置文档。

常见问题 ​

  • 模型列表为空：检查 https://api.sakrylle.com/v1/models 是否能返回数据；空列表通常意味着该 Key 还没有分配模型分组。
  • 401 / Invalid API Key：API Key 错误或停用，请回到控制台重新生成。
  • 流式输出卡顿或不出字：尝试关闭再打开 OpenAI 面板的「使用客户端请求模式」；自托管场景下确认反向代理（Nginx / Cloudflare）未缓冲 SSE，需要设置 proxy_buffering off。

官方文档 ​