Référence API

Envoyer un message et recevoir une réponse générée par l'IA. L'historique de conversation est maintenu côté serveur.

Corps de la requête

Réponse

{
  "response": "L'informatique quantique utilise des qubits..."
}

Retourner l'historique complet de la conversation pour la session en cours.

Réponse

{
  "history": [
    {"role": "user", "content": "Bonjour"},
    {"role": "assistant", "content": "Bonjour ! Comment puis-je vous aider ?"}
  ]
}

Effacer l'historique de conversation et recommencer à zéro.

Réponse

{"message": "Conversation history cleared"}

Mettre à jour le prompt système qui guide le comportement de l'IA.

Corps de la requête

Réponse

{"message": "System prompt updated", "prompt": "Tu es un pirate..."}

Envoyer de l'audio, obtenir la transcription + réponse IA texte + réponse audio. Pipeline complet STT → Chat → TTS.

Requête

multipart/form-data avec un champ file contenant le fichier audio.

Réponse

{
  "transcription": "Qu'est-ce que l'IA ?",
  "response": "L'IA signifie...",
  "audio": "<MP3 encodé en base64>"
}

Transcrire un fichier audio en texte avec OpenAI Whisper.

Requête

multipart/form-data avec un champ file.

Réponse

{"text": "Bonjour, comment allez-vous ?"}

Convertir du texte en audio MP3 avec OpenAI TTS.

Corps de la requête

Réponse

Audio MP3 binaire (audio/mpeg).

Envoyer du texte, obtenir la réponse IA texte + réponse audio (Chat → TTS).

Corps de la requête

Réponse

{
  "response": "Voici ma réponse...",
  "audio": "<MP3 encodé en base64>"
}

Téléverser une vidéo → extraire l'audio → chat IA → réponse texte + audio.

Requête

multipart/form-data avec un champ file contenant la vidéo.

Téléverser une vidéo → extraire l'audio → transcrire en texte avec Whisper.

Envoyer du texte → chat → TTS → réponse texte + audio.

Corps de la requête

Téléverser une vidéo → extraire une image à 1 seconde → décrire avec AI Vision.

Générer du code à partir d'une description en langage naturel.

Corps de la requête

Réviser du code et retourner des commentaires sur les bugs, problèmes de sécurité et améliorations.

Corps de la requête

Expliquer ce qu'un morceau de code fait en langage simple.

Corps de la requête

Refactoriser du code pour une meilleure qualité, lisibilité et maintenabilité.

Corps de la requête

Soumettre une tâche pour exécution autonome par l'agent IA avec appel d'outils.

Corps de la requête

Réponse

{
  "result": "La réponse est 15.",
  "tools_available": ["calculator", "datetime_now", "text_transform", "json_extract"]
}

Retourner l'historique de conversation et d'utilisation des outils de l'agent.

Effacer l'historique de conversation de l'agent.

Décrire une image téléversée avec OpenAI Vision.

Requête

multipart/form-data avec un champ file.

Réponse

{"description": "Un coucher de soleil sur une chaîne de montagnes..."}

Répondre à une question spécifique sur une image téléversée.

Requête

multipart/form-data avec les champs file et question.

Générer une image à partir d'un prompt textuel avec DALL-E 3.

Corps de la requête

Réponse

{"url": "https://oaidalleapi...", "prompt": "Un chat avec un chapeau haut-de-forme"}

Générer un document Word (.docx) à partir de texte. Retourne un fichier binaire à télécharger.

Corps de la requête

Générer une présentation PowerPoint (.pptx) à partir de texte. Le texte long est automatiquement réparti sur plusieurs diapositives.

Générer un document PDF (.pdf) à partir de texte.

Requête base de données en langage naturel avec contrôle d'accès au niveau des lignes par rôle.

Corps de la requête

Réponse

{"answer": "Il y a eu 1 247 commandes passées en février."}

Retourner le schéma de la base de données (tables et colonnes).

Exécuter une requête SELECT ou SHOW brute. Rôle admin/entreprise uniquement.

Corps de la requête

Effacer l'historique de conversation du chatbot BD.

Sélectionner une base de données de travail après la connexion client.

Lister les entreprises auxquelles l'utilisateur appartient.

