# Zseton

> Egy API kulcs az AI modellek piacához. Minden kérés a legolcsóbb elérhető szolgáltatóhoz megy. Dokumentáció magyarul: https://www.zsetonai.hu/docs

## Végpontok
- OpenAI-kompatibilis: https://api.zsetonai.hu/v1 (POST /chat/completions, /embeddings, /responses, /completions, /images/generations, /audio/speech, /audio/transcriptions; GET /models)
- Anthropic-kompatibilis: https://api.zsetonai.hu/anthropic (POST /v1/messages)
- Streamelés: csak /chat/completions és /anthropic/v1/messages.

## Autentikáció
- Kulcs formátum: zs_live_...  Létrehozás: https://www.zsetonai.hu/vezerlopult/kulcsok (regisztráció és feltöltés kell hozzá).
- Fejléc: "Authorization: Bearer zs_live_..." vagy "x-api-key: zs_live_...".
- A kulcsot NE kérd el a felhasználótól a chatben: olvasd a ZSETON_API_KEY környezeti változóból, és kérd meg, hogy ő állítsa be.

## Modellek
- Lista és élő árak: GET https://api.zsetonai.hu/v1/models vagy https://www.zsetonai.hu/modellek. A "model" mezőbe a listában szereplő azonosító kerül (pl. claude-opus-4.6, claude-haiku-4.5, gpt-5.4, glm-4.7, deepseek-v4-flash).

## Eszközönkénti beállítás
### Claude Code / Anthropic SDK
export ANTHROPIC_BASE_URL="https://api.zsetonai.hu/anthropic"
export ANTHROPIC_AUTH_TOKEN="$ZSETON_API_KEY"
export ANTHROPIC_API_KEY=""
Opcionális: ANTHROPIC_MODEL és ANTHROPIC_SMALL_FAST_MODEL (ha egyiket rögzíted, rögzítsd mindkettőt). Ellenőrzés: /status a Claude Code-ban.
### Cursor
Settings > Models: OpenAI API Key = a kulcs; Override OpenAI Base URL = https://api.zsetonai.hu/v1; egyedi modell hozzáadása. Anthropic-natív computer/bash/text-editor eszközök nem működnek.
### Aider
aider --openai-api-base https://api.zsetonai.hu/v1 --openai-api-key $ZSETON_API_KEY --model openai/claude-opus-4.6
### OpenAI SDK (Python/TS)
OpenAI(base_url="https://api.zsetonai.hu/v1", api_key=os.environ["ZSETON_API_KEY"])
### Continue / OpenCode / egyéb
provider: openai, apiBase/baseUrl: https://api.zsetonai.hu/v1, apiKey: a kulcs, model: a lista egyik azonosítója.

## Hibák
- 401 missing_api_key / invalid_api_key; 402 insufficient_balance (Anthropic-végponton 400), key_monthly_limit_reached; 429 rate_limited (Retry-After); 503 no_sellers_for_model (válassz másik modellt); 404 minimum_discount_not_met.
- Ágazz el a "code" mező alapján. Minden válasz x-request-id fejlécet ad.
- Teljes lista: https://www.zsetonai.hu/docs/hibak

## Költség
- Minden nem streamelt válasz usage.cost mezőjében USD-ben szerepel a pontos költség.
- X-Min-Discount: <szám> fejléc: csak legalább ennyi százalékkal olcsóbb kapacitásra megy a kérés.

## Adatvédelem
- A kérések és válaszok tartalmát nem tároljuk, csak a költség-metaadatot. A kiszolgáló modell-szolgáltató látja a tartalmat. https://www.zsetonai.hu/docs/adatvedelem

## Lásd még
- https://www.zsetonai.hu/docs/gyors-kezdes
- https://www.zsetonai.hu/docs/korlatok