API overzicht

Soriku exposeert een OpenAI-compatible HTTP API plus een handvol Soriku-eigen endpoints. Alle endpoints leven onder `/api/`.

Base URL

Authenticatie

In local mode is geen auth vereist. In Simezu-mode geef je een bearer token mee: Authorization: Bearer <token>. Tokens komen van Simezu SSO.

Rate limits

Per-tenant rate limits teruggegeven in x-ratelimit-* response-headers. Overschrijdingen krijgen HTTP 429.

Endpoint-groepen

• POST /v1/chat/completions — OpenAI-compatible chat
• GET /v1/models — lijst beschikbare modellen
• /v1/agents — agent persona CRUD
• /v1/keys — BYOK key management
• /v1/categories — capability-categorieën
• POST /v1/voice — speech to text (Whisper)
• GET /v1/usage — token- en kostengebruik
• POST /worker — plan-mode multi-agent executie
• GET /health — server-status