Qu'est-ce que l'API Chat Astrologie et en quoi diffère-t-elle d'un chatbot classique ?

L'API Chat Astrologie est une plateforme agentique — pas qu'un wrapper de chatbot. Quand vous envoyez un message, le serveur peut appeler l'un des 40 outils d'astrologie que vous avez activés (thèmes natals, transits, synastrie, rapports PDF, etc.), les exécute contre nos endpoints de calcul et synthétise une réponse fondée. Contrairement aux chatbots génériques qui hallucinent les données astrologiques, chaque interprétation est étayée par de vrais calculs d'éphémérides. Toute la boucle d'agent s'exécute côté serveur en un seul appel API.

Puis-je utiliser le SDK OpenAI Python ou TypeScript avec cette API ?

Oui — c'est le principe de conception fondamental. Nous implémentons le protocole standard OpenAI /chat/completions, donc vous utilisez le SDK OpenAI officiel dans n'importe quel langage : TypeScript (package npm openai), Python (package pip openai), Go, Rust ou tout client HTTP. Changez simplement l'URL de base vers notre endpoint. Votre code OpenAI existant fonctionne avec des modifications minimales. Cela signifie aussi une compatibilité instantanée avec LangChain, Vercel AI SDK et tout framework compatible OpenAI.

Quels modèles LLM sont supportés avec le BYOK ?

Le BYOK supporte trois fournisseurs avec 50+ modèles. OpenAI : GPT-5, GPT-5-mini, GPT-5-nano, familles o3, o4. Anthropic : Claude Opus 4, Sonnet 4, Haiku 4. OpenRouter : tout modèle qu'ils hébergent — Gemini 3, Grok 4, Llama, Mistral, Qwen, et plus. Vous passez votre propre clé API et identifiant de modèle. La plateforme gère automatiquement toutes les particularités spécifiques aux fournisseurs (comme les différences de paramètres des modèles de raisonnement).

Combien coûte chaque tour de chat en credits ?

Chaque tour a deux composantes de coût : credits de plateforme + credits endpoint pour les appels d'outils. Mode hosted : 25 credits/tour (LLM inclus) + credits endpoint (ex. natal = 1, transit = 1, astrocartographie = 5, PDF = 35). Mode BYOK : 2 credits/tour + mêmes credits endpoint + coûts de votre fournisseur LLM. Exemple : une interprétation de thème natal = 25 + 1 = 26 credits hosted (~0,02$), ou 2 + 1 = 3 credits BYOK (~0,002$) + ~0,003$ de coût LLM. Sur le plan Professional (37$/mois, 55 000 credits) cela représente ~2 100 tours hosted ou ~18 000 tours BYOK. Niveau gratuit : 50 requêtes/mois.

Comment fonctionne le chat multi-sujets pour la synastrie et la compatibilité ?

Passez plusieurs sujets dans le tableau astrology.subjects, chacun avec un identifiant sémantique ('me', 'partner', 'child') et les données de naissance. Le LLM référence les sujets par identifiant lors de l'appel des outils — le serveur résout les identifiants en coordonnées de naissance complètes. Cela permet la synastrie, les thèmes composites et l'analyse multi-personnes dans une seule conversation. Aucun concurrent ne supporte plus d'un sujet par session.

Le chat peut-il générer des rapports PDF et des images de thèmes SVG ?

Oui — les artefacts binaires sont une fonctionnalité unique. Demandez 'Génère mon thème natal' et l'agent appelle l'outil render_natal, produit un SVG (ou PNG/PDF), le stocke comme artefact et retourne une URL partageable. Même chose pour les rapports PDF natals — des documents professionnels multi-pages avec visualisation en roue, interprétations et thèmes. Les artefacts sont stockés dans Supabase avec une rétention de 24 heures et des URLs partageables.

Quelle est la rapidité de l'API Chat Astrologie comparée aux alternatives ?

Notre couche de calcul répond en moins de 300ms par appel d'outil. Le temps de réponse total (calcul + génération LLM) est généralement de 2-5 secondes avec le streaming. Les solutions de chat astrologique concurrentes tournent en moyenne à 8-24 secondes par réponse, même sur les plans premium. Avec le streaming, nos utilisateurs voient les premiers tokens en moins de 2 secondes pendant que l'agent continue de travailler.

Que sont les événements d'extension du streaming SSE ?

Au-delà des chunks de texte standard OpenAI, nous émettons des événements SSE personnalisés : tool_start (quand l'agent commence à appeler un outil — votre interface peut afficher 'Calcul du thème natal...'), tool_end (quand l'outil retourne — avec le temps d'exécution), et astrology.error (si un outil échoue gracieusement). Ces événements permettent des interfaces riches en temps réel qui montrent le processus de raisonnement de l'agent pendant qu'il travaille.

Comment fonctionnent les sessions et la mémoire de conversation ?

Passez astrology.session_id dans votre requête. Au premier tour, le serveur crée une session supportée par Redis. Aux tours suivants avec le même identifiant, le serveur charge les messages précédents et les sujets avant de traiter votre nouveau message. Les sessions ont un TTL glissant de 24 heures — chaque interaction prolonge la fenêtre. Le serveur gère la compression des messages pour les longues conversations, vous n'avez donc pas à gérer les fenêtres de contexte.

Quels langages de programmation et frameworks sont supportés ?

Tout langage avec un client HTTP fonctionne, mais les SDKs OpenAI offrent la meilleure expérience : TypeScript/JavaScript (openai), Python (openai), Go (openai-go), Rust, C#, Java, PHP, Ruby. Compatibilité frameworks : LangChain, LlamaIndex, Vercel AI SDK, Semantic Kernel, AutoGen, CrewAI, Haystack — tout ce qui parle le protocole OpenAI. La plupart des développeurs intègrent en moins de 30 minutes.

Est-ce juste un wrapper GPT ou cela utilise-t-il de vraies données astronomiques ?

Chaque interprétation astrologique est fondée sur de vrais calculs d'éphémérides. Quand l'agent appelle charts_natal, il calcule les positions planétaires réelles en utilisant la Swiss Ephemeris — le même moteur que les logiciels d'astrologie professionnels utilisent. Le LLM reçoit de vraies données de thème (positions planétaires, placements en maisons, aspects avec orbes exacts) et synthétise les interprétations à partir de ces données. Pas de positions planétaires hallucinées, pas d'aspects inventés.

Comment contrôler le style et la longueur de la réponse ?

Trois niveaux de contrôle : 1) Message système — définissez n'importe quelle personnalité ('psychologue jungien chaleureux', 'classiciste britannique concis', etc.). 2) astrology.defaults.detail_level — 'brief' (moins de 100 mots), standard (200-350 mots), ou 'detailed' (500-800 mots). 3) astrology.defaults.tradition — classique, psychologique, événementielle ou universelle. L'instruction explicite de l'utilisateur ('brièvement' ou 'en détail') prévaut sur tout.

