Sakrylle API

简体中文

English

简体中文

English

主题

NextChat ​

简介 ​

NextChat（原 ChatGPT-Next-Web）是一款轻量、跨平台的开源 AI 聊天前端，覆盖 Web、桌面（Tauri：Windows / macOS / Linux）、iOS、Android。它支持 OpenAI、Anthropic、Google 等协议，并允许在「设置」里覆盖默认的接口地址，因此可以非常方便地接入 Sakrylle API。

前置准备 ​

  1. 准备一个 NextChat 入口：可使用官方 NextChatAI、Vercel/Docker 自部署版本，或下载桌面/移动端 App。
  2. 在 https://ai1.sakrylle.com 创建账号并按 API Keys 指南生成 sk-xxxxxxxxxxxxxxxx。
  3. 准备模型 ID：例如 gpt-5.6-sol、claude-haiku-4-5-20251001。

在 UI 中临时覆盖 ​

如果你只是想用一台设备试用 Sakrylle API，可在 NextChat UI 内直接覆盖接口与 Key，无需重新部署：

  1. 打开 NextChat，点击左下角「设置 (Settings)」图标。

  2. 滚动到「自定义接口 (Custom Endpoint)」开关，将其打开。

  3. 模型服务商 (Model Provider) 选择 OpenAI。

  4. 按下表填写：

    字段填写值
    接口地址 (OpenAI Endpoint / API Host)https://api.sakrylle.com
    API Key (OpenAI API Key)sk-xxxxxxxxxxxxxxxx
    自定义模型名 (Custom Models)+gpt-5.6-sol,+claude-haiku-4-5-20251001

    说明：

    • 「接口地址」只填到根域名 https://api.sakrylle.com，NextChat 会自动拼接 /v1/chat/completions。
    • 「自定义模型名」用 +模型ID 把 Sakrylle 的模型加入选择列表，多个模型用英文逗号分隔；前缀 -all 可用来先清空原有列表（例如 -all,+gpt-5.6-sol）。

  5. 关闭设置面板，回到聊天界面，点击右上方模型选择器，把当前模型切换到 gpt-5.6-sol 或 claude-haiku-4-5-20251001。

  6. 发一条消息验证连通性。

想用 Anthropic 原生协议时，把「模型服务商」切到 Anthropic，「Anthropic API Endpoint」填 https://api.sakrylle.com，API Key 填同一个 Sakrylle 密钥；自定义模型名加 +claude-haiku-4-5-20251001 即可。

自部署环境变量 ​

如果你用 Vercel / Docker 自部署 NextChat 给团队使用，更推荐在部署时通过环境变量统一固定 Sakrylle 接入：

bash
docker run -d -p 3000:3000 \
  -e OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxx \
  -e BASE_URL=https://api.sakrylle.com \
  -e CUSTOM_MODELS="-all,+gpt-5.6-sol,+claude-haiku-4-5-20251001,+gpt-5.4,+claude-sonnet-4-6" \
  -e DEFAULT_MODEL=gpt-5.6-sol \
  -e CODE=set-a-strong-access-code \
  yidadaa/chatgpt-next-web

关键变量：

  • OPENAI_API_KEY：你的 Sakrylle API Key。
  • BASE_URL：Sakrylle 网关根地址 https://api.sakrylle.com。
  • CUSTOM_MODELS：用 -all 先清空默认模型，再用 + 追加你要暴露给前端的模型 ID。
  • DEFAULT_MODEL：进入会话时默认选中的模型。
  • CODE：访问密码，强烈建议设置 7 位以上密码，否则任何能访问该域名的人都能消耗你的额度。

变更后重新部署即可生效。

常见问题 ​

  • 模型选择器只剩一两个模型：CUSTOM_MODELS 里使用了 -all 但忘了把要用的模型 + 回来，重新检查变量值。
  • 请求一直 401：确认 BASE_URL 没有写成 https://api.sakrylle.com/v1（NextChat 会自动拼 /v1，重复会变成 /v1/v1/... 而出错），同时检查 API Key 有效性。
  • 流式输出卡死：自部署场景下检查反向代理是否缓冲了 SSE；Nginx 需要 proxy_buffering off; proxy_read_timeout 600s;。

官方文档 ​