Sélectionner une base de données d'entreprise par numéro d'entreprise.

Traduire du texte vers une langue cible.

Corps de la requête

Réponse

{"translated": "Hello world", "target_language": "English"}

Résumer du texte avec style et longueur configurables.

Corps de la requête

Réponse

{"summary": "Un résumé concis du texte d'entrée..."}

Analyser le sentiment d'un texte — retourne l'étiquette de sentiment, le score de confiance et l'explication.

Corps de la requête

Réponse

{
  "sentiment": "positif",
  "confidence": 0.95,
  "explanation": "Langage fortement positif détecté"
}

Extraire des données structurées à partir de texte non structuré selon une description de schéma.

Corps de la requête

Réponse

{
  "data": {"nom": "Alice", "email": "alice@exemple.com", "telephone": "555-1234"}
}

Vérifier si un texte contient du contenu nuisible avec l'API de Modération OpenAI.

Corps de la requête

Réponse

{
  "flagged": false,
  "categories": {},
  "category_scores": {"violence": 0.0012, "hate": 0.0003}
}

Générer un vecteur d'embedding pour une chaîne de texte.

Corps de la requête

Réponse

{
  "embedding": [0.012, -0.034, 0.056, ...],
  "dimensions": 1536
}

Calculer la similarité cosinus entre deux textes (0 à 1).

Corps de la requête

Réponse

{"text1": "chat", "text2": "chaton", "score": 0.92}

Récupérer une URL et résumer son contenu, ou répondre à une question spécifique à son sujet.

Corps de la requête

Réponse

{
  "url": "https://exemple.com/article",
  "summary": "L'article traite de..."
}

Stocker une mémoire avec des métadonnées optionnelles. Un vecteur d'embedding est généré automatiquement pour le rappel sémantique.

Corps de la requête

Réponse

{
  "id": 0,
  "content": "L'utilisateur préfère le mode sombre",
  "metadata": {"category": "preferences"}
}

Rappeler les mémoires les plus pertinentes par similarité sémantique à une requête.

Corps de la requête

Réponse

{
  "memories": [
    {"id": 0, "content": "L'utilisateur préfère le mode sombre", "metadata": {}, "score": 0.92}
  ],
  "count": 1
}

Effacer toutes les mémoires stockées.

Réponse

{"message": "All memories cleared"}

Ingérer du texte brut dans un espace de noms. Le texte est automatiquement découpé et vectorisé.

Corps de la requête

Réponse

{"namespace": "mon-app", "chunks_added": 3, "source": "faq.md"}

Récupérer une URL, extraire le texte, découper, vectoriser et stocker. Protection SSRF.

Corps de la requête

Réponse

{"namespace": "mon-app", "chunks_added": 12, "source": "https://example.com/faq"}

Interroger une base de connaissances. Utilise le RAG pour trouver les passages pertinents et générer une réponse.

Corps de la requête

Réponse

{"answer": "Les retours sont acceptés sous 30 jours.", "sources": ["faq.md"], "namespace": "mon-app"}

Lister tous les espaces de noms avec leur nombre de passages.

Réponse

{"knowledge_bases": [{"namespace": "mon-app", "chunks": 15}]}

Supprimer tous les documents d'un espace de noms.

Corps de la requête

Réponse

{"message": "Knowledge base 'mon-app' cleared."}

Traduire du texte entre langues africaines (swahili, yoruba, haoussa, amharique, wolof, lingala, zoulou, etc.).

Corps de la requête

Réponse

{"translated": "Habari, u hali gani?", "target_language": "Swahili"}

Détecter dans quelle langue africaine un texte est écrit.

Corps de la requête

Réponse

{"language": "Swahili", "confidence": 0.95, "script": "Latin", "region": "Afrique de l'Est"}

Lister toutes les langues africaines supportées.

Réponse

{"languages": ["Swahili", "Yoruba", "Hausa", "Amharic", "Wolof", "Lingala", "Zulu", "..."]}

Transcrire de l'audio avec support des langues africaines. Envoyez l'audio en données multipart avec un indice language optionnel (ISO-639-1).

Champs du formulaire

Réponse

{"text": "Habari yako"}

Convertir du texte en langue africaine en parole. Retourne des octets audio/mpeg.

