AI chat nad skutečným horoskopem

Běžné LLM odpovídá na otázku o Saturnu z paměti o znamení. POST /v1/ai/chat odpovídá z horoskopu, který jsme právě spočítali: pozice, dům, aspekty s orby a tranzitní okna na nejbližšího půl roku. Rozdíl je vidět hned z první odpovědi: ne “Saturn v Kozorohu znamená disciplínu”, ale “Saturn v Kozorohu 25.2° retrográdní, 5. dům, konjunkce s Měsícem orb 1.7°”.

Vyzkoušej bez klíče

Demo běží nad jedním pevným horoskopem, 5 otázek z jedné adresy za den, se stejným systémovým promptem jako placený endpoint. Klíč není potřeba.

Co model vidí

Demo vrací pole context: to je celý blok, který šel do promptu. Tady je ve stavu k 2. září 2026 pro horoskop z dema (tranzity se přepočítávají při každém požadavku, takže seznam oken bude zítra jiný):

## Natal Chart
- Sun: Taurus 24.4°, house 9
- Moon: Capricorn 26.9°, house 5
- Saturn: Capricorn 25.2° (R), house 5
- Ascendant: Virgo 20.0°
- Midheaven: Gemini 17.1°

Aspects (computed, use these instead of deriving your own):
- Sun Trine Saturn, orb 0.9°, applying
- Moon Conjunction Saturn, orb 1.7°
- Venus Square Neptune, orb 1.6°

## Transits, computed. Today is 2026-09-02; sampled monthly to 2027-03-01
(These are the only windows that exist. Report a month, not a day.)
- transiting Saturn Conjunction natal Venus: in orb on 2026-09-02, 2026-10-01, 2026-11-01, 2026-12-01, 2027-01-01, 2027-02-01, 2027-03-01 (closest 2027-03-01, orb 0.3°)
- transiting Jupiter Square natal Sun: in orb on 2026-10-01, 2026-11-01, 2026-12-01, 2027-01-01, 2027-02-01, 2027-03-01 (closest 2026-11-01, orb 0.0°)

Blok je zkrácený: plná verze má 12 planet a úhlů, až 20 hlavních natálních aspektů a až 12 tranzitních oken. Stejný blok se pro placený endpoint sestaví z horoskopu, který pošleš ty.

Co datuje a co ne

Náš systémový prompt dovoluje jmenovat měsíce pro tranzity, které jsou v bloku výše, a zakazuje datovat událost. Na otázku “kdy se vdám” endpoint odpovídá takto (úryvek skutečné odpovědi z 2. září 2026):

Tranzitní Saturn tvoří konjunkci s Vaší natální Venuší. Tento tranzit bude aktivní po několik měsíců: v září, říjnu, listopadu a prosinci 2026 a také v lednu, únoru a březnu 2027, přičemž nejtěsnějšího orbu dosáhne v březnu 2027.

Data tu nejsou vymyšlená: je to řádek transiting Saturn Conjunction natal Venus z bloku kontextu. Datum svatby v odpovědi není a nebude.

Poznámka

Pokud stavíš produkt, ve kterém za odpověď odpovídáš ty, pracuje tahle hranice pro tebe: datovaná předpověď události od cizího modelu v tvém rozhraní je tvoje riziko, ne naše. Potřebuješ přesné okno místo měsíce: /v1/transit-calendar.

Persony

persona přepíná hlas, ne data. Hodnota je uzavřený výčet, protože řetězec z těla požadavku se dostává do systémového promptu.

persona	Hlas
astrologer	výchozí, jak endpoint odpovídal před zavedením parametru
plain	bez persony, pozdravu a podpisu
coach	podpora a co s tím dělat
teacher	pojmenuje techniku a vysvětluje termíny

Otázka “Popiš můj Saturn jedním odstavcem”, persona: "coach":

Váš Saturn je ve znamení Kozoroha, které je jeho vlastním domovem, a navíc je retrográdní a nachází se v 5. domě. To ukazuje na hluboce zakořeněnou touhu po struktuře, disciplíně a mistrovství, zejména v oblastech spojených se sebevyjádřením, tvořivostí, romantikou a dětmi.

persona: "teacher":

Ve vašem natálním horoskopu je Saturn v Kozorohu 25.2° (R) v 5. domě. Saturn je planeta disciplíny, odpovědnosti, struktury a omezení; ukazuje oblasti, kde usilujeme o mistrovství a setkáváme se s životními lekcemi.

Neznámá persona znamená 400 INVALID_INPUT s výčtem povolených hodnot, ne tichý default.

Požadavek a odpověď

cURL

