Sakrylle API

English

简体中文

English

简体中文

Appearance

Open WebUI ​

Want the official Sakrylle-hosted web chat — no self-hosting, no API key needed? See Sakrylle Web — this page covers self-hosting Open WebUI and connecting it with your Sakrylle API key.

Open WebUI is a self-hosted web chat frontend that supports any OpenAI-compatible backend. Configure Sakrylle as an external Connection, and your team can share access from the browser.

Prerequisites ​

  1. Open WebUI deployed (Docker / pip install both work; see the official documentation)
  2. Logged in as an admin
  3. An API Key created in the Sakrylle Console

Configuration ​

1. Connections ​

  1. After logging in to Open WebUI, click the avatar at the top right → Admin Panel
  2. Top nav → Settings
  3. Left menu → Connections

2. Add OpenAI ​

  1. In the OpenAI API section, click + to add a new connection
  2. Fill in:
    • URL: https://api.sakrylle.com/v1
    • API Key: your Sakrylle key
    • Prefix ID (optional): we recommend sakrylle, which makes models appear in the dropdown as sakrylle.gpt-5.6-sol to avoid name collisions with other backends
  3. Model IDs / Filter: manually add the model names you want
    • gpt-5.6-sol
    • gpt-5.4
    • gpt-5.5
    • For Claude, add another Anthropic connection (see below)
  4. Click Save, or click the refresh icon next to the connection to test connectivity

Open WebUI calls GET /v1/models automatically to discover models; Sakrylle's /v1/models returns models configured in the Console, so in theory you don't need to add any manually. But some Open WebUI versions group by owned_by, so manually setting Model IDs filter can keep the list cleaner.

3. Add Anthropic ​

If you want to use the native Claude endpoint inside Open WebUI:

  1. On the same Connections page, add another entry
  2. URL: https://api.sakrylle.com/v1 (Open WebUI's OpenAI-compatible connection can also pass Claude models through, because Sakrylle's /v1/chat/completions backend routes to the Anthropic upstream)
  3. Model IDs: manually add claude-haiku-4-5-20251001, claude-sonnet-4-6, etc.

If your deployment also has a plugin / pipeline that supports the Anthropic native endpoint, configure https://api.sakrylle.com as the base URL according to the plugin's documentation, and use claude-* model names.

4. End-User Usage ​

Regular users, after logging in, can see entries like sakrylle.gpt-5.6-sol in the model dropdown at the top of the chat view; selecting one starts the conversation.

Permissions ​

Open WebUI's user management and Sakrylle's API Keys are two separate layers:

  • The entire Open WebUI instance shares one Sakrylle key for billing
  • To bill separate users individually, configure a separate Connection per user in Open WebUI (one Sakrylle key per user); per-user quotas are not enforced on the Sakrylle side

FAQ ​

  • Empty model dropdown after saving: check the URL spelling, ensure it has /v1; click Refresh to re-fetch the model list
  • 401 authentication failed: key is wrong or deleted; create a new one
  • Model ID missing from dropdown: in Connections, find your Sakrylle entry, add the model to the Model IDs filter, or leave the filter empty to let auto-discovery handle it
  • Streaming responses cut off: check that the reverse proxy (Nginx / Traefik) has proxy_buffering disabled and proxy_read_timeout long enough
  • 402 insufficient balance: top up in the Sakrylle Console