docs / guides / add-remote-provider

Externe provider toevoegen

Breng je eigen keys voor Claude, OpenAI, Mistral, Groq of Gemini zodat de router ze mee kan nemen naast je lokale modellen.

Via de UI

Open http://localhost:8765 en ga naar Settings → Providers. Kies de provider, plak de key, save. De key wordt versleuteld in je lokale keystore op data/keystore.json en komt nooit in logs.

Via environment-variabelen

Voor headless setups (servers, CI), zet de keys in je omgeving. Soriku pikt ze op bij de volgende start.

export ANTHROPIC_API_KEY=sk-ant-...
export OPENAI_API_KEY=sk-...
export MISTRAL_API_KEY=...
export GROQ_API_KEY=...
export GEMINI_API_KEY=...
python server.py

Verifieer dat de provider geregistreerd is

curl -s http://localhost:8765/api/v1/models | jq '.data[].id'

Je zou provider-prefixed entries moeten zien zoals anthropic:claude-sonnet-4-6, openai:gpt-4o, mistral:large-latest.

Kostenplafonds per provider

Zet een dagbudget per provider zodat een experiment niet door je facturatie-alert heen brandt.

# config/models.yaml
providers:
anthropic:
daily_budget_usd: 5.00
openai:
daily_budget_usd: 2.00
Kostenplafonds zijn adviserend: wanneer het budget overschreden is stopt de router met die provider voor de rest van de dag. Het dwingt het plafond niet af op directe pinned-calls.