Développeurs

Intégrer Galien.AI par API ou MCP

L'API permet à un groupement ou à un éditeur de poser une question depuis son propre outil et de recevoir la réponse documentaire complète de Galien.AI, avec ses sources et son disclaimer. Le MCP permet à un assistant IA d'interroger le même service.

Obtenir une clé

Pour demander un accès partenaire, contactez Galien.AI depuis la page de contact. Galien.AI remet une clé au partenaire désigné, avec un plafond de questions par jour et par mois. Cette même clé sert pour l'API et le MCP.

Les modalités d'usage figurent dans les conditions d'utilisation de l'API et du MCP. Les questions ne doivent contenir aucune donnée de santé personnelle ni aucune donnée identifiante d'un patient.

Poser une question par API

Envoyez une requête POST avec un corps JSON contenant uniquement question, une chaîne non vide de 10 000 caractères au maximum. Chaque appel porte une question complète, sans historique. Les commandes slash ne sont pas disponibles.

curl -X POST https://www.galienai.fr/api/v1/ask \
  -H 'Authorization: Bearer <clé>' \
  -H 'Content-Type: application/json' \
  -d '{"question": "Quel est le taux de remboursement de DOLIPRANE 500 mg, comprimé ?"}'

Remplacez <clé> par la clé remise par Galien.AI. L'exemple contient uniquement une question, sans réponse médicale.

Forme de la réponse

En cas de succès, le statut est 200 et le corps est un objet JSON contenant les trois champs suivants.

answer: Une chaîne contenant le texte complet de la réponse, disclaimer compris. En API, affichez ce texte tel quel avec ses sources, sans reformulation.
sources: Un tableau d'objets avec title (titre) et url (lien) pour chaque source.
traceId: Une chaîne identifiant la requête.

Erreurs de l'API

En cas d'erreur, le corps JSON contient le champ error, par exemple {"error":"unauthorized"}.

Statuts HTTP et codes d'erreur de POST /api/v1/ask
HTTP	Erreur et signification
400	`invalid_question`Le corps doit être un objet JSON contenant uniquement question, une chaîne non vide.
400	`personal_data`Des données personnelles ont été détectées dans la question.
400	`prompt_injection`Une instruction non autorisée a été détectée.
400	`slash_commands_unavailable`Les commandes commençant par / ne sont pas disponibles.
400	`request_aborted`La requête a été annulée avant l'appel au moteur.
401	`unauthorized`La clé est absente, mal formée, inconnue ou révoquée.
404	`not_found`L'accès à l'API est désactivé.
413	`question_too_long`La question dépasse 10 000 caractères.
429	`daily_limit`Le plafond journalier de la clé est atteint.
429	`monthly_limit`Le plafond mensuel de la clé est atteint.
502	`answer_unavailable`Aucune réponse exploitable n'a pu être rendue.
503	`engine_unavailable`Le moteur n'est pas disponible pour le moment.
503	`chat_disabled`Le service est temporairement suspendu.
503	`request_not_counted`La requête n'a pas pu être comptabilisée (clé révoquée ou délai dépassé) ; aucune réponse n'est servie.
503	`service_unavailable`Le service est temporairement indisponible.

Configurer le MCP

Dans un client MCP prenant en charge un serveur distant par HTTP et un en-tête d'authentification, renseignez les paramètres suivants.

URL du serveur: https://www.galienai.fr/api/v1/mcp
Transport: HTTP (Streamable HTTP)
En-tête: Authorization: Bearer <clé>
Outil: poser_question, avec un objet contenant uniquement le champ question, comme dans le corps JSON de l'exemple API.

L'outil rend la réponse complète, les sources et la consigne de les citer et de conserver le disclaimer de Galien.AI. En MCP, l'assistant peut reformuler la réponse à condition de citer ces sources et de conserver ce disclaimer.

← Revenir à l'assistant