AI-Chat auf einem echten Horoskop

Ein gewöhnliches LLM beantwortet eine Frage zum Saturn aus dem, was es über das Zeichen im Gedächtnis hat. POST /v1/ai/chat antwortet aus dem Horoskop, das wir gerade berechnet haben: Position, Haus, Aspekte mit Orben und Transitfenster für das nächste halbe Jahr. Der Unterschied ist ab der ersten Antwort sichtbar: nicht “Saturn im Steinbock bedeutet Disziplin”, sondern “Saturn im Steinbock 25.2° rückläufig, 5. Haus, Konjunktion mit dem Mond, Orb 1.7°”.

Ohne Schlüssel ausprobieren

Die Demo läuft auf einem festen Horoskop, 5 Fragen pro Adresse und Tag, mit demselben System-Prompt wie der kostenpflichtige Endpunkt. Ein Schlüssel ist nicht nötig.

Was das Modell sieht

Die Demo gibt das Feld context zurück: Das ist der ganze Block, der in den Prompt gegangen ist. Hier ist er mit Stand vom 2. September 2026 für das Horoskop aus der Demo (Transite werden bei jeder Anfrage neu berechnet, die Liste der Fenster sieht morgen also anders aus):

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

Der Block ist gekürzt: Die vollständige Fassung enthält 12 Planeten und Achsen, bis zu 20 wichtige Geburtsaspekte und bis zu 12 Transitfenster. Derselbe Block wird für den kostenpflichtigen Endpunkt aus dem Horoskop gebaut, das du sendest.

Was er datiert und was nicht

Unser System-Prompt erlaubt es, für die Transite aus dem Block oben Monate zu nennen, und verbietet, ein Ereignis zu datieren. Auf die Frage “wann werde ich heiraten” antwortet der Endpunkt so (Ausschnitt einer echten Antwort vom 2. September 2026, übersetzt):

Der transitierende Saturn bildet eine Konjunktion mit Ihrer Geburtsvenus. Dieser Transit ist mehrere Monate lang aktiv: im September, Oktober, November, Dezember 2026 sowie im Januar, Februar und März 2027, wobei er im März 2027 den engsten Orb erreicht.

Die Daten hier sind nicht erfunden: Es ist die Zeile transiting Saturn Conjunction natal Venus aus dem Kontextblock. Ein Hochzeitsdatum steht nicht in der Antwort und wird dort auch nie stehen.

Hinweis

Wenn du ein Produkt baust, in dem du für die Antwort geradestehst, arbeitet diese Grenze für dich: Eine datierte Ereignisvorhersage eines fremden Modells in deiner Oberfläche ist dein Risiko, nicht unseres. Du brauchst statt eines Monats ein genaues Fenster: /v1/transit-calendar.

Personas

persona wechselt die Stimme, nicht die Daten. Der Wert ist eine geschlossene Liste, weil der String aus dem Body der Anfrage in den System-Prompt gelangt.

persona	Stimme
astrologer	Standard, so wie der Endpunkt vor Einführung des Parameters antwortete
plain	ohne Persona, Begrüßung und Signatur
coach	Unterstützung und was man damit anfängt
teacher	nennt die Technik und erklärt die Begriffe

Frage “Beschreibe meinen Saturn in einem Absatz”, persona: "coach":

Ihr Saturn steht im Zeichen Steinbock, seinem eigenen Domizil, und ist zudem rückläufig, im 5. Haus. Das weist auf ein tief verwurzeltes Streben nach Struktur, Disziplin und Meisterschaft hin, besonders in Bereichen, die mit Selbstausdruck, Kreativität, Romantik und Kindern zu tun haben.

persona: "teacher":

In Ihrem Geburtshoroskop steht Saturn im Steinbock 25.2° (R) im 5. Haus. Saturn ist der Planet der Disziplin, Verantwortung, Struktur und Begrenzung; er zeigt die Bereiche, in denen wir nach Meisterschaft streben und auf Lektionen des Lebens stoßen.

Eine unbekannte Persona ist ein 400 INVALID_INPUT mit der Liste der zulässigen Werte, kein stiller Standardwert.

Anfrage und Antwort

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

Antwort:

{
  "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 ist hier gekürzt, die übrigen Felder sind unverändert. model ist der Anbieter, der geantwortet hat: Die Kette wechselt selbstständig, und sein Name steht in der Antwort, damit du siehst, wessen Tokens deine Rechnung gezählt hat. Stößt das Modell an die Token-Obergrenze, wird die Antwort bis zum letzten vollständigen Satz gekürzt und truncated: true hinzugefügt, statt mitten im Wort abzubrechen.

Das Horoskop ist optional

Ohne chart ist das ein gewöhnlicher Astrologie-Chat: kein Kontext, gleicher Preis. Mit chart antwortet er über einen konkreten Menschen. history mit bis zu 10 Zügen sendet der Client: Sitzungen gibt es auf unserer Seite nicht, daher ist jeder Zug in sich geschlossen und lässt sich zwischen Prozessen verschieben.

Preis und Limits

Preis pro Zug	100 Credits
Eigener Anbieterschlüssel (BYOK)	5 Credits pro Zug, die Tokens zahlst du
Free-Tarif	Aufruf ohne Tarifbeschränkung, im Rahmen von 10 000 Credits pro Monat
Sandbox-Schlüssel aw_test_*	402, weil die Sandbox keine Credits verbraucht, das Modell aber Geld kostet
Wiederholung eines identischen Bodys	aus dem Cache, x-cache: HIT, x-credits-used: 0
message	bis zu 2000 Zeichen, history bis zu 10 Züge
Sprachen	21, Parameter language

Achtung

Streaming gibt es auf diesem Endpunkt noch nicht: Die Antwort kommt vollständig. POST /v1/mcp/streaming liefert SSE, wartet aber ebenfalls auf die vollständige Antwort und teilt sie in Sätze, das erste Token siehst du also nicht früher.

Vollständige Referenz Anfrageschema, Fehlercodes, Beispiele

Eigener Anbieterschlüssel X-Provider, X-Provider-Key, 5 Credits pro Zug

Tarife Wie viele Züge pro Monat in jedem Plan

AI-Agenten und MCP Derselbe Chat als Tool eines Agenten