Documentation API

L’API CatéGPT renvoie des réponses sourcées sur la foi catholique. Idéale pour intégrer l’assistant dans une application, un back-office ou un bot.

ℹ️

Vous cherchez à ajouter le chat à un site sans coder ? Utilisez plutôt le widget et les plugins. Pour une vue d’ensemble du projet, voir la documentation générale.

URL de base

https://categpt.chat

Authentification

L’API s’authentifie par clé API (jeton Bearer).

Créez un compte sur https://categpt.chat.
Ouvrez la page Développeur de votre compte.
Générez une clé API (cgpt_live_…). Elle n’est affichée qu’une seule fois — copiez-la immédiatement.
Envoyez-la dans l’en-tête Authorization.

Authorization: Bearer cgpt_live_votreCle

⚠️

Ne publiez jamais votre clé secrète côté navigateur ni dans un dépôt public. Traitez-la comme un mot de passe.

Crédits & facturation

L’usage est prépayé : créditez votre compte, puis chaque réponse est débitée. Le montant facturé correspond au coût du modèle multiplié par un coefficient (~2×). Une réponse n’est générée que si le solde est positif.

Point d’accès — Générer une réponse

POST /api/v1/answer
Content-Type: application/json
Authorization: Bearer cgpt_live_…

Paramètres (corps JSON)

Champ	Type	Requis	Description
`question`	string	oui	La question (1 à 4000 caractères).
`mode`	string	non	`quick` (défaut) ou `academic`.
`level`	string	non	`child`, `teen`, `catechesis`, `general` (défaut), `academic`, `priest`.
`language`	string	non	Code langue à 2 lettres (`fr`, `en`…). Détecté sinon.

Exemple de requête

curl -X POST https://categpt.chat/api/v1/answer \
  -H "Authorization: Bearer cgpt_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "question": "Que dit le Catéchisme sur l’Eucharistie ?",
    "mode": "academic",
    "level": "general"
  }'

Réponse

{
  "answer": "…texte avec des marqueurs [1], [2]…",
  "references": [
    {
      "source_type": "catechism",
      "title": "Catéchisme de l’Église catholique",
      "citation": "CEC 1373-1377",
      "url": "https://www.vatican.va/…",
      "verified": true,
      "language": "fr"
    }
  ],
  "usage": { "prompt_tokens": 1234, "completion_tokens": 567, "billed_usd": 0.012 },
  "language": "fr"
}

Types de sources (`source_type`)

bible, catechism, council, pontifical, canon_law, social_doctrine, church_father, church_doctor, other.

Exemples

JavaScript (fetch)

const res = await fetch("https://categpt.chat/api/v1/answer", {
  method: "POST",
  headers: {
    "Authorization": "Bearer cgpt_live_xxx",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ question: "Qui était saint Augustin ?" }),
});
const data = await res.json();
console.log(data.answer, data.references);

Python (requests)

import requests

r = requests.post(
    "https://categpt.chat/api/v1/answer",
    headers={"Authorization": "Bearer cgpt_live_xxx"},
    json={"question": "Qui était saint Augustin ?"},
)
data = r.json()
print(data["answer"])

Limites de débit

Jusqu’à 60 requêtes par minute et par clé. Au-delà, l’API renvoie 429.

Erreurs

Code HTTP	`error`	Signification
400	`invalid_request`	Requête mal formée.
401	`invalid_api_key`	Clé absente ou invalide.
402	`insufficient_credits`	Solde de crédits épuisé.
429	`rate_limited`	Trop de requêtes.
502	`upstream_error`	Erreur du modèle en amont.

Les erreurs sont renvoyées au format { "error": { "code": "…" } }.

💡

Bonnes pratiques. Mettez en cache les réponses fréquentes, gérez le code 402 en rechargeant vos crédits, et affichez toujours les references à côté de la réponse pour la transparence.

Intégration sans code

Pour ajouter le chat à un site sans développer, utilisez le widget et les plugins : voir la documentation du widget.