Quelles traditions astrologiques et systèmes de maisons sont supportés ?

Quatre traditions d'interprétation : Classique (hellénistique/médiévale), Psychologique (jungienne), Événementielle (horaire/électionnelle) et Universelle (équilibrée). Vingt-trois systèmes de maisons incluant Placidus, Koch, Maisons Entières, Égal, Campanus, Regiomontanus, Porphyre et plus. Définissez via astrology.defaults.house_system — le serveur l'applique automatiquement à tous les appels d'outils.

Puis-je proposer cela en marque blanche comme mon propre produit ?

Absolument. Le prompt système (messages[0] avec role='system') contrôle toute la personnalité. Définissez la voix de votre marque, le personnage d'astrologue, le style linguistique — l'utilisateur ne voit jamais notre branding. Le BYOK vous donne le contrôle des coûts. La persistance de session permet des modèles d'abonnement. Les plans tarifaires standards supportent la redistribution commerciale.

Que se passe-t-il si un appel d'outil échoue pendant la conversation ?

Dégradation gracieuse. Si un outil retourne une erreur (données de naissance invalides, calcul non supporté), l'agent reçoit le message d'erreur et s'adapte — il peut essayer un autre outil, demander des précisions à l'utilisateur ou fournir une réponse partielle. Avec le streaming, vous recevez un événement astrology.error. La conversation ne plante pas ; le LLM gère les erreurs de manière conversationnelle, comme le ferait un astrologue humain.

Puis-je construire un widget d'astrologie avec Lovable, Claude Code ou Cursor ?

Oui — c'est l'API idéale pour le vibe coding. Parce que nous implémentons le protocole standard OpenAI /chat/completions, les outils de codage IA comme Lovable, Claude Code, Cursor, Windsurf, Bolt et Replit Agent savent déjà comment l'intégrer. Demandez simplement : 'Construis un widget de chat astrologique en utilisant le SDK OpenAI avec base URL https://api.astrology-api.io/api/v3/chat'. L'IA génère un composant de chat en streaming fonctionnel — formulaire de données de naissance, bulles de message, indicateurs de saisie — sans débogage manuel. Aucune autre API d'astrologie ne propose cela car elles utilisent toutes des formats JSON propriétaires que les outils IA ne comprennent pas.

Comment l'API Chat Astrologie se compare-t-elle à la construction de la mienne avec RoxyAPI ou des endpoints de données bruts ?

RoxyAPI et les APIs similaires de données seules vous donnent du JSON de calcul brut — vous construisez toute la couche d'agent vous-même : schémas d'outils, orchestration LLM, gestion des erreurs, gestion de session, stockage d'artefacts. C'est des mois d'ingénierie. Notre plateforme livre tout cela clé en main. Un seul appel API remplace des centaines de lignes de code de framework d'agent. Si vous utilisez déjà LangChain ou CrewAI, notre endpoint se branche comme un seul outil — votre framework d'agent existant gère le reste.

Qu'est-ce que to_prompt_text() et pourquoi les développeurs de chatbots devraient-ils s'y intéresser ?

to_prompt_text() est un formateur qui transforme les données de thème en markdown compact, prêt pour LLM. Insérez-le dans n'importe quel prompt (Claude, GPT, Gemini, Grok) pour ancrer le modèle dans des données de thème réelles sans injecter de JSON. La sortie est en langage naturel — 'Mars square Saturn within 2°' au lieu de codes obscurs — donc le LLM l'analyse correctement du premier coup. Le coût moyen en tokens chute d'environ 60% par rapport au JSON brut, et les lectures hallucinées chutent fortement parce que le modèle peut lire les données.

De combien le formateur de prompt réduit-il les coûts en tokens LLM ?

Un dump JSON natal brut tourne entre 1 500 et 3 000 tokens. Le preset 'minimal' utilise 150-250 tokens, 'full' utilise 500-800, 'traditional' utilise 600-900. C'est ~60% de réduction en moyenne — et les économies se cumulent sur les sessions multi-tours. Sur la tarification de classe GPT-4, un chatbot effectuant 10 000 lectures natales par mois économise environ 150$-300$ en tokens de prompt. Un contexte plus petit signifie aussi que les longues conversations tiennent avant que la fenêtre ne se remplisse.

Quelles langues to_prompt_text() supporte-t-il ?

Sept langues, avec ~40 chaînes localisées couvrant aspects, dignités, secte, maisons et modalités : anglais (en), allemand (de), espagnol (es), français (fr), italien (it), portugais (pt), russe (ru). Passez le code de langue et le formateur retourne le markdown dans cette langue — prêt à insérer dans un prompt de chatbot localisé. Aucune traduction côté client nécessaire.

Comment les aspects sont-ils formatés en langage naturel ?

Les aspects sortent sous forme de phrases lisibles avec des orbes précis. Exemples : 'Mars square Saturn within 2°', 'Venus trine Jupiter within 0°45'', 'Moon opposite Sun within 1°15''. Le nom de l'aspect (square, trine, opposition, sextile, conjunction) est écrit en toutes lettres, l'orbe est affiché en degrés et minutes, et les planètes se trouvent de part et d'autre du mot de relation — exactement comme un astrologue l'écrirait. Les LLMs analysent cela correctement du premier coup.

Que signifient les préfixes t. et n. dans la sortie formatée ?

