API degli oroscopi e interpretazioni AI

10 endpoint AI — parte dei 700+ endpoint della piattaforma AstroWay (16 categorie). 5 per gli oroscopi (giornalieri, settimanali, mensili, annuali, compatibilità) e 5 per le interpretazioni (natale, sinastria, transiti, elemento, posizionamento). Tutti basati su calcoli reali di Swiss Ephemeris (lo stesso usato in Solar Fire e Astrodienst) — non su modelli predefiniti né su allucinazioni LLM.

Come funziona

1. L’API calcola una mappa astrologica reale (transiti, natale, sinastria) tramite Swiss Ephemeris
2. Il risultato viene inviato al nostro AI-gateway, che si appoggia ai migliori modelli di mercato (Google Gemini → Groq Llama 3.3 → OpenRouter con GPT-4 / Claude / DeepSeek → Cerebras → SambaNova → Mistral) con un system prompt astrologico e failover automatico
3. L’LLM genera un testo con guardrail di sicurezza integrati (vietate le consulenze mediche, legali o finanziarie)
4. La risposta include un disclaimer e una traccia di audit

Consiglio

Gli endpoint AI restituiscono sia i calcoli che il testo. Puoi usare solo i calcoli (endpoint più economici) e generare il testo con il tuo LLM.

Endpoint — oroscopi

Endpoint	Crediti	Cosa genera
/v1/horoscope/daily	20	Oroscopo giornaliero basato sui transiti attuali
/v1/horoscope/weekly	20	Panoramica settimanale
/v1/horoscope/monthly	20	Previsione mensile
/v1/horoscope/yearly	50	Previsione annuale
/v1/horoscope/compatibility	50	Analisi testuale della compatibilità

Endpoint — interpretazioni

Endpoint	Crediti	Cosa interpreta
/v1/interpret/natal	50	Interpretazione completa della carta natale
/v1/interpret/synastry	50	Interpretazione della sinastria
/v1/interpret/transits	50	Interpretazione dei transiti attuali
/v1/interpret/element	20	Interpretazione di un singolo elemento (pianeta in segno, aspetto)
/v1/interpret/placement	20	Interpretazione del posizionamento (pianeta in casa)

Esempio

cURL

curl -X POST https://api.astroway.info/v1/horoscope/daily \
  -H "X-Api-Key: aw_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "date": "1990-07-14",
    "time": "14:30:00",
    "timezoneOffset": 3,
    "latitude": 50.4501,
    "longitude": 30.5234
  }'

Node.js

const r = await fetch('https://api.astroway.info/v1/horoscope/daily', {
  method: 'POST',
  headers: {
    'X-Api-Key': process.env.ASTROWAY_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    date: '1990-07-14',
    time: '14:30:00',
    timezoneOffset: 3,
    latitude: 50.4501,
    longitude: 30.5234,
  }),
});
const { data: horoscope } = await r.json();
console.log(horoscope.text);

Python

import os, requests

r = requests.post(
    'https://api.astroway.info/v1/horoscope/daily',
    headers={'X-Api-Key': os.environ['ASTROWAY_API_KEY'], 'Content-Type': 'application/json'},
    json={
        'date': '1990-07-14',
        'time': '14:30:00',
        'timezoneOffset': 3,
        'latitude': 50.4501,
        'longitude': 30.5234,
    },
)
horoscope = r.json()['data']
print(horoscope['text'])

PHP

<?php
use GuzzleHttp\Client;

$aw = new Client(['base_uri' => 'https://api.astroway.info/v1/']);
$r = $aw->post('horoscope/daily', [
    'headers' => ['X-Api-Key' => getenv('ASTROWAY_API_KEY')],
    'json' => [
        'date' => '1990-07-14',
        'time' => '14:30:00',
        'timezoneOffset' => 3,
        'latitude' => 50.4501,
        'longitude' => 30.5234,
    ],
]);
$horoscope = json_decode($r->getBody(), true)['data'];
echo $horoscope['text'];

Guardrail di sicurezza

Tutti gli endpoint AI includono protezioni integrate:

• System prompt con divieto esplicito di consulenze mediche, legali o finanziarie
• Disclaimer auto-iniettato in ogni risposta
• Content filter — filtraggio post-risposta per parole chiave
• Traccia di audit — registrazione dei prompt e delle risposte (conservazione 90 giorni)
• disclaimer_inline: true — parametro per le aziende che vogliono il testo già con il disclaimer

Attenzione

Le interpretazioni AI sono pensate per scopi ricreativi. Non sostituiscono una consulenza professionale di un astrologo, medico, avvocato o consulente finanziario.

Chi lo usa

• Piattaforme di contenuti — oroscopi giornalieri per il pubblico
• App astrologiche — interpretazioni personalizzate al posto di testi generici
• Agenti AI — tramite server MCP o chiamate API dirette
• Media — generazione di contenuti astrologici basati su dati reali

Costi

L’oroscopo giornaliero costa 20 crediti. L’interpretazione completa della carta natale costa 50 crediti. Con il piano Free hai 250 oroscopi giornalieri o 100 interpretazioni al mese.

Guida rapida → Fai la tua prima richiesta in 5 minuti

Agenti AI e MCP Integrazione con Claude, ChatGPT

Tariffe Dai piani gratuiti a quelli Enterprise