API-dokumentation

Autentisering

Authorization: Bearer sk-st-your-key-here

Base URL

https://api.staik.se/v1

Chat Completions

curl https://api.staik.se/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-st-your-key" \
  -d '{
    "model": "gemma4:31b",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

Audio-transkribering

Transkribera ljud till text via KB-Whisper large — Kungliga bibliotekets svensk-tränade Whisper-modell (50 000 timmar svenskt tal). OpenAI-kompatibel — peka bara openai-SDK:n mot api.staik.se.

curl https://api.staik.se/v1/audio/transcriptions \
  -H "Authorization: Bearer sk-st-your-key" \
  -F file=@moten.mp3 \
  -F model=kb-whisper-large \
  -F language=sv

Python (OpenAI SDK drop-in):

from openai import OpenAI
client = OpenAI(api_key="sk-st-your-key", base_url="https://api.staik.se/v1")

with open("moten.mp3", "rb") as f:
    result = client.audio.transcriptions.create(
        model="kb-whisper-large",  # eller "whisper-1" — båda routar till KB-Whisper large
        file=f,
        language="sv",
    )
print(result.text)

Tokens-åtgång

Audio-transkribering debiteras 100 tokens per sekund ljud från samma tokenpool som chat-modellerna. Det betyder att 1 minut audio kostar 6 000 tokens och 1 timme ljud kostar 360 000 tokens.

Varje respons innehåller headers X-Audio-Duration-Seconds och X-Audio-Tokens-Charged så du kan följa användningen per anrop. Max filstorlek: 25 MB (≈ 30–45 min audio). Stödda format: mp3, wav, m4a, ogg, flac, webm, mp4. response_format: json (default), text eller verbose_json (med segments).

Modeller

Välj modell via model-fältet i din request. Varje modell kör på dedikerad GPU-hårdvara i Sverige.

Chat-modellerna använder Q4_K_M-kvantisering, stödjer streaming (SSE) och har 262K tokens kontextfönster (32K för qwen3.5:9b). qwen3.6:35b-a3b och gemma4:31b har inbyggd vision — skicka bilder via image_url i messages. bge-m3:latest är en embedding-modell som returnerar 1024-dimensionella vektorer (konfigurera t.ex. pgvector vector(1024)) och anropas via POST /v1/embeddings. kb-whisper-large är KB:s svensk-tränade Whisper-modell och anropas via POST /v1/audio/transcriptions.

Planer

Felkoder

Rate limit headers

Varje svar inkluderar headers som visar din aktuella tokenanvändning.