# Zseton

> Jeden klucz API do katalogu modeli AI, w cenie poniżej cennika. Dokumentacja po polsku: https://www.zsetonai.hu/pl/docs

## Końcówki
- Zgodne z OpenAI: https://api.zsetonai.hu/v1 (POST /chat/completions, /embeddings, /responses, /completions, /images/generations, /audio/speech, /audio/transcriptions; GET /models)
- Zgodne z Anthropic: https://api.zsetonai.hu/anthropic (POST /v1/messages)
- Strumień: tylko /chat/completions i /anthropic/v1/messages.

## Uwierzytelnianie
- Format klucza: zs_live_...  Tworzenie: https://www.zsetonai.hu/pl/vezerlopult/kulcsok (konto i doładowanie).
- Nagłówek: "Authorization: Bearer zs_live_..." albo "x-api-key: zs_live_...".
- NIE proś o klucz na czacie. Czytaj ZSETON_API_KEY ze środowiska i poproś użytkownika, żeby sam go ustawił.

## Modele
- Lista i żywe ceny: GET https://api.zsetonai.hu/v1/models albo https://www.zsetonai.hu/pl/modellek. Pole "model" to identyfikator z listy (np. claude-opus-4.6, claude-haiku-4.5, gpt-5.4, glm-4.7, deepseek-v4-flash). Około 100 modeli, poniżej ceny katalogowej, jeden klucz.

## Konfiguracja per narzędzie
### Claude Code / Anthropic SDK (około 2 minut)
export ANTHROPIC_BASE_URL="https://api.zsetonai.hu/anthropic"
export ANTHROPIC_AUTH_TOKEN="$ZSETON_API_KEY"
export ANTHROPIC_API_KEY=""
Opcjonalnie: ANTHROPIC_MODEL i ANTHROPIC_SMALL_FAST_MODEL (jeśli ustawiasz jeden, ustaw oba). Sprawdzenie: /status w Claude Code.
### Cursor (około 2 minut)
Settings > Models: OpenAI API Key = klucz; Override OpenAI Base URL = https://api.zsetonai.hu/v1; dodaj model jako custom. Natywne narzędzia Anthropic computer/bash/text-editor nie działają.
### 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 / inne
provider: openai, apiBase/baseUrl: https://api.zsetonai.hu/v1, apiKey: klucz, model: identyfikator z listy.

## Błędy
- 401 missing_api_key / invalid_api_key; 402 insufficient_balance (na końcówce Anthropic: 400), key_monthly_limit_reached; 429 rate_limited (Retry-After); 503 no_sellers_for_model; 404 minimum_discount_not_met.
- Rozgałęziaj po polu "code", nie po tekście komunikatu. Każda odpowiedź ma nagłówek x-request-id.
- Pełna lista: https://www.zsetonai.hu/pl/docs/hibak

## Koszt
- Dokładny koszt w USD jest w usage.cost każdej odpowiedzi bez strumienia.
- Nagłówek X-Min-Discount: <liczba> — żądanie idzie tylko na pojemność tańszą o co najmniej tyle procent.

## Prywatność
- Nie zapisujemy treści żądań ani odpowiedzi, tylko metadane kosztu. Dostawca modelu, który obsłużył żądanie, widzi treść. https://www.zsetonai.hu/pl/docs/adatvedelem

## Zobacz też
- https://www.zsetonai.hu/pl/docs/gyors-kezdes
- https://www.zsetonai.hu/pl/docs/agentek
- https://www.zsetonai.hu/pl/docs/korlatok