# Återkommande gratiskvot

# Återkommande gratiskvot

Gratiskvoten är under införande och avstängd som standard. Tillgänglighet och
produktionsgränser är inte fastställda. När funktionen är aktiverad krävs ett
konto med verifierad e-post och en aktiv Porten-API-nyckel.

Välj **Free quota** i [Playground](/build/playground) och välj eller klistra in
nyckeln. Tryck **Refresh free quota** för återstående försök, återställningstid
och tillgängliga modeller för just nyckeln. Varje prompt i denna vy startar en
ny konversation. Svaret använder inte betalt saldo eller kampanjkredit. Funktionen
byter aldrig automatiskt till det vanliga API:t när kvoten är slut.

## API

Gratisvägens bas-URL är `https://porten.ai/free/v1`. Den vanliga bas-URL:en
`https://porten.ai/v1` behåller sin ordinarie prissättning och policy.

```bash
curl --fail-with-body https://porten.ai/free/v1/quota \
  -H "Authorization: Bearer $PORTEN_API_KEY"

curl --fail-with-body https://porten.ai/free/v1/models \
  -H "Authorization: Bearer $PORTEN_API_KEY"
```

Kvotsvaret innehåller `remaining`, `daily_limit`, `resets_at` (nästa UTC-dygn),
`max_text_bytes`, `max_messages`, `max_output_tokens` och `models`. Återstående
kontokvot garanterar inte ledig kapacitet eller återstående nätverks-/globalbudget.
Modellistan respekterar nyckelns modell-, region-, nodklass- och flottbegränsningar.

Välj ett modell-ID som finns i ditt aktuella kvotsvar. Exemplet nedan använder
Qwen; om modellen saknas ska anropet inte skickas.

```bash
curl --fail-with-body https://porten.ai/free/v1/chat/completions \
  -H "Authorization: Bearer $PORTEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"qwen2.5-0.5b-web","messages":[{"role":"user","content":"Säg hej på svenska."}],"max_tokens":128,"stream":false}'
```

API:t stöder JSON och SSE (`stream: true`), högst 256 svarstokens, 1 024 UTF-8-byte
sammanlagd meddelandetext och sju växlande user/assistant-meddelanden med user sist.
Ingen systemprompt, verktygsanvändning, bild eller valfri routingparameter stöds.
Servern begränsar exekvering till 30 sekunder. Gratisanrop startar inte warming
eller automatiskt hyrd kapacitet.

## När ett anrop stoppas

- **401:** nyckeln är ogiltig eller återkallad.
- **403:** verifiera e-post och kontrollera nyckelns modellbehörighet.
- **404:** funktionen är avstängd.
- **429:** konto-, nätverks-, global- eller samtidighetsgräns har nåtts. Vänta
  innan nytt försök; en återstående kontokvot utesluter inte andra gränser.
- **503:** ingen passande kapacitet, konfigurerad budget eller fungerande
  kvotlagring finns just nu.

Ett reserverat försök förbrukas även vid fel, timeout eller avbrott. Kontrollera
kvoten igen efter anropet; omförsök kan förbruka ytterligare försök. Skicka aldrig
automatiskt samma begäran till en betald endpoint vid kvotfel. Antals- och
tidsgränserna är arbetstak, inte en garanti om obegränsad gratis kapacitet.