Chat AI pe o hartă reală

Un LLM obișnuit răspunde la o întrebare despre Saturn din memorie, despre semn. POST /v1/ai/chat răspunde din harta pe care tocmai am calculat-o: poziția, casa, aspectele cu orburi și ferestrele de tranzit pentru următoarea jumătate de an. Diferența se vede din primul răspuns: nu “Saturn în Capricorn înseamnă disciplină”, ci “Saturn în Capricorn 25.2° retrograd, casa 5, conjuncție cu Luna, orb 1.7°”.

Încearcă fără cheie

Demo-ul funcționează pe o singură hartă fixă, 5 întrebări de la o adresă pe zi, același system prompt ca la endpoint-ul plătit. Nu e nevoie de cheie.

Ce vede modelul

Demo-ul returnează câmpul context: acesta este tot blocul care a intrat în prompt. Iată-l, la data de 2 septembrie 2026, pentru harta din demo (tranzitele sunt recalculate la fiecare cerere, deci lista ferestrelor va fi alta mâine):

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

Blocul este prescurtat: versiunea completă are 12 planete și unghiuri, până la 20 de aspecte natale majore și până la 12 ferestre de tranzit. Același bloc este construit pentru endpoint-ul plătit din harta pe care o trimiți tu.

Ce datează și ce nu

System prompt-ul nostru permite numirea lunilor pentru tranzitele care apar în blocul de mai sus și interzice datarea unui eveniment. La întrebarea “când mă voi căsători” endpoint-ul răspunde așa (fragment dintr-un răspuns real din 2 septembrie 2026):

Saturn în tranzit formează o conjuncție cu Venus natală. Acest tranzit va fi activ timp de câteva luni: în septembrie, octombrie, noiembrie, decembrie 2026, precum și în ianuarie, februarie și martie 2027, atingând orbul cel mai strâns în martie 2027.

Datele de aici nu sunt inventate: este rândul transiting Saturn Conjunction natal Venus din blocul de context. O dată a căsătoriei nu există în răspuns și nici nu va exista.

Mențiune

Dacă construiești un produs în care tu răspunzi pentru răspuns, această limită lucrează în favoarea ta: o predicție datată a unui eveniment de la modelul altcuiva în interfața ta este riscul tău, nu al nostru. Ai nevoie de o fereastră exactă în loc de o lună: /v1/transit-calendar.

Persona

persona schimbă vocea, nu datele. Valoarea este o listă închisă, pentru că șirul din corpul cererii ajunge în system prompt.

persona	Vocea
astrologer	implicit, cum răspundea endpoint-ul înainte de apariția parametrului
plain	fără persona, salut și semnătură
coach	sprijin și ce să faci cu asta
teacher	numește tehnica și explică termenii

Întrebarea “Descrie-mi Saturnul într-un singur paragraf”, persona: "coach":

Saturnul tău se află în semnul Capricorn, care este propriul său domiciliu, și în plus este retrograd, aflându-se în casa a 5-a. Asta indică o dorință profund înrădăcinată de structură, disciplină și măiestrie, mai ales în domeniile legate de exprimarea de sine, creativitate, romantism și copii.

persona: "teacher":

În harta ta natală, Saturn se află în Capricorn 25.2° (R) în casa a 5-a. Saturn este planeta disciplinei, responsabilității, structurii și limitărilor; indică domeniile în care căutăm măiestria și ne confruntăm cu lecțiile vieții.

O persona necunoscută înseamnă 400 INVALID_INPUT cu lista valorilor permise, nu o valoare implicită tăcută.

Cerere și răspuns

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

Răspunsul:

{
  "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 este prescurtat aici, restul câmpurilor sunt așa cum sunt. model este furnizorul care a răspuns: lanțul se comută singur, iar numele lui apare în răspuns ca să vezi ai cui tokeni a numărat contul tău. Dacă modelul a atins plafonul de tokeni, răspunsul este tăiat la ultima propoziție încheiată și se adaugă truncated: true, în loc să se rupă în mijlocul unui cuvânt.

Harta este opțională

Fără chart este un chat astrologic obișnuit: nu există context, prețul e același. Cu chart răspunde despre o persoană anume. history de până la 10 replici o trimite clientul: nu există sesiuni la noi, deci fiecare replică este de sine stătătoare și poate fi mutată între procese.

Preț și limite

Prețul unei replici	100 de credite
Cheia ta de furnizor (BYOK)	5 credite pe replică, tokenii sunt ai tăi
Planul Free	apelează fără restricții de plan, în limita a 10 000 de credite pe lună
Cheile sandbox aw_test_*	402, pentru că sandbox-ul nu consumă credite, iar modelul consumă bani
Repetarea unui corp identic	din cache, x-cache: HIT, x-credits-used: 0
message	până la 2000 de caractere, history până la 10 replici
Limbi	21, parametrul language

Atenție

Streaming-ul nu există încă pe acest endpoint: răspunsul vine întreg. POST /v1/mcp/streaming returnează SSE, dar și el așteaptă răspunsul complet și îl taie pe propoziții, deci nu vei vedea primul token mai devreme.

Referința completă Schema cererii, coduri de eroare, exemple

Cheia ta de furnizor X-Provider, X-Provider-Key, 5 credite pe replică

Planuri Câte replici pe lună pe fiecare plan

Agenți AI și MCP Același chat ca instrument al agentului