't.' marque les planètes en transit, 'n.' marque les planètes natales. Quand vous formatez une lecture de transit, chaque ligne d'aspect indique clairement la source — par exemple 't.Jupiter trine n.Venus within 1°' signifie que Jupiter en transit est en trigone avec la Vénus natale. Ce simple changement élimine l'hallucination la plus courante dans les chatbots d'astrologie : la confusion d'identité planétaire entre le thème natal et le ciel actuel. Le LLM n'a jamais à deviner.

L'API Chat peut-elle extraire mon vrai thème natal pendant une conversation ?

Oui. Listez les outils voulus dans astrology.enabled_tools et passez vos données de naissance sur un sujet (avec un identifiant comme 'me'). Quand le LLM décide qu'il a besoin de votre thème, il appelle un outil comme charts_natal avec votre subject_id — le serveur le résout en vos vraies birth_data et retourne les positions planétaires réelles, pas une estimation. Rien n'est activé par défaut, donc la réponse ne récupère de vraies données de thème que pour les outils que vous avez explicitement activés pour cette requête.

Quels outils l'IA peut-elle appeler ?

40 outils répartis en six catégories : calculs de thèmes (natal, transit, synastrie, composite, davison, draconique, harmonique, héliocentrique, espace local, antiscia), rendu de thèmes en images, recherches de données (positions, aspects, heure actuelle), rapports d'analyse complets (natal, lunaire, synastrie, relocalisation), un horoscope quotidien personnel, et la génération de rapports PDF (natal, synastrie, retour solaire, retour lunaire, retour de Saturne, composite, relocalisation, carte archétypale, feuille de route pluriannuelle et rapports Kundli védique). Chaque outil est activé à la carte par requête — listez les noms exacts des outils dans astrology.enabled_tools.

Que se passe-t-il si le modèle IA échoue en pleine réponse ?

Le serveur classe désormais et relance automatiquement les pannes transitoires du modèle amont avant qu'elles n'atteignent votre application. Si une panne ne peut pas être récupérée, vous obtenez un signal propre et prévisible au lieu d'un blocage ou d'un texte tronqué : une erreur 502 sur les requêtes hors streaming, ou un chunk terminal sur un flux SSE. Ceci a été déployé comme un correctif de fiabilité et a significativement réduit les sessions de chat cassées pour les consommateurs d'API qui construisent sur cet endpoint.

L'utilisation d'outils affecte-t-elle la mise en cache des réponses ou le coût ?

Oui, et l'effet est favorable. Le prompt système est divisé en un préambule toujours actif plus des règles d'utilisation d'outils qui ne se chargent que lorsque des outils sont réellement résolus pour une requête. Cela signifie que le comportement du cache de prompt suit l'ensemble d'outils que vous activez réellement plutôt qu'un seul prompt statique, donc les coûts restent prévisibles sur les requêtes qui varient enabled_tools — et cela a aussi corrigé des échecs de complétion vide qui apparaissaient de manière disproportionnée sur les niveaux de modèles plus légers et plus rapides.

NOUVEAU : Plateforme Agent IA

Plus qu'un Chat. Construisez des Agents IA d'Astrologie

La seule plateforme agentique compatible OpenAI pour l'astrologie.

40 outils côté serveur, choix de modèle BYOK, streaming SSE avec retry automatique, sessions multi-sujets. Un seul appel API, boucle d'agent complète.

Voir la Documentation API

Presets de Contexte LLM

Langues de Prompt

60%

Réduction de Tokens

Outils d'Agent

Compatible SDK OpenAI

Apportez Votre Propre Clé

Boucle d'Agent Côté Serveur

Voir l'Agent en Action

De vraies conversations propulsées par l'orchestration d'outils côté serveur

Astrology Chat APILive Demo

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.astrology-api.io/api/v3/chat",
  apiKey: "your-astrology-api-key",
});

const response = await client.chat.completions.create({
  model: "astro-default",
  stream: true,
  messages: [
    { role: "system", content: "Warm, insightful astrologer." },
    { role: "user", content: "Analyze my natal chart" }
  ],
  astrology: {
    subjects: [{ id: "me", birth_data: {
        year: 1990, month: 3, day: 15,
        hour: 14, minute: 30,
        city: "New York", country_code: "US"
      } }],
    enabled_tools: ["charts_natal"],
    defaults: { language: "fr", tradition: "psychological" }
  }
} as any);

for await (const chunk of response) {
  process.stdout.write(chunk.choices[0]?.delta?.content || "");
}

Compatible avec n'importe lequel de nos 40 outils ou combinaisons

Vedic Jyotish

Questions Horaires

Human Design

Astrocartography

Numérologie

Tarot

Synastrie Relationnelle

Prévision de Transits

Toute combinaison d'endpoints en une seule session — natal, Vedic, horaire, BaZi, astrocartography et plus.Hosted : 25 + credits endpoint/tour · BYOK : 2 + credits endpoint + coûts LLM

Un dump JSON natal complet consomme 1 500 à 3 000 tokens par thème — les fenêtres de contexte se remplissent vite
Des codes obscurs comme 'Mars 0d 90.0 Saturn' embrouillent le modèle et produisent des lectures fausses
Données de transit et natal mélangées sans préfixes — le LLM invente quelle planète est laquelle
Enfermé dans des modèles de chat propriétaires sans choix BYOK ni contrôle des coûts
Contexte de prompt uniquement en anglais qui bloque les déploiements de chatbots multilingues
Construire votre propre boucle d'outils, formateur de prompt et gestionnaire de session de zéro

Transformez avec

Formateur to_prompt_text() : 3 presets (minimal 150-250, full 500-800, traditional 600-900 tokens) — ~60% de réduction vs JSON brut
Aspects en langage naturel : 'Mars square Saturn within 2°' au lieu de codes obscurs
Préfixes t. / n. désambiguïsent transit vs natal (ex. 't.Jupiter trine n.Venus') — fini les planètes hallucinées
i18n sur 7 langues (~40 chaînes) couvrant EN, DE, ES, FR, IT, PT, RU pour des chatbots déployés mondialement
BYOK : GPT-5, Claude 4, Gemini 3, Grok ou n'importe lequel des 50+ modèles OpenRouter
Boucle d'agent côté serveur avec 40 outils, retry automatique sur les pannes amont, sessions multi-sujets et artefacts binaires

