# Stellaforge — API постерів натальної карти (друкована якість)

Stellaforge — це **готовий до друку постер натальної карти**: один виклик `POST /v1/reports/stellaforge` повертає високодеталізований A4-постер. Жодного AI — повністю детермінований рендер на Swiss Ephemeris, придатний для друку на замовлення.

## Що на постері

- **Колесо професійної якості** — кольорові сектори стихій, кольорові гліфи знаків, градусні підписи планет і куспідів, стрілка ASC, маркер MC, римські/арабські номери домів, лінії аспектів із товщиною за орбом
- **Велика трійка** — Сонце · Місяць · Асцендент
- **Таблиця планет** — знак + градус + дім
- **Баланс стихій і модальностей** — смужки Fire/Earth/Air/Water + Cardinal/Fixed/Mutable
- **Ключові аспекти** — найвпливовіші, з гліфами

## 3 стилі

| `style` | Опис |
|---|---|
| `editorial` | Світлий, кремовий папір + пастельні сектори (типово) |
| `celestial` | Темно-синій + золото — преміальний бутиковий вигляд |
| `classic` | Мінімалістичний чорно-білий, арабські номери, пунктирні куспіди |

## Ендпоінт

| Ендпоінт | Метод | Кредити | Призначення |
|---|---|---|---|
| `/v1/reports/stellaforge` | POST | Tier 7 | Постер натальної карти — **PDF** (типово) або **HTML** (`?format=html`) |

## Приклад

```bash
curl -X POST https://api.astroway.info/v1/reports/stellaforge \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "chart": { "name": "Ada Lovelace", "date": "1815-12-10",
        "time": "18:00:00", "city": "London" },
        "style": "celestial", "language": "uk" }'
# → { "url": "https://api.astroway.info/reports/…-stellaforge.pdf", "page_count": 1, "expires_at": "…" }
# (?format=html повертає HTML напряму)
```

Підтримує **white-label** (логотип/кольори/шрифт) для ключів, прив'язаних до акаунта, і **багатомовність** через `language`.

<Aside type="note">
`style` читається з **тіла запиту**, а не з query-string. Постер повністю детермінований (0 AI) — однаковий вхід дає байт-ідентичний результат, що важливо для друкованого тиражу.
</Aside>