BYOK Dashboard Settings
This page maps dashboard fields to BYOK behavior. For concepts and engine tiers, see BYOK overview.
User settings path
Visible when you have User BYOK or User Pro premium.
Translation engine
| Engine | Key required |
|---|---|
| Self-hosted | No |
| Premium Groq (managed) | No (Pro tier) |
| Groq (your key) | Yes |
| OpenAI (your key) | Yes |
Per-engine fields
When a BYOK engine is selected:
- API key — paste once; stored encrypted. Use Clear key to remove.
- Model — provider model ID (e.g.
llama-3.3-70b-versatile,gpt-4o-mini) - Prompt template — system/user instructions with
{source_language},{target_language},{text} - Sampling parameters — see table below
- Protection delimiters — open/close wrappers for Discord syntax
Server configuration path
Dashboard → Server → Server Configuration (guild_general)
Same fields as user BYOK, scoped to the guild engine. All members benefit when the guild uses a BYOK or managed engine.
Sampling parameters reference
| Field | Valid range | Leave empty to… |
|---|---|---|
| Temperature | 0 – 2 | Use bot default |
| Top P | 0 – 1 | Use bot default |
| Max tokens | 1 – 128,000 | Use bot default |
| Frequency penalty | −2 – 2 | Use bot default |
| Presence penalty | −2 – 2 | Use bot default |
| Reasoning effort | low, medium, high | Omit (OpenAI only) |
The dashboard validates ranges before save. Invalid values show an inline error.
Protection delimiters
| Field | Rules |
|---|---|
| Open wrapper | 1–16 characters, no line breaks |
| Close wrapper | 1–16 characters, must differ from open |
Defaults: {{{{ and }}}}
Leave both empty to restore defaults.
Saving and applying
- Click Save on each section; watch for success toast
- Engine changes apply on the next translation
- Command redeploy is not required for BYOK changes
- Check Error Logs if translations revert to self-hosted after save
Audit trail
API key changes appear in Audit Logs as "API key updated" without exposing the secret.
Screenshot placeholder
Recommended dashboard captures:
- User Settings with Groq BYOK expanded (model + temperature visible)
- Server Configuration engine selector
- Delimiter fields with default values