Performance de la Plateforme

Contexte optimisé en tokens, outillage prêt pour les agents, calculs rapides

Presets de Contexte LLM

Langues de Prompt

~60%

Réduction de Tokens vs JSON

~40

Chaînes i18n dans le Formateur

Outils d'Agent

<300ms

Vitesse de Calcul

Langues d'Interprétation

50+

Modèles LLM

Fonctionnalités Complètes de la Plateforme d'Agent

Tout ce qu'il vous faut pour construire des expériences IA d'astrologie

Formateur de Contexte LLM to_prompt_text()

Bring Your Own Key (BYOK)

Streaming SSE et Événements

40 Outils Astrologiques Intégrés

Retry Automatique et Fiabilité

Multi-Sujets et Sessions

Prêt pour Widgets avec les Outils de Codage IA

Artefacts Binaires et Sorties

Qu'est-ce que l'API Chat Astrologie ? Guide Complet pour Développeurs

Tout ce qu'il vous faut pour construire des expériences astrologiques propulsées par l'IA

Et si vous pouviez ajouter un agent IA d'astrologie pleinement fonctionnel à votre application avec un seul appel API ? C'est exactement ce que fait l'API Chat Astrologie. Ce n'est pas qu'un endpoint de chatbot — c'est une plateforme agentique complète qui exécute toute la boucle d'appel d'outils côté serveur. Vous envoyez un message utilisateur, vous activez les outils voulus via astrology.enabled_tools, et le serveur invoque jusqu'à 40 outils d'astrologie — thèmes natals, transits, synastrie, rapports d'analyse complets, jusqu'à la génération de rapports PDF — en résolvant les données de thème natal à partir des identifiants de sujets (pas de dates hallucinées) et en retournant une réponse cohérente, le tout via un endpoint /chat/completions compatible OpenAI. Cela signifie que vous pouvez utiliser le SDK OpenAI standard en TypeScript, Python, Go ou tout autre langage. Pas de code d'intégration personnalisé. Pas de framework d'agent à construire. Pas de schémas d'outils à gérer. Le serveur classe aussi et relance automatiquement les pannes transitoires du modèle amont, si bien qu'un fournisseur capricieux produit une erreur propre plutôt qu'une réponse bloquée ou tronquée. Les solutions de chat astrologique existantes facturent 0,25$-0,87$ par requête, prennent 8-24 secondes à répondre, vous enferment dans des modèles propriétaires et utilisent des formats JSON personnalisés qui exigent du code d'intégration sur mesure. Nous sommes la seule plateforme qui livre un agent prêt à l'emploi avec support BYOK — choisissez votre propre LLM parmi GPT-5, Claude, Gemini, Grok ou l'un des 50+ modèles sur OpenRouter.

Comment fonctionne l'API Chat Agentique ?

L'API Chat Astrologie fonctionne comme un agent IA spécialisé qui maîtrise l'astrologie en profondeur.

Voici le flux : 1) Vous envoyez un message via l'endpoint standard OpenAI /chat/completions.

2) Le serveur injecte le contexte astrologique — les données de naissance de vos sujets, les outils actifs, les préférences linguistiques.

3) Le LLM décide quels outils appeler (calcul de thème natal, analyse de transits, rapport de synastrie, etc.).

4) Le serveur exécute ces outils en interne contre nos 82 endpoints d'astrologie — aucun appel API supplémentaire de votre côté.

5) Les résultats des outils sont renvoyés au LLM pour synthèse.

6) Vous recevez une interprétation cohérente, fondée sur des données planétaires réelles.

Toute la boucle d'outils s'exécute côté serveur en une seule requête.

Vous ne voyez jamais les messages d'appel d'outils — juste la réponse finale.

Avec le streaming activé (SSE), vous recevez aussi des événements d'extension en temps réel comme tool_start et tool_end, pour que votre interface affiche 'Calcul du thème de transit...' pendant que l'agent travaille.

Toute la boucle d'agent s'exécute côté serveur en un seul appel API

1 min read

Qu'est-ce que le BYOK et pourquoi est-ce important ?

BYOK — Bring Your Own Key — signifie que vous choisissez quel LLM propulse votre agent astrologique.

Toutes les autres solutions de chat astrologique sur le marché vous enferment dans un seul modèle propriétaire sans alternative — certaines ne divulguent même pas quel modèle elles utilisent.

Avec notre endpoint BYOK (/chat/completions/byok), vous passez votre propre clé API et identifiant de modèle.

Nous supportons trois fournisseurs : OpenAI (GPT-5, GPT-5-mini, GPT-5-nano, o3, o4), Anthropic (Claude Opus 4, Claude Sonnet 4, Claude Haiku 4) et OpenRouter (50+ modèles dont Gemini 3, Grok 4, Llama, Mistral, et plus).

Pourquoi est-ce important ? Contrôle des coûts — GPT-5-nano est 10x moins cher que GPT-5-pro.

Réglage qualité — Claude excelle dans l'interprétation nuancée, Gemini est plus rapide pour les requêtes simples.

Conformité — certaines entreprises exigent des fournisseurs de modèles spécifiques.

Le BYOK ne coûte que 2 credits/tour (nos frais de plateforme) plus ce que votre fournisseur LLM facture.

50+ modèles LLM disponibles — vous choisissez le coût, la qualité et le fournisseur

1 min read

Pourquoi est-ce la seule option compatible OpenAI ?

La compatibilité OpenAI signifie que vous utilisez le SDK OpenAI standard — la même bibliothèque cliente que des millions de développeurs connaissent déjà.

Pas de nouveau SDK à apprendre, pas de client HTTP personnalisé à construire.

En TypeScript : new OpenAI({ baseURL: 'https://api.astrology-api.io/api/v3/chat' }).

En Python : OpenAI(base_url='...').

C'est tout.

Votre code existant pour ChatGPT fonctionne avec des modifications minimales.

Cela signifie aussi une compatibilité instantanée avec chaque framework construit sur le protocole OpenAI : LangChain, LlamaIndex, Vercel AI SDK, Semantic Kernel, AutoGen, CrewAI.