Corps de la requête

Discuter avec une IA experte en géographie, histoire, cultures, économie et actualités africaines.

Corps de la requête

Réponse

{"response": "Les principales exportations du Kenya comprennent le thé, le café, les produits horticoles..."}

Effacer l'historique de conversation du chat contextuel africain.

Réponse

{"message": "African chat history cleared."}

Modérer du contenu en langues africaines, détectant les discours haineux, le tribalisme et la désinformation.

Corps de la requête

Réponse

{"flagged": false, "reason": "", "language_detected": "Swahili", "categories": {"hate_speech": false, "tribalism": false, "misinformation": false, "violence": false, "discrimination": false}}

Formater un montant dans une devise africaine (CFA, Naira, Shilling, Rand, Cedi, etc.).

Corps de la requête

Réponse

{"formatted": "KSh 1 500,50", "currency_code": "KES", "currency_name": "Shilling kényan", "amount": 1500.5}

Estimer la conversion entre devises africaines.

Corps de la requête

Réponse

{"source_amount": 1000, "source_currency": "KES", "target_amount": 3150, "target_currency": "NGN", "rate": 3.15, "note": "Taux approximatif"}

Lister toutes les devises africaines supportées.

Réponse

{"currencies": {"KES": "Shilling kényan", "NGN": "Naira nigérian", "ZAR": "Rand sud-africain", "...": "..."}}

Poser une question sur les services d'argent mobile (M-Pesa, MTN MoMo, Orange Money, Airtel Money, EcoCash).

Corps de la requête

Réponse

{"response": "Pour envoyer de l'argent via M-Pesa, composez *334# et suivez les instructions..."}

Analyser un message de transaction d'argent mobile ou un code USSD en données structurées.

Corps de la requête

Réponse

{"provider": "M-Pesa", "transaction_type": "send", "amount": 500, "currency": "KES", "recipient": "+254712345678", "reference": "QH45G7Z2", "status": "completed", "raw_text": "Confirmé. Ksh500 envoyé à +254712345678"}

Poser des questions sur l’agriculture, les cultures et l’élevage africains.

Corps de la requête

Réponse

{"response": "Le manioc est l'une des cultures les plus importantes en Afrique subsaharienne..."}

Questions d’éducation et de préparation aux examens africains (WAEC, JAMB, KCSE, Baccalauréat).

Corps de la requête

Réponse

{"response": "Dans le programme de biologie du WAEC, la photosynthèse est..."}

Questions sur le droit des affaires et la réglementation en Afrique.

Corps de la requête

Réponse

{"response": "Au Nigeria, la loi CAMA exige que..."}

Obtenir un proverbe africain par thème ou culture.

Corps de la requête

Réponse

{"proverb": "Si tu veux aller vite, va seul...", "language": "Igbo", "culture": "Igbo", "meaning": "...", "theme": "unité"}

Raconter un conte, une légende ou une histoire folklorique africaine.

Corps de la requête

Réponse

{"story": "Il y a longtemps, au pays des Ashanti..."}

Streamer une réponse de chat token par token. Retourne text/event-stream.

Corps de la requête

Réponse (flux SSE)

data: Il
data: était
data: une
data: fois
data: [DONE]

Envoyer plusieurs messages et recevoir des réponses individuelles pour chacun.

Corps de la requête

Réponse

{
  "results": ["Réponse au premier...", "Réponse au second..."],
  "count": 2
}

Connexion client — valide contre customers_credential + customers, nécessite is_verified = 'yes'.

Corps de la requête

Réponse

{
  "access_token": "eyJhbGciOi...",
  "token_type": "bearer",
  "role": "customer",
  "firstname": "Alice"
}

Connexion admin — nécessite company_employee_links.is_admin = 1 et status = 1.

Connexion employé — nécessite company_employee_links.status = 1. Le JWT inclut allow_tables_list.

Connexion entreprise — nécessite customers.type = 'webcompany'. Mêmes droits d'accès que l'admin.

Obtenir les statistiques d'utilisation de l'API pour l'utilisateur actuellement authentifié.

Vérification de santé — retourne le statut de l'API et la version. Aucune authentification requise.

Réponse

{"status": "ok", "version": "0.1.0"}