# Custo de cada endpoint

**Transparência — o nosso fosso.** DivineAPI, AstrologyAPI, Prokerala cobram um crédito fixo por chamada independentemente da complexidade — e não publicam uma divisão detalhada. AstroWay mostra o custo exato de cada um dos {siteMeta.endpoints}+ endpoints.

<Aside type="tip">
**Como ler a tabela.** Todos os endpoints estão divididos em 3 secções por tipo de carga: *lookups* estáticos (guias em cache), cálculos (mapas, sinastria, previsões) e tarefas pesadas / relatórios em PDF. O Tier `½` é o mais barato (5 créditos), o Tier `8` é o mais caro (10 000 créditos, reservado). A coluna **Free** indica a disponibilidade no plano gratuito: ✓ — disponível, 🔒 — requer Indie+.
</Aside>

## Como é calculado o custo de uma chamada

1. O **middleware de autenticação** verifica o `req.path` (por exemplo, `/chart`).
2. **Procura em `endpoint-costs.ts`** o valor exato de créditos para esse caminho.
3. **Se não existir**, recorre ao valor DEFAULT (10 créditos = Tier 1).
4. **Débita os créditos** dos limites do plano da chave após uma resposta bem-sucedida (código 2xx).
5. Os **cabeçalhos da resposta** incluem `X-Credits-Used` (créditos debitados), `X-Credits-Remaining` e `X-Credits-Limit`.

**Descontos por cache:** quando `X-Cache: HIT` (cache de idempotência de 5 minutos), os créditos **não são debitados**. Para endpoints de IA (`/interpret/*`), há um desconto de 50% no *cache hit*.

## Tabela completa

<CreditsTable locale="uk" />

## Feedback

Se achares que algum endpoint está mal atribuído a um tier (por exemplo, no teu cenário consome mais ou menos tempo) — envia um e-mail para [hello@astroway.info](mailto:hello@astroway.info) com estatísticas reais (X-Request-Id dos teus logs). Analisamos regularmente a distribuição dos tiers com base em telemetria de produção.

## Relacionado

- [Créditos e limites](/rate-limits-credits/) — modelo de pagamento, limites de taxa de pedidos, o que fazer em caso de excedente
- [Preços](/pricing/) — orçamentos mensais de créditos por plano
- [OpenAPI 3.1](/v1/openapi.json) — contrato completo da API