Chat de IA sobre una carta real

Un LLM normal responde a una pregunta sobre Saturno con lo que recuerda del signo. POST /v1/ai/chat responde a partir de la carta que acabamos de calcular: posición, casa, aspectos con orbes y ventanas de tránsito para el próximo medio año. La diferencia se ve desde la primera respuesta: no “Saturno en Capricornio significa disciplina”, sino “Saturno en Capricornio 25.2° retrógrado, casa 5, conjunción con la Luna orbe 1.7°”.

Pruébalo sin clave

La demo funciona con una única carta fija, 5 preguntas por dirección al día y el mismo prompt de sistema que el endpoint de pago. No hace falta clave.

Qué ve el modelo

La demo devuelve el campo context: es el bloque completo que se envió en el prompt. Aquí está tal como era el 2 de septiembre de 2026 para la carta de la demo (los tránsitos se recalculan en cada petición, así que mañana la lista de ventanas será otra):

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

El bloque está abreviado: la versión completa tiene 12 planetas y ángulos, hasta 20 aspectos natales mayores y hasta 12 ventanas de tránsito. El mismo bloque se construye para el endpoint de pago a partir de la carta que envías tú.

Qué fecha y qué no

Nuestro prompt de sistema permite nombrar meses para los tránsitos que están en el bloque de arriba y prohíbe fechar un acontecimiento. A la pregunta “cuándo me casaré” el endpoint responde así (fragmento de una respuesta real del 2 de septiembre de 2026, traducido):

Saturno en tránsito forma una conjunción con tu Venus natal. Este tránsito estará activo durante varios meses: en septiembre, octubre, noviembre y diciembre de 2026, y también en enero, febrero y marzo de 2027, alcanzando el orbe más cerrado en marzo de 2027.

Las fechas no son inventadas: es la línea transiting Saturn Conjunction natal Venus del bloque de contexto. La fecha de la boda no está en la respuesta ni lo estará.

Nota

Si construyes un producto en el que tú respondes por la respuesta, este límite juega a tu favor: una predicción fechada de un acontecimiento hecha por un modelo ajeno en tu interfaz es tu riesgo, no el nuestro. Si necesitas una ventana exacta en lugar de un mes: /v1/transit-calendar.

Personas

persona cambia la voz, no los datos. Los valores son una lista cerrada, porque la cadena del cuerpo de la petición acaba en el prompt de sistema.

persona	Voz
astrologer	por defecto, como respondía el endpoint antes de que existiera el parámetro
plain	sin persona, saludo ni firma
coach	apoyo y qué hacer con ello
teacher	nombra la técnica y explica los términos

Pregunta “Describe mi Saturno en un párrafo”, persona: "coach":

Tu Saturno está en el signo de Capricornio, que es su propio domicilio, y además es retrógrado y se sitúa en la casa 5. Esto indica un deseo profundamente arraigado de estructura, disciplina y maestría, sobre todo en los ámbitos relacionados con la expresión personal, la creatividad, el romance y los hijos.

persona: "teacher":

En tu carta natal, Saturno está en Capricornio 25.2° (R) en la casa 5. Saturno es el planeta de la disciplina, la responsabilidad, la estructura y los límites; señala los ámbitos en los que buscamos la maestría y nos encontramos con las lecciones de la vida.

Una persona desconocida es 400 INVALID_INPUT con la lista de valores admitidos, no un valor por defecto silencioso.

Petición y respuesta

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

Respuesta:

{
  "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"
  }
}

Aquí reply está abreviado, el resto de campos están tal cual. model es el proveedor que respondió: la cadena cambia sola, y su nombre está en la respuesta para que veas de quién son los tokens que se han contado. Si el modelo choca con el techo de tokens, la respuesta se recorta hasta la última frase completa y se añade truncated: true, en lugar de cortarse a mitad de palabra.

La carta es opcional

Sin chart es un chat de astrología normal: no hay contexto, el precio es el mismo. Con chart responde sobre una persona concreta. El history de hasta 10 turnos lo envía el cliente: no hay sesiones en nuestro lado, así que cada turno es autosuficiente y se puede mover entre procesos.

Precio y límites

Precio por turno	100 créditos
Tu propia clave de proveedor (BYOK)	5 créditos por turno, los tokens son tuyos
Plan Free	llama sin restricciones de plan, dentro de 10 000 créditos al mes
Claves sandbox aw_test_*	402, porque el sandbox no gasta créditos y el modelo gasta dinero
Repetición de un cuerpo idéntico	desde la caché, x-cache: HIT, x-credits-used: 0
message	hasta 2000 caracteres, history hasta 10 turnos
Idiomas	21, parámetro language

Precaución

Este endpoint todavía no tiene streaming: la respuesta llega entera. POST /v1/mcp/streaming devuelve SSE, pero también espera a la respuesta completa y la corta por frases, así que no verás el primer token antes.

Referencia completa Esquema de la petición, códigos de error, ejemplos

Tu propia clave de proveedor X-Provider, X-Provider-Key, 5 créditos por turno

Planes Cuántos turnos al mes en cada plan

Agentes de IA y MCP El mismo chat como herramienta de un agente