AI-chat valódi képleten

Egy átlagos LLM a Szaturnuszra vonatkozó kérdésre a jegyről szóló emlékeiből válaszol. A POST /v1/ai/chat abból a képletből válaszol, amelyet épp most számoltunk ki: pozíció, ház, fényszögek orbisszal és a következő fél év tranzitablakai. A különbség már az első válaszból látszik: nem az, hogy “a Szaturnusz a Bakban fegyelmet jelent”, hanem az, hogy “Szaturnusz a Bak 25.2°-án, retrográd, 5. ház, együttállás a Holddal 1.7°-os orbisszal”.

Próbáld ki kulcs nélkül

A demó egyetlen rögzített képleten fut, címenként naponta 5 kérdéssel, ugyanazzal a rendszerprompttal, mint a fizetős endpoint. Kulcs nem kell.

Mit lát a modell

A demó visszaadja a context mezőt: ez a teljes blokk, amely a promptba került. Íme, ahogy 2026. szeptember 2-án kinézett a demó képletére (a tranzitokat minden kérésnél újraszámoljuk, így az ablakok listája holnap más lesz):

## 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°)

A blokk rövidítve van: a teljes változatban 12 bolygó és tengely, legfeljebb 20 fő születési fényszög és legfeljebb 12 tranzitablak szerepel. A fizetős endpointnál ugyanez a blokk abból a képletből áll össze, amelyet te küldesz.

Mit datál, és mit nem

A rendszerpromptunk megengedi, hogy a fenti blokkban szereplő tranzitokhoz hónapokat nevezzen meg, és megtiltja, hogy eseményt datáljon. A “mikor megyek férjhez” kérdésre az endpoint így válaszol (részlet egy valódi, 2026. szeptember 2-i válaszból):

A tranzitáló Szaturnusz együttállást alkot a születési Vénuszoddal. Ez a tranzit több hónapon át aktív lesz: 2026 szeptemberében, októberében, novemberében és decemberében, valamint 2027 januárjában, februárjában és márciusában, a legszorosabb orbisszal 2027 márciusában.

A dátumok itt nem kitaláltak: ez a kontextusblokk transiting Saturn Conjunction natal Venus sora. Házassági dátum a válaszban nincs, és nem is lesz.

Megjegyzés

Ha olyan terméket építesz, amelyben te felelsz a válaszért, ez a határ neked dolgozik: egy idegen modell datált eseményjóslata a te felületeden a te kockázatod, nem a miénk. Ha hónap helyett pontos ablak kell: /v1/transit-calendar.

Personák

A persona a hangot váltja, nem az adatokat. Az értékek zárt listából jönnek, mert a kérés törzséből származó szöveg a rendszerpromptba kerül.

persona	Hang
astrologer	alapértelmezett, ahogy az endpoint a paraméter megjelenése előtt válaszolt
plain	persona, köszönés és aláírás nélkül
coach	támogatás, és hogy mit kezdj ezzel
teacher	megnevezi a technikát, és elmagyarázza a fogalmakat

A kérdés: “Írd le a Szaturnuszomat egy bekezdésben”, persona: "coach":

A Szaturnuszod a Bak jegyében áll, ami a saját otthona, ráadásul retrográd, és az 5. házban helyezkedik el. Ez mélyen gyökerező törekvést jelez a struktúra, a fegyelem és a mesteri tudás felé, különösen az önkifejezéssel, a kreativitással, a romantikával és a gyerekekkel kapcsolatos területeken.

persona: "teacher":

A születési képletedben a Szaturnusz a Bak 25.2°-án (R) áll, az 5. házban. A Szaturnusz a fegyelem, a felelősség, a struktúra és a korlátok bolygója; azokra a területekre mutat, ahol mesteri tudásra törekszünk, és ahol az élet leckéivel szembesülünk.

Az ismeretlen persona 400 INVALID_INPUT a megengedett értékek listájával, nem pedig csendes alapértelmezés.

Kérés és válasz

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'];

Válasz:

{
  "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"
  }
}

A reply itt rövidítve van, a többi mező változatlan. A model az a szolgáltató, amelyik válaszolt: a lánc magától vált, és a neve azért szerepel a válaszban, hogy lásd, kinek a tokenjeit számolta el a számlád. Ha a modell elérte a tokenplafont, a válasz az utolsó befejezett mondatnál le van vágva, és truncated: true kerül mellé, nem szakad meg egy szó közepén.

A képlet nem kötelező

chart nélkül ez egy szokásos asztrológiai chat: nincs kontextus, az ár ugyanaz. chart megadásával egy konkrét emberről válaszol. A legfeljebb 10 körös history-t a kliens küldi: nálunk nincsenek munkamenetek, így minden kör önálló, és áthelyezhető folyamatok között.

Ár és limitek

Egy kör ára	100 kredit
Saját szolgáltatói kulcs (BYOK)	5 kredit körönként, a tokenek a tieid
Free csomag	csomagkorlátozás nélkül hívható, havi 10 000 krediten belül
aw_test_* sandbox-kulcsok	402, mert a homokozó nem költ kreditet, a modell viszont pénzt költ
Azonos törzs ismétlése	gyorsítótárból, x-cache: HIT, x-credits-used: 0
message	legfeljebb 2000 karakter, history legfeljebb 10 kör
Nyelvek	21, a language paraméterrel

Figyelem

Ezen az endpointon egyelőre nincs streaming: a válasz egyben érkezik. A POST /v1/mcp/streaming SSE-t ad, de szintén megvárja a teljes választ, és mondatokra vágja, így az első tokent sem látod korábban.

Teljes referencia Kérésséma, hibakódok, példák

Saját szolgáltatói kulcs X-Provider, X-Provider-Key, 5 kredit körönként

Csomagok Havonta hány kör fér bele az egyes csomagokba

AI-ügynökök és MCP Ugyanez a chat ügynökeszközként