AI-chat op een echte horoscoop

Een gewone LLM beantwoordt een vraag over Saturnus uit wat hij zich over het teken herinnert. POST /v1/ai/chat antwoordt vanuit de horoscoop die we net hebben berekend: positie, huis, aspecten met orben en transitvensters voor het komende halve jaar. Het verschil zie je vanaf het eerste antwoord: niet “Saturnus in Steenbok betekent discipline”, maar “Saturnus in Steenbok 25.2° retrograde, 5e huis, conjunctie met de Maan orb 1.7°”.

Probeer het zonder sleutel

De demo werkt op één vaste horoscoop, 5 vragen per adres per dag, met dezelfde systeemprompt als het betaalde endpoint. Een sleutel is niet nodig.

Wat het model ziet

De demo geeft het veld context terug: dat is het hele blok dat in de prompt is gegaan. Zo zag het eruit op 2 september 2026 voor de horoscoop uit de demo (transits worden bij elk verzoek opnieuw berekend, dus de lijst met vensters is morgen anders):

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

Het blok is ingekort: de volledige versie heeft 12 planeten en hoeken, tot 20 majeure natale aspecten en tot 12 transitvensters. Voor het betaalde endpoint wordt hetzelfde blok samengesteld uit de horoscoop die jij meestuurt.

Wat het dateert en wat niet

Onze systeemprompt staat toe dat er maanden worden genoemd voor transits die in het blok hierboven staan, en verbiedt het dateren van een gebeurtenis. Op de vraag “wanneer ga ik trouwen” antwoordt het endpoint zo (fragment van een echt antwoord van 2 september 2026):

De transiterende Saturnus vormt een conjunctie met je natale Venus. Deze transit is enkele maanden actief: in september, oktober, november en december 2026, en ook in januari, februari en maart 2027, met de nauwste orb in maart 2027.

De data zijn hier niet verzonnen: het is de regel transiting Saturn Conjunction natal Venus uit het contextblok. Een trouwdatum staat niet in het antwoord en zal er ook niet in komen.

Opmerking

Bouw je een product waarin jij verantwoordelijk bent voor het antwoord, dan werkt deze grens in je voordeel: een gedateerde voorspelling van een gebeurtenis door andermans model in jouw interface is jouw risico, niet het onze. Heb je een exact venster nodig in plaats van een maand: /v1/transit-calendar.

Persona’s

persona schakelt de stem om, niet de data. De waarde is een gesloten lijst, omdat een string uit de request-body in de systeemprompt belandt.

persona	Stem
astrologer	standaard, zoals het endpoint antwoordde voordat de parameter bestond
plain	zonder persona, begroeting en ondertekening
coach	steun en wat je ermee kunt doen
teacher	noemt de techniek en legt de termen uit

De vraag “Beschrijf mijn Saturnus in één alinea”, persona: "coach":

Je Saturnus staat in het teken Steenbok, zijn eigen domicilie, en is bovendien retrograde, in het 5e huis. Dat wijst op een diepgeworteld verlangen naar structuur, discipline en meesterschap, vooral op gebieden die te maken hebben met zelfexpressie, creativiteit, romantiek en kinderen.

persona: "teacher":

In je geboortehoroscoop staat Saturnus in Steenbok 25.2° (R) in het 5e huis. Saturnus is de planeet van discipline, verantwoordelijkheid, structuur en beperkingen; hij wijst op de gebieden waar we naar meesterschap streven en levenslessen tegenkomen.

Een onbekende persona is een 400 INVALID_INPUT met de lijst van toegestane waarden, geen stille standaardwaarde.

Verzoek en response

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

Response:

{
  "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 is hier ingekort, de overige velden staan er zoals ze zijn. model is de provider die antwoordde: de keten schakelt zelf om, en de naam staat in de response zodat je ziet wiens tokens je rekening heeft geteld. Loopt het model tegen het tokenplafond aan, dan wordt het antwoord afgekapt tot de laatste volledige zin en komt er truncated: true bij, in plaats van dat het midden in een woord afbreekt.

De horoscoop is optioneel

Zonder chart is het een gewone astrologische chat: geen context, dezelfde prijs. Met chart antwoordt hij over een concreet persoon. history tot 10 beurten stuurt de client mee: aan onze kant zijn er geen sessies, dus elke beurt staat op zichzelf en kan tussen processen worden verplaatst.

Prijs en limieten

Prijs per beurt	100 credits
Je eigen providersleutel (BYOK)	5 credits per beurt, de tokens zijn van jou
Free-plan	roept aan zonder planbeperking, binnen 10 000 credits per maand
Sandbox-sleutels aw_test_*	402, want de sandbox verbruikt geen credits, maar het model kost geld
Herhaling van een identieke body	uit de cache, x-cache: HIT, x-credits-used: 0
message	tot 2000 tekens, history tot 10 beurten
Talen	21, parameter language

Opgepast

Streaming is er op dit endpoint nog niet: de response komt in zijn geheel. POST /v1/mcp/streaming geeft SSE terug, maar wacht ook op het volledige antwoord en knipt het in zinnen, dus het eerste token zie je daar niet eerder.

Volledige reference Requestschema, foutcodes, voorbeelden

Je eigen providersleutel X-Provider, X-Provider-Key, 5 credits per beurt

Tarieven Hoeveel beurten per maand op elk plan

AI-agents en MCP Dezelfde chat als tool van een agent