Si votre framework parle OpenAI, il parle API Chat Astrologie.

Aucun autre fournisseur d'astrologie ne propose cela — les solutions existantes utilisent des endpoints personnalisés avec des formats de requête/réponse propriétaires, exigeant du code d'intégration sur mesure pour chaque plateforme que vous supportez.

Fonctionne avec tout SDK OpenAI — TypeScript, Python, Go, Rust et chaque framework IA

1 min read

Parfait pour le Vibe Coding — Construisez des Widgets d'Astrologie en Quelques Minutes

Parce que notre API utilise le protocole OpenAI standard, chaque outil de codage IA sait déjà comment travailler avec.

Dites à Lovable « Crée-moi un widget de chat astrologique avec cette API » et il génère un composant React fonctionnel — interface en streaming, formulaire de données de naissance, bulles de chat, tout.

Claude Code et Cursor peuvent échafauder une intégration complète à partir d'un seul prompt parce qu'ils comprennent nativement le SDK OpenAI.

Pas d'adaptateurs personnalisés, pas de documentation obscure, pas de débogage de formats JSON propriétaires.

La même chose s'applique à Windsurf, Bolt, Replit Agent et tout outil IA capable d'écrire du code pour l'API d'OpenAI.

C'est ce qui rend notre plateforme unique pour le vibe coding : vous décrivez le widget que vous voulez, l'IA le construit, et ça fonctionne du premier coup — parce que l'API sous-jacente est le même protocole sur lequel ces outils ont été entraînés.

Les vibe coders livrent des applications d'astrologie en heures, pas en semaines.

Widgets de chat, vérificateurs de compatibilité, générateurs d'horoscopes quotidiens, interpréteurs de thèmes natals — tout construit en décrivant ce que vous voulez à un assistant de codage IA.

Copiez ce prompt dans n'importe quel outil de codage IA pour démarrer instantanément :

Lovable, Claude Code, Cursor, Windsurf — n'importe quel outil de codage IA construit des intégrations fonctionnelles instantanément

2 min read

Que peuvent faire les 40 outils d'agent ?

La plateforme expose 40 outils que le LLM peut invoquer en cours de conversation, activés à la carte par requête via astrology.enabled_tools — rien ne s'exécute sans être listé explicitement.

Calculs de thèmes (10 outils) — natal, transit, synastrie, composite, davison, draconique, harmonique, héliocentrique, espace local et antiscia avec positions planétaires et aspects complets.

Rendu de thèmes (11 outils) — le même ensemble de thèmes en SVG, PNG, JPG, WebP ou PDF, stockés comme artefacts binaires avec des URLs partageables.

Rapports d'analyse (4 outils) — rapports natals complets, analyse lunaire, rapports de synastrie et rapports de relocalisation avec interprétations multi-sections.

Génération de rapports PDF (10 outils) — l'agent peut déclencher un PDF premium en pleine conversation : carte archétypale, composite, retour lunaire, feuille de route pluriannuelle, natal, relocalisation, retour de Saturne, retour solaire, synastrie ou rapport Kundli védique.

Recherches de données (3 outils) — positions planétaires actuelles, matrice d'aspects et heure astrologique actuelle.

Horoscope (1 outil) — horoscope quotidien personnalisé.

Rectification (1 outil) — recherche d'heure de naissance.

Comme les noms d'outils correspondent directement aux chemins d'endpoints (/charts/natal devient charts_natal, pas natal_chart), un nom mal orthographié est simplement ignoré — passez les noms exacts et attachez toujours les sujets avec birth_data, car les outils résolvent les sujets par identifiant plutôt que de lire les données de naissance depuis l'appel d'outil lui-même.

40 outils, activés à la carte — le modèle peut extraire un vrai thème ou générer un rapport PDF en pleine conversation

2 min read

Quelle est la fiabilité de l'API Chat ? Retry Automatique et Cache de Prompt

Une amélioration de fiabilité déployée classe désormais les pannes transitoires du modèle amont et les relance automatiquement, avant qu'elles n'atteignent votre application.

Auparavant, une réponse amont capricieuse pouvait bloquer la connexion ou retourner une réponse partielle tronquée ; désormais, une panne irrécupérable se traduit par une erreur 502 propre (hors streaming) ou un chunk de flux terminal (SSE) — votre gestion d'erreurs reçoit un signal prévisible au lieu d'un blocage silencieux.

Cela signifie sensiblement moins de sessions de chat cassées pour quiconque construit sur cet endpoint.

Un correctif associé a changé la façon dont le prompt système est assemblé : il est désormais divisé en un préambule toujours actif plus un bloc de règles d'utilisation d'outils qui ne se charge que lorsque des outils sont réellement résolus pour cette requête.

Cela a corrigé une classe d'échecs de complétion vide qui apparaissait de manière disproportionnée sur les niveaux de modèles plus légers et plus rapides, et cela signifie que le comportement de cache de prompt suit désormais l'ensemble d'outils que vous avez réellement activé plutôt qu'un prompt statique fixe — des coûts moins chers et plus prévisibles pour les appelants à fort volume qui varient enabled_tools d'une requête à l'autre.

Retry automatique sur les pannes amont transitoires, plus un cache qui suit les outils réellement activés

1 min read

Comment fonctionnent les sessions multi-sujets et les artefacts ?

Deux fonctionnalités qu'aucun concurrent ne propose : les sessions multi-sujets et les artefacts binaires.

Multi-sujets signifie que vous pouvez passer plusieurs thèmes natals dans une seule conversation — par exemple, 'me' et 'partner'.

Le LLM référence les sujets par leur identifiant sémantique lors de l'appel des outils, et le serveur les résout en données de naissance complètes.

Cela permet l'analyse de synastrie, les comparaisons de thèmes composites et les dynamiques familiales — le tout dans une seule session de chat, sans renvoyer les données de naissance.

Aucune autre API de chat ne supporte plus d'un sujet par conversation.

Les artefacts binaires permettent au chat de générer des fichiers téléchargeables.

Demandez 'Génère mon thème natal' et recevez une image SVG du thème.

Demandez 'Crée un rapport PDF' et obtenez un document professionnel multi-pages.

