Czat AI na prawdziwym horoskopie

Zwykły LLM odpowiada na pytanie o Saturna z pamięci o znaku. POST /v1/ai/chat odpowiada na podstawie horoskopu, który właśnie policzyliśmy: pozycja, dom, aspekty z orbami i okna tranzytowe na najbliższe pół roku. Różnicę widać od pierwszej odpowiedzi: nie “Saturn w Koziorożcu oznacza dyscyplinę”, tylko “Saturn w Koziorożcu 25.2° retrogradacyjny, 5 dom, koniunkcja z Księżycem orb 1.7°”.

Wypróbuj bez klucza

Demo działa na jednym stałym horoskopie, 5 pytań z jednego adresu na dobę, ten sam prompt systemowy co w płatnym endpoincie. Klucz nie jest potrzebny.

Co widzi model

Demo zwraca pole context: to cały blok, który trafił do promptu. Oto on według stanu na 2 września 2026 dla horoskopu z demo (tranzyty są przeliczane przy każdym żądaniu, więc jutro lista okien będzie inna):

## 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 jest skrócony: w pełnej wersji jest 12 planet i osi, do 20 głównych aspektów urodzeniowych i do 12 okien tranzytowych. Ten sam blok jest składany dla płatnego endpointu z horoskopu, który wysyłasz Ty.

Co datuje, a czego nie

Nasz prompt systemowy pozwala nazywać miesiące dla tranzytów, które są w bloku wyżej, i zabrania datowania wydarzenia. Na pytanie “kiedy wyjdę za mąż” endpoint odpowiada tak (fragment prawdziwej odpowiedzi z 2 września 2026):

Tranzytujący Saturn tworzy koniunkcję z Twoją urodzeniową Wenus. Ten tranzyt będzie aktywny przez kilka miesięcy: we wrześniu, październiku, listopadzie, grudniu 2026 roku, a także w styczniu, lutym i marcu 2027 roku, osiągając najciaśniejszy orb w marcu 2027 roku.

Daty nie są tu zmyślone: to wiersz transiting Saturn Conjunction natal Venus z bloku kontekstu. Daty ślubu w odpowiedzi nie ma i nie będzie.

Notatka

Jeśli budujesz produkt, w którym za odpowiedź odpowiadasz Ty, ta granica działa na Twoją korzyść: datowana przepowiednia wydarzenia od cudzego modelu w Twoim interfejsie to Twoje ryzyko, nie nasze. Potrzebujesz dokładnego okna zamiast miesiąca: /v1/transit-calendar.

Persony

persona przełącza głos, a nie dane. Wartość to zamknięta lista, bo ciąg z body żądania trafia do promptu systemowego.

persona	Głos
astrologer	domyślnie, tak jak endpoint odpowiadał przed pojawieniem się parametru
plain	bez persony, powitania i podpisu
coach	wsparcie i to, co z tym zrobić
teacher	nazywa technikę i wyjaśnia terminy

Pytanie “Opisz mojego Saturna w jednym akapicie”, persona: "coach":

Twój Saturn znajduje się w znaku Koziorożca, który jest jego własnym domem, a do tego jest retrogradacyjny i położony w 5. domu. Wskazuje to na głęboko zakorzenione dążenie do struktury, dyscypliny i mistrzostwa, zwłaszcza w sferach związanych z wyrażaniem siebie, twórczością, romansem i dziećmi.

persona: "teacher":

W Twoim horoskopie urodzeniowym Saturn znajduje się w Koziorożcu 25.2° (R) w 5. domu. Saturn to planeta dyscypliny, odpowiedzialności, struktury i ograniczeń; wskazuje sfery, w których dążymy do mistrzostwa i mierzymy się z lekcjami życiowymi.

Nieznana persona to 400 INVALID_INPUT z listą dozwolonych wartości, a nie cichy domyślny wybór.

Żądanie i odpowiedź

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

Odpowiedź:

{
  "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 jest tu skrócone, pozostałe pola bez zmian. model to dostawca, który odpowiedział: łańcuch przełącza się sam, a jego nazwa jest w odpowiedzi, żebyś widział, czyje tokeny zostały policzone. Jeśli model uderzył w sufit tokenów, odpowiedź jest przycinana do ostatniego zakończonego zdania i dodawane jest truncated: true, zamiast urywać się w pół słowa.

Horoskop jest opcjonalny

Bez chart to zwykły czat astrologiczny: kontekstu nie ma, cena ta sama. Z chart odpowiada o konkretnej osobie. history do 10 tur wysyła klient: po naszej stronie nie ma sesji, więc każda tura jest samowystarczalna i można ją przenosić między procesami.

Cena i limity

Cena tury	100 kredytów
Własny klucz dostawcy (BYOK)	5 kredytów za turę, tokeny Twoje
Plan Free	wywołuje bez ograniczeń planu, w ramach 10 000 kredytów miesięcznie
Klucze sandbox aw_test_*	402, bo piaskownica nie zużywa kredytów, a model zużywa pieniądze
Powtórzenie identycznego body	z cache, x-cache: HIT, x-credits-used: 0
message	do 2000 znaków, history do 10 tur
Języki	21, parametr language

Uwaga

Streamingu na tym endpoincie na razie nie ma: odpowiedź przychodzi w całości. POST /v1/mcp/streaming zwraca SSE, ale też czeka na pełną odpowiedź i tnie ją na zdania, więc pierwszego tokenu wcześniej nie zobaczysz.

Pełna dokumentacja Schemat żądania, kody błędów, przykłady

Własny klucz dostawcy X-Provider, X-Provider-Key, 5 kredytów za turę

Cennik Ile tur miesięcznie na każdym planie

Agenci AI i MCP Ten sam czat jako narzędzie agenta