# API локалізації контенту — астро-переклад на 20 мов

Переклад текстового контенту на **20 мов** через AI-gateway AstroWay з **астрологічним глосарієм**: спеціальні терміни (Dasha, Nakshatra, асцендент, старший аркан, число шляху життя) не калічаться буквальним перекладом, а зберігають канонічну форму цільової мови. Числові поля не торкаються.

## Як це працює

1. Ви надсилаєте текст + цільову мову (опційно — домен і мову-джерело; за замовчуванням джерело англійська)
2. API підтягує доменний глосарій для пари мов і будує system prompt
3. Текст іде в AI-gateway (Gemini → Groq → OpenRouter → …) з автоматичним failover
4. Відповідь — лише переклад; публічний ввід **не кешується**, ваш текст не зберігається

## Ендпоінти

| Ендпоінт | Метод | Кредити | Призначення |
|---|---|---|---|
| `/v1/translate/astro` | POST | `15 + ⌈символи/40⌉` | Переклад одного тексту (до 3000 символів) |
| `/v1/translate/batch` | POST | `15 + ⌈сума/40⌉` | До 25 рядків (≤2000 симв./рядок, ≤20000 разом) |
| `/v1/translate/languages` | GET | 0 | Список 20 підтримуваних мов |
| `/v1/translate/glossary/{lang}` | GET | 0 | Вивантажити глосарій для мови |

## Ціна

`credits = 15 + ⌈символи/40⌉` за виклик (батч рахується за сумою символів усіх рядків). Орієнтири: 60 символів ≈ 17 кредитів, 500 символів ≈ 28. Списується з кредитів вашого тарифу — окремого тарифу немає. У перерахунку ~4× дешевше за DeepL.

## Глосарій (astro-moat)

Доменний глосарій (Vedic / Western / Tarot / Numerology / HD / marketing) підставляє канонічний термін цільової мови замість дослівного перекладу: `Dasha`, `Nakshatra`, `Ascendant`, `Major Arcana`, `Life Path Number` тощо.

<Aside type="note">
Глосарій наразі покриває пари **uk / en → de**. Решта з 20 мов перекладається без глосарія (звичайний LLM-переклад). Покриття розширюється.
</Aside>

## Приклад

```bash
curl -X POST https://api.astroway.info/v1/translate/astro \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "text": "Mercury is retrograde in Gemini.", "target_lang": "de", "domain": "western" }'
# { "translated": "Merkur ist rückläufig in den Zwillingen.", "source_lang": "en",
#   "target_lang": "de", "domain": "western", "chars": 32, "credits": 16 }
```

Підтримувані мови: uk · en · de · pl · es · pt · hi · fr · ko · it · ja · id · tr · nl · cs · ro · vi · ar · el · hu.