Les artefacts sont stockés dans Supabase avec des URLs partageables et une rétention de 24 heures.

Les sessions persistent via Redis avec un TTL glissant de 24 heures.

Passez le même session_id entre les tours et le serveur restaure l'historique de conversation, les sujets et le contexte — une vraie mémoire multi-tours sans gestion d'état côté client.

Sessions multi-sujets et artefacts binaires — uniques à notre plateforme

1 min read

Comment to_prompt_text() réduit les coûts en tokens LLM d'environ 60%

La plupart des développeurs ancrent leurs chatbots LLM en injectant le JSON complet du thème dans le prompt.

Un thème natal en JSON pèse 1 500 à 3 000 tokens — soit 0,015$-0,030$ par requête sur des modèles de classe GPT-4, et la fenêtre de contexte se remplit après quelques tours.

Pire, le modèle interprète souvent mal les codes obscurs comme 'Mars 0d 90.0 Saturn' et produit des interprétations fausses.

Notre formateur to_prompt_text() résout les deux problèmes.

Il convertit les données du thème en markdown compact et lisible avec des aspects en langage naturel.

Trois presets vous permettent de choisir le bon budget en tokens : 'minimal' (~150-250 tokens) couvre soleil/lune/asc, aspects clés, transits actuels — idéal pour les réponses de chat.

'full' (~500-800 tokens) ajoute dignités, maisons, modalités et secte pour des interprétations plus riches.

'traditional' (~600-900 tokens) inclut la profondeur hellénistique et médiévale — lots, almuten, hayz, antiscia — pour des lectures de style classique.

Insérez le markdown formaté dans n'importe quel prompt LLM (Claude, GPT, Gemini, Grok) pour ancrer le modèle dans des données de thème réelles sans injecter de JSON.

Économie moyenne de tokens : ~60% par rapport à un dump JSON brut, avec mesurablement moins d'hallucinations.

3 presets, 150-900 tokens, ~60% moins cher que les dumps JSON

2 min read

Aspects en Langage Naturel et Préfixes t./n.

Les LLMs lisent mieux le langage naturel que les codes — donc to_prompt_text() écrit les aspects comme le ferait un astrologue.

Au lieu de 'Mars 0d 90.0 Saturn' vous obtenez 'Mars square Saturn within 2°'.

L'orbe reste précis, mais le modèle l'analyse correctement du premier coup.

Quand le formateur inclut des données de transit en parallèle du thème natal, chaque planète est marquée d'un préfixe : 't.' pour transit, 'n.' pour natal.

Une lecture de transit montre donc 't.Jupiter trine n.Venus within 1°' — le modèle n'a jamais à deviner quelle planète appartient à quel thème.

Ce simple changement élimine la source la plus courante d'hallucinations dans les chatbots d'astrologie : la confusion d'identité planétaire entre les thèmes.

Combiné avec l'i18n sur 7 langues (EN, DE, ES, FR, IT, PT, RU — ~40 chaînes couvrant aspects, secte, dignités, maisons, modalités), vous pouvez livrer un chatbot multilingue qui ancre Claude ou GPT dans un contexte de thème localisé sans rien traduire côté client.

Aspects en langage naturel + préfixes transit/natal éliminent les lectures hallucinées

1 min read

Performance et Tarification face aux Concurrents

Parlons chiffres.

Les solutions de chat astrologique concurrentes les plus rapides prennent 8-12 secondes par réponse.

Les plans standards sur le marché tournent en moyenne à 19-24 secondes.

Notre couche de calcul répond en moins de 300ms — le temps de réponse total ne dépend que de la vitesse du LLM, généralement 2-5 secondes avec le streaming.

C'est 4-10x plus rapide.

Côté tarification, les alternatives facturent 0,25$-0,87$ par requête IA — en plus des frais d'abonnement mensuels.

Notre tarification a trois composantes : (1) credits de plateforme par tour — 25 en hosted ou 2 en BYOK, (2) credits endpoint pour chaque outil que l'agent appelle (ex.

thème natal = 1 credit, astrocartographie = 5 credits, rapport PDF = 35 credits), et (3) vos propres coûts LLM si vous utilisez BYOK.

Exemple : un tour d'interprétation natale coûte 25 + 1 = 26 credits en hosted (~0,02$), ou 2 + 1 = 3 credits en BYOK (~0,002$) plus ~0,003$ de coût LLM.

C'est 10-100x moins cher par tour de conversation que les alternatives.

Nous incluons le chat dans notre niveau gratuit standard : 50 requêtes par mois, sans carte bancaire.

4-10x plus rapide et 10-100x moins cher que les concurrents

1 min read

Use Cases

Applications Mobiles d'Astrologie

Ajoutez un astrologue IA conversationnel à votre application iOS ou Android. Les utilisateurs posent des questions en langage naturel et obtiennent des interprétations personnalisées étayées par de vrais calculs de thème. Le SDK OpenAI fonctionne nativement avec React Native et Flutter.

Plateformes de Rencontres et Compatibilité

Les sessions multi-sujets permettent l'analyse de compatibilité en temps réel entre deux utilisateurs. L'agent calcule la synastrie, les thèmes composites et les dynamiques relationnelles — le tout dans un seul flux de conversation.

Pipelines de Génération de Contenu

Générez des horoscopes personnalisés, des prévisions hebdomadaires et des rapports natals à grande échelle. Utilisez le BYOK avec un modèle économique (GPT-5-nano) et traitez en lot plus de 2 800 utilisateurs pour du contenu d'emails quotidiens ou de notifications push.

Plateformes de Bien-être et Santé Mentale

Intégrez des insights astrologiques dans les applications de pleine conscience, les outils thérapeutiques et les plateformes d'introspection. Le mode tradition psychologique fournit des interprétations de style jungien axées sur la croissance et la conscience de soi.

Plateformes SaaS d'Astrologie

Proposez l'agent entier en marque blanche comme votre propre produit. Les prompts système personnalisés définissent la personnalité, le BYOK contrôle les coûts, et la persistance de session permet des consultations multi-tours pour vos abonnés payants.

Frameworks d'Agents IA

