# Koszt każdego endpointu

**Przejrzystość to nasza przewaga.** DivineAPI, AstrologyAPI, Prokerala pobierają stałą opłatę 1 kredytu za wywołanie niezależnie od złożoności — i nie publikują szczegółowego rozliczenia. AstroWay pokazuje dokładny koszt każdego z {siteMeta.endpoints}+ endpointów.

<Aside type="tip">
**Jak czytać tabelę.** Wszystkie endpointy zostały podzielone na 3 sekcje według typu obciążenia: statyczne lookup (zasobniki cache’owane), obliczenia (mapy, synastria, prognozy) oraz ciężkie zadania / raporty PDF. Tier `½` to najtańszy (5 kredytów), Tier `8` to najdroższy (10 000 kredytów, zarezerwowany). Kolumna **Free** pokazuje dostępność w darmowym pakiecie: ✓ — dostępny, 🔒 — wymaga planu Indie+.
</Aside>

## Jak obliczany jest koszt wywołania

1. **Autoryzacja (middleware)** sprawdza `req.path` (np. `/chart`).
2. **Wyszukuje w pliku `endpoint-costs.ts`** dokładną wartość kredytów dla tej ścieżki.
3. **Jeśli nie znajdzie** — stosuje domyślną wartość (10 kredytów = Tier 1).
4. **Pobiera kredyty** z limitu planu klucza po udanej odpowiedzi (status 2xx).
5. **Nagłówki odpowiedzi** zawierają `X-Credits-Used` (pobrano), `X-Credits-Remaining`, `X-Credits-Limit`.

**Zniżki cache’owe:** przy `X-Cache: HIT` (5-minutowy cache idempotency) kredyty **nie są pobierane**. Dla endpointów AI (`/interpret/*`) obowiązuje 50% zniżka przy trafieniu w cache.

## Pełna tabela

<CreditsTable locale="uk" />

## Kontakt

Jeśli uważasz, że któryś endpoint został przypisany do niewłaściwego taryfu (np. w twoim scenariuszu zajmuje więcej lub mniej czasu) — napisz na [hello@astroway.info](mailto:hello@astroway.info) z rzeczywistymi statystykami (X-Request-Id z twoich logów). Regularnie przeglądamy podział na taryfy na podstawie telemetrii ze środowiska produkcyjnego.

## Powiązane

- [Kredyty i limity](/rate-limits-credits/) — model płatności, ograniczenia częstotliwości zapytań, co robić przy przekroczeniu limitu
- [Cennik](/pricing/) — miesięczne budżety kredytów w poszczególnych planach
- [OpenAPI 3.1](/v1/openapi.json) — pełny kontrakt API
