AI Natal Narrative

POST

/reports/ai/natal-narrative

• Production

Long-form natal-chart narrative (markdown). Inputs: chart, language (21 codes), tone (warm/professional/concise), length (short/medium/long; ≤3200 tokens). Returns the narrative text plus model and token usage. AI grounded on the computed natal chart — Sun/Moon/Asc, 13 bodies, 12 houses, ≤25 major aspects.

Authorizations

• ApiKeyAuth

Code Samples

cURL

curl -X POST https://api.astroway.info/v1/reports/ai/natal-narrative \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json"

Node.js

const res = await fetch('https://api.astroway.info/v1/reports/ai/natal-narrative', {
  method: 'POST',
  headers: {
    'X-Api-Key': process.env.ASTROWAY_API_KEY,
    'Content-Type': 'application/json',
  },
});
const { ok, data, error } = await res.json();
if (!ok) throw new Error(error.message);
console.log(data);

Python

import os, requests

r = requests.post(
    'https://api.astroway.info/v1/reports/ai/natal-narrative',
    headers={'X-Api-Key': os.environ['ASTROWAY_API_KEY'], 'Content-Type': 'application/json'},
)
result = r.json()
if not result['ok']:
    raise RuntimeError(result['error']['message'])
print(result['data'])

PHP

<?php
use GuzzleHttp\Client;

$client = new Client(['base_uri' => 'https://api.astroway.info/v1/']);
$r = $client->post('reports/ai/natal-narrative', [
    'headers' => ['X-Api-Key' => getenv('ASTROWAY_API_KEY')],
]);
$result = json_decode($r->getBody(), true);
if (!$result['ok']) throw new \RuntimeException($result['error']['message']);
print_r($result['data']);

Request Body ^required

object

chart

required

Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss). Defaults to lat/lon/tz=0 if omitted; pass real values for accurate computation.

object

date

required

string

/^\d{4}-\d{2}-\d{2}$/

time

required

string

/^\d{2}:\d{2}:\d{2}$/

timezoneOffset

number

0 nullable

latitude

number

0 nullable

longitude

number

0 nullable

houseSystem

string

default: P

name

string

""

city

string

""

zodiacType

string

Allowed values: tropical sidereal

ayanamsaId

number

nullable

cosmogram

boolean

key

additional properties

nullable

language

string

default: uk

Allowed values: uk en de ru pl es pt hi fr ko it ja id tr nl ro cs vi ar el hu

tone

string

default: warm

Allowed values: warm professional concise

length

string

default: medium

Allowed values: short medium long

Responses

200

Successful calculation

object

ok

boolean

Example

true

data

object

narrative

string

disclaimer

string

model

string

language

string

tone

string

length

string

tokens

object

input

number

output

number

duration_ms

number

Example

{
  "ok": true,
  "data": {
    "narrative": "# Вступ\n\n...",
    "disclaimer": "Цей наратив згенерований ШІ...",
    "model": "groq/llama-3.3-70b",
    "language": "uk",
    "tone": "warm",
    "length": "medium",
    "tokens": {
      "input": 542,
      "output": 1623
    },
    "duration_ms": 3500
  }
}

400

Validation error

Example

{
  "ok": false,
  "error": {
    "code": "INVALID_INPUT",
    "message": "Validation failed: date: Date must be YYYY-MM-DD",
    "details": [
      {
        "path": "date",
        "message": "Date must be YYYY-MM-DD"
      }
    ]
  }
}

401

Missing or invalid API key

Example

{
  "ok": false,
  "error": {
    "code": "INVALID_API_KEY",
    "message": "Invalid API key"
  }
}