Branchez-vous directement sur LangChain, CrewAI, AutoGen ou tout framework d'agent compatible OpenAI. Notre API devient un outil d'astrologie spécialisé dans votre système multi-agents — aucun adaptateur personnalisé nécessaire.

Vibe Coding avec les Outils IA

Demandez à Lovable, Claude Code, Cursor ou Windsurf de vous construire un widget d'astrologie — et obtenez une application fonctionnelle en quelques minutes. Parce que notre API suit le protocole OpenAI, les outils de codage IA génèrent des intégrations correctes du premier coup. Widgets de chat, générateurs d'horoscopes, vérificateurs de compatibilité — décrivez et livrez.

Technical Specifications

Protocole API	OpenAI Chat Completions (v1)
Endpoints	/chat/completions (hosted) + /chat/completions/byok
Formateur de Contexte LLM	to_prompt_text() avec 3 presets
Valeurs des Presets	minimal \| full \| traditional
Plage de Tokens par Preset	minimal 150-250 · full 500-800 · traditional 600-900
Format d'Aspect	'Mars square Saturn within 2°' (langage naturel)
Préfixes Transit/Natal	t.Jupiter trine n.Venus
Langues du Formateur de Prompt	7 (en, de, es, fr, it, pt, ru)
Chaînes i18n dans le Formateur	~40 sur 7 langues
Outils d'Agent	40, activés à la carte via astrology.enabled_tools
Gestion des Pannes Amont	Classification et retry automatiques, erreur 502 propre ou chunk de flux terminal en cas d'échec
Vitesse de Calcul	<300ms par appel d'outil
Temps de Réponse Total	2-5s avec streaming
Streaming	SSE avec événements d'extension tool_start/tool_end
Fournisseurs BYOK	OpenAI, Anthropic, OpenRouter (50+ modèles)
Modèle Hébergé	astro-default (optimisé pour l'astrologie)
Persistance de Session	Supportée par Redis, TTL glissant de 24h
Multi-Sujets	Sujets illimités par session
Artefacts Binaires	SVG, PNG, JPG, WebP, PDF via chat
Langues d'Interprétation	9 (en, de, fr, es, it, pt, ru, zh, hi)
Traditions	Classique, Psychologique, Événementielle, Universelle
Authentification	Bearer token (clé API)
Limitation de Débit	Par clé API, configurable

API Chat Astrologie vs Approche DIY avec Dump JSON

Feature	Astrology API	Others
Tokens de Prompt LLM (par thème)	150-900 (selon le preset)	1 500-3 000 (JSON brut)
Coût en Tokens par Prompt	~60% moins que le dump JSON	Coût plein à chaque tour
Lisibilité des Aspects	'Mars square Saturn within 2°'	'Mars 0d 90.0 Saturn' (obscur)
Désambiguïsation Transit/Natal	Préfixes t. / n. intégrés	Le modèle devine (hallucinations)
Contexte de Prompt Multilingue	7 langues (~40 chaînes i18n)	Anglais uniquement ou à traduire vous-même
Taux d'Hallucination	Faible — langage naturel ancré	Élevé — les codes obscurs embrouillent les LLMs
Compatible SDK OpenAI	Oui (drop-in)	Non (APIs personnalisées)
Choix de Modèle BYOK	50+ modèles (3 fournisseurs)	Modèle propriétaire verrouillé
Boucle d'Agent Côté Serveur	40 outils, activés à la carte	À construire soi-même
Gestion des Pannes Amont	Retry automatique + signal d'erreur propre	Blocages silencieux ou sortie tronquée
Sessions Multi-Sujets	Sujets illimités	Un seul thème natal
Artefacts Binaires	PDF, SVG, PNG via chat	Non disponible
Temps de Réponse	2-5s (streaming)	8-24 secondes
Prix par Requête	0,001$-0,02$	0,25$-0,87$
Niveau Gratuit	50 requêtes/mois	Aucun ou sandbox payant
Outils de Codage IA (Vibe Coding)	Fonctionne instantanément (protocole OpenAI)	Formats propriétaires, codage manuel uniquement

APIs d'Astrologie Connexes

API Thème Natal

Calculez des thèmes natals complets avec positions planétaires, maisons et aspects

API Transits

Transits planétaires actuels — se combine avec to_prompt_text() pour le contexte de chatbot

API Astrologie Traditionnelle

Techniques helléniques et médiévales — correspond à la profondeur du preset 'traditional'

API Timing

Timing électionnel et événementiel — insérez dans les prompts de chat pour les questions de prévision

API Horaire

Endpoint horaire IA — se combine naturellement avec l'agent de chat pour les lectures basées sur des questions

API Synastrie

Analyse de compatibilité relationnelle entre deux thèmes

API Rapport PDF

Générez des rapports PDF d'astrologie professionnels multi-pages

Documentation API

Référence technique complète avec exemples interactifs

References & Standards

Swiss Ephemeris (DE431-based) — astronomical calculations source
NASA JPL Planetary Ephemerides — underlying ephemeris dataset
International Astronomical Union (IAU) — body designation and nomenclature standards
IANA Time Zone Database — timezone & DST resolution

Copiez ce prompt dans Lovable, Claude Code, Cursor ou tout outil de codage IA :

Build an astrology chat widget using the OpenAI SDK. Use base URL https://api.astrology-api.io/api/v3/chat and read the API docs at https://api.astrology-api.io/md/chat-completions for the full request schema. The widget should have: a birth data form (date, time, city), a streaming chat interface with message bubbles, and display tool call events (like 'Calculating natal chart...') as the agent works. Use the astrology namespace for subjects and enabled_tools as documented.

Tarifs Simples et Transparents

Commencez gratuitement, evoluez selon vos besoins. Pas de frais caches.

Toujours Gratuit

Sans Carte de Credit

Parfait pour apprendre, tester et petits projets personnels

100 appels API/mois

Cartes natales de base

5 systemes de maisons

Support communautaire

Pro

11€/mois

Pour petites apps et projets personnels

Tous les endpoints de base
12 systemes de maisons
Support email

Meilleur Rapport Qualite-Prix

Pro Plus

21€/mois

Pour apps en croissance et trafic moyen

Tous les endpoints ameliores
18 systemes de maisons
Interpretations IA
Support email prioritaire

Ultra

37€/mois

Pour applications d'astrologie professionnelles

Credit math ↓

Tous les endpoints premium
23 systemes de maisons
Interpretations IA avancees
Support prioritaire

Plans Haut Volume

Pour applications a echelle entreprise

Business

99€/mois

Pour applications a haut volume

Credit math ↓

TOUS les endpoints
Pret pour marque blanche
Affinage IA personnalise
Support telephonique

ILLIMITE

Enterprise

399€+par mois

Requetes illimitees avec infrastructure dediee

Infrastructure serveur dediee
Moins de 300ms garanti
Support dedie 24/7
99,99% uptime SLA

Tous les plans incluent documentation complete et SDKs

Questions? Parlez a notre equipe

Questions Fréquemment Posées sur l'API Chat Astrologie

Vraies réponses sur la plateforme agentique d'astrologie

Construisez Votre Stack Astrologique Complète

L'API Chat orchestre ces endpoints automatiquement, mais vous pouvez aussi les utiliser directement :

API Thème Natal calculs de thème bruts derrière le chat API Transits influences planétaires actuelles pour le contexte de prompt API Astrologie Traditionnelle profondeur hellénistique — correspond au preset 'traditional'API Timing timing électionnel et requêtes de prévision API Horaire endpoint horaire IA — se combine avec l'agent de chat API Synastrie analyse de relation et compatibilité API Rapport PDF documents professionnels multi-pages Serveur MCP Astrologie intégration Claude Desktop

Livrez des Chatbots d'Astrologie

Agent compatible OpenAI, 40 outils, BYOK, retry automatique sur les pannes amont et contexte to_prompt_text() en 7 langues. Réduisez les coûts en tokens LLM d'environ 60% par rapport au dump JSON brut.

Commencer Gratuitement Voir la Documentation API

50 requêtes gratuites/mois

Compatible SDK OpenAI

Aucun frais d'installation

Plus qu'un Chat. Construisez des Agents IA d'Astrologie

Voir l'Agent en Action

Injecter du JSON Brut dans les Prompts LLM Gaspille des Tokens et Provoque des Hallucinations

Contexte LLM Optimisé en Tokens + Plateforme d'Agent Complète en Une Seule API

Performance de la Plateforme

Fonctionnalités Complètes de la Plateforme d'Agent

Formateur de Contexte LLM to_prompt_text()

Bring Your Own Key (BYOK)

Streaming SSE et Événements

40 Outils Astrologiques Intégrés

Retry Automatique et Fiabilité

Multi-Sujets et Sessions

Prêt pour Widgets avec les Outils de Codage IA

Artefacts Binaires et Sorties

Qu'est-ce que l'API Chat Astrologie ? Guide Complet pour Développeurs

Comment fonctionne l'API Chat Agentique ?

Qu'est-ce que le BYOK et pourquoi est-ce important ?

Pourquoi est-ce la seule option compatible OpenAI ?

Parfait pour le Vibe Coding — Construisez des Widgets d'Astrologie en Quelques Minutes

Que peuvent faire les 40 outils d'agent ?

Quelle est la fiabilité de l'API Chat ? Retry Automatique et Cache de Prompt

Comment fonctionnent les sessions multi-sujets et les artefacts ?

Comment to_prompt_text() réduit les coûts en tokens LLM d'environ 60%

Aspects en Langage Naturel et Préfixes t./n.

Performance et Tarification face aux Concurrents

Use Cases

Applications Mobiles d'Astrologie

Plateformes de Rencontres et Compatibilité

Pipelines de Génération de Contenu

Plateformes de Bien-être et Santé Mentale

Plateformes SaaS d'Astrologie

Frameworks d'Agents IA

Vibe Coding avec les Outils IA

Technical Specifications

API Chat Astrologie vs Approche DIY avec Dump JSON

APIs d'Astrologie Connexes

API Thème Natal

API Transits

API Astrologie Traditionnelle

API Timing

API Horaire

API Synastrie

API Rapport PDF

Documentation API

References & Standards

Tarifs Simples et Transparents

Toujours Gratuit

Pro

Pro Plus

Ultra

Plans Haut Volume

Business

Enterprise

Questions Fréquemment Posées sur l'API Chat Astrologie

Qu'est-ce que l'API Chat Astrologie et en quoi diffère-t-elle d'un chatbot classique ?

Puis-je utiliser le SDK OpenAI Python ou TypeScript avec cette API ?

Quels modèles LLM sont supportés avec le BYOK ?

Combien coûte chaque tour de chat en credits ?

Comment fonctionne le chat multi-sujets pour la synastrie et la compatibilité ?

Le chat peut-il générer des rapports PDF et des images de thèmes SVG ?

Quelle est la rapidité de l'API Chat Astrologie comparée aux alternatives ?

Que sont les événements d'extension du streaming SSE ?

Comment fonctionnent les sessions et la mémoire de conversation ?

Quels langages de programmation et frameworks sont supportés ?

Est-ce juste un wrapper GPT ou cela utilise-t-il de vraies données astronomiques ?

Comment contrôler le style et la longueur de la réponse ?

Quelles traditions astrologiques et systèmes de maisons sont supportés ?

Puis-je proposer cela en marque blanche comme mon propre produit ?

Que se passe-t-il si un appel d'outil échoue pendant la conversation ?

Puis-je construire un widget d'astrologie avec Lovable, Claude Code ou Cursor ?

Comment l'API Chat Astrologie se compare-t-elle à la construction de la mienne avec RoxyAPI ou des endpoints de données bruts ?

Qu'est-ce que to_prompt_text() et pourquoi les développeurs de chatbots devraient-ils s'y intéresser ?

Quel preset devrais-je utiliser — minimal, full ou traditional ?

De combien le formateur de prompt réduit-il les coûts en tokens LLM ?

Quelles langues to_prompt_text() supporte-t-il ?

Comment les aspects sont-ils formatés en langage naturel ?

Que signifient les préfixes t. et n. dans la sortie formatée ?

L'API Chat peut-elle extraire mon vrai thème natal pendant une conversation ?

Quels outils l'IA peut-elle appeler ?

Que se passe-t-il si le modèle IA échoue en pleine réponse ?