Chat IA sur une vraie carte

Un LLM ordinaire répond à une question sur Saturne à partir de ce qu’il sait du signe. POST /v1/ai/chat répond à partir de la carte que nous venons de calculer: position, maison, aspects avec orbes et fenêtres de transit pour les six prochains mois. La différence se voit dès la première réponse: non pas “Saturne en Capricorne signifie la discipline”, mais “Saturne en Capricorne 25.2° rétrograde, maison 5, conjonction avec la Lune orbe 1.7°”.

Essayez sans clé

La démo fonctionne sur une seule carte fixe, 5 questions par adresse et par jour, avec le même prompt système que l’endpoint payant. Aucune clé n’est nécessaire.

Ce que voit le modèle

La démo renvoie le champ context: c’est l’intégralité du bloc envoyé dans le prompt. Le voici, en date du 2 septembre 2026, pour la carte de la démo (les transits sont recalculés à chaque requête, donc la liste des fenêtres sera différente demain):

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

Le bloc est abrégé: la version complète contient 12 planètes et angles, jusqu’à 20 aspects nataux majeurs et jusqu’à 12 fenêtres de transit. Le même bloc est construit pour l’endpoint payant à partir de la carte que vous envoyez.

Ce qu’il date et ce qu’il ne date pas

Notre prompt système autorise à nommer des mois pour les transits présents dans le bloc ci-dessus et interdit de dater un événement. À la question “quand vais-je me marier”, l’endpoint répond ainsi (extrait d’une vraie réponse du 2 septembre 2026):

Saturne en transit forme une conjonction avec votre Vénus natale. Ce transit sera actif pendant plusieurs mois: en septembre, octobre, novembre et décembre 2026, ainsi qu’en janvier, février et mars 2027, atteignant son orbe le plus serré en mars 2027.

Les dates ici ne sont pas inventées: c’est la ligne transiting Saturn Conjunction natal Venus du bloc de contexte. Il n’y a pas de date de mariage dans la réponse et il n’y en aura pas.

Note

Si vous construisez un produit dans lequel vous êtes responsable de la réponse, cette limite joue en votre faveur: une prédiction datée d’un événement, produite par le modèle d’un tiers dans votre interface, est votre risque, pas le nôtre. Besoin d’une fenêtre précise plutôt que d’un mois: /v1/transit-calendar.

Personas

persona change la voix, pas les données. Les valeurs forment une liste fermée, car la chaîne issue du corps de la requête aboutit dans le prompt système.

persona	Voix
astrologer	par défaut, comme l’endpoint répondait avant l’apparition du paramètre
plain	sans persona, sans salutation ni signature
coach	du soutien et ce qu’il faut en faire
teacher	nomme la technique et explique les termes

Question “Décris mon Saturne en un paragraphe”, persona: "coach":

Votre Saturne se trouve dans le signe du Capricorne, son propre domicile, et il est de plus rétrograde, situé dans la 5e maison. Cela indique une aspiration profondément ancrée à la structure, à la discipline et à la maîtrise, en particulier dans les domaines liés à l’expression de soi, à la créativité, à la romance et aux enfants.

persona: "teacher":

Dans votre carte natale, Saturne se trouve en Capricorne 25.2° (R) dans la 5e maison. Saturne est la planète de la discipline, de la responsabilité, de la structure et des limites; elle indique les domaines où nous recherchons la maîtrise et rencontrons les leçons de la vie.

Une persona inconnue donne 400 INVALID_INPUT avec la liste des valeurs admises, et non un défaut silencieux.

Requête et réponse

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éponse:

{
  "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 est abrégé ici, les autres champs sont tels quels. model est le fournisseur qui a répondu: la chaîne bascule d’elle-même, et son nom figure dans la réponse pour que vous voyiez quels tokens votre facture a comptés. Si le modèle a atteint le plafond de tokens, la réponse est coupée à la dernière phrase complète et truncated: true est ajouté, au lieu d’être tronquée au milieu d’un mot.

La carte est facultative

Sans chart, c’est un chat d’astrologie ordinaire: pas de contexte, même prix. Avec chart, il répond sur une personne précise. history, jusqu’à 10 tours, est envoyé par le client: il n’y a pas de session de notre côté, donc chaque tour est autonome et peut être déplacé d’un processus à l’autre.

Prix et limites

Prix d’un tour	100 crédits
Votre propre clé de fournisseur (BYOK)	5 crédits par tour, les tokens sont les vôtres
Plan Free	appelle sans restriction de plan, dans la limite de 10 000 crédits par mois
Clés sandbox aw_test_*	402, car le bac à sable ne dépense pas de crédits, alors que le modèle dépense de l’argent
Répétition d’un corps identique	depuis le cache, x-cache: HIT, x-credits-used: 0
message	jusqu’à 2000 caractères, history jusqu’à 10 tours
Langues	21, paramètre language

Attention

Il n’y a pas encore de streaming sur cet endpoint: la réponse arrive en entier. POST /v1/mcp/streaming renvoie du SSE, mais attend lui aussi la réponse complète et la découpe par phrases, donc vous ne verrez pas le premier token plus tôt.

Reference complète Schéma de requête, codes d'erreur, exemples

Votre propre clé de fournisseur X-Provider, X-Provider-Key, 5 crédits par tour

Tarifs Combien de tours par mois sur chaque plan

Agents IA et MCP Le même chat comme outil d'agent