API overview

Soriku exposes an OpenAI-compatible HTTP API plus a handful of Soriku-native endpoints. All endpoints live under `/api/`.

Base URL

Authentication

In local mode no auth is required. In Simezu mode pass a bearer token: Authorization: Bearer <token>. Tokens come from Simezu SSO.

Rate limits

Per-tenant rate limits returned in x-ratelimit-* response headers. Exceeded requests get HTTP 429.

Endpoint groups

• POST /v1/chat/completions — OpenAI-compatible chat
• GET /v1/models — list available models
• /v1/agents — agent persona CRUD
• /v1/keys — BYOK key management
• /v1/categories — capability categories
• POST /v1/voice — speech to text (Whisper)
• GET /v1/usage — token and cost usage
• POST /worker — plan-mode multi-agent execution
• GET /health — server status