curl -X POST https://api.astroway.info/v1/ai/chat \
  -H "X-Api-Key: aw_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Що означає моє положення Сатурна?",
    "chart": {
      "date": "1990-05-15",
      "time": "14:30:00",
      "timezoneOffset": 3,
      "latitude": 50.45,
      "longitude": 30.52
    },
    "persona": "plain",
    "language": "uk"
  }'

Node.js

const r = await fetch('https://api.astroway.info/v1/ai/chat', {
  method: 'POST',
  headers: {
    'X-Api-Key': process.env.ASTROWAY_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    message: 'Що означає моє положення Сатурна?',
    chart: { date: '1990-05-15', time: '14:30:00', timezoneOffset: 3, latitude: 50.45, longitude: 30.52 },
    persona: 'plain',
    language: 'uk',
  }),
});
const { data } = await r.json();
console.log(data.reply);

Python

import os, requests

r = requests.post(
    'https://api.astroway.info/v1/ai/chat',
    headers={'X-Api-Key': os.environ['ASTROWAY_API_KEY'], 'Content-Type': 'application/json'},
    json={
        'message': 'Що означає моє положення Сатурна?',
        'chart': {'date': '1990-05-15', 'time': '14:30:00', 'timezoneOffset': 3, 'latitude': 50.45, 'longitude': 30.52},
        'persona': 'plain',
        'language': 'uk',
    },
)
data = r.json()['data']
print(data['reply'])

PHP

<?php
use GuzzleHttp\Client;

$aw = new Client(['base_uri' => 'https://api.astroway.info/v1/']);
$r = $aw->post('ai/chat', [
    'headers' => ['X-Api-Key' => getenv('ASTROWAY_API_KEY')],
    'json' => [
        'message' => 'Що означає моє положення Сатурна?',
        'chart' => ['date' => '1990-05-15', 'time' => '14:30:00', 'timezoneOffset' => 3, 'latitude' => 50.45, 'longitude' => 30.52],
        'persona' => 'plain',
        'language' => 'uk',
    ],
]);
$data = json_decode($r->getBody(), true)['data'];
echo $data['reply'];

Odpověď:

{
  "ok": true,
  "data": {
    "reply": "Ваш Сатурн знаходиться у знаку Козерога, у 5 домі, і є ретроградним.\n\n**Сатурн у Козерозі** означає, що Сатурн перебуває у своєму домі, де його енергії найсильніші. […] **Місяць у поєднанні з Сатурном (орб 1.7°)**: Це поєднання в Козерозі, у 5 домі, посилює серйозність ваших емоцій та потребу в безпеці.",
    "disclaimer": "Цей текст згенерований ШІ для розваги та саморефлексії. Не є медичною, юридичною чи фінансовою порадою.",
    "model": "gemini-2.5-flash",
    "language": "uk",
    "tokens": { "input": 1822, "output": 758 },
    "duration_ms": 6806,
    "persona": "plain"
  }
}

reply je tu zkrácený, ostatní pole jsou beze změny. model je poskytovatel, který odpověděl: řetězec se přepíná sám a jeho název je v odpovědi, abys viděl, čí tokeny se ti započítaly. Pokud model narazil na strop tokenů, odpověď se ořízne k poslední dokončené větě a přidá se truncated: true, místo aby se utrhla uprostřed slova.

Horoskop je nepovinný

Bez chart je to obyčejný astrologický chat: kontext chybí, cena je stejná. S chart odpovídá o konkrétním člověku. history až do 10 tahů posílá klient: relace na naší straně nejsou, takže každý tah je soběstačný a dá se přenést mezi procesy.

Cena a limity

Cena tahu	100 kreditů
Vlastní klíč poskytovatele (BYOK)	5 kreditů za tah, tokeny jsou tvoje
Tarif Free	volá bez omezení tarifu, v rámci 10 000 kreditů měsíčně
Sandbox klíče aw_test_*	402, protože pískoviště nespotřebovává kredity, ale model stojí peníze
Opakování identického těla	z cache, x-cache: HIT, x-credits-used: 0
message	až 2000 znaků, history až 10 tahů
Jazyky	21, parametr language

Upozornění

Streaming na tomto endpointu zatím není: odpověď přichází celá. POST /v1/mcp/streaming vrací SSE, ale také čeká na úplnou odpověď a dělí ji po větách, takže první token dřív neuvidíš.

Úplná reference Schéma požadavku, chybové kódy, příklady

Vlastní klíč poskytovatele X-Provider, X-Provider-Key, 5 kreditů za tah

Tarify Kolik tahů měsíčně na každém plánu

AI agenti a MCP Tentýž chat jako nástroj agenta