Documentation API

API RESTful. Base URL : https://louana.echo-host.net

Authentification

Toutes les requêtes doivent inclure un header Authorization.

Authorization: Bearer lou_votre_clé_api

Endpoints

POST /api/v1/chat

Envoie un message au modèle et retourne une réponse.

Body

{
  "message": string  // requis
}

Réponse 200

{
  "response": string
}

Codes d'erreur

400	Message manquant ou invalide
401	Clé API invalide ou expirée
429	Quota dépassé
500	Erreur interne serveur

Exemple cURL

curl -X POST https://louana.echo-host.net/api/v1/chat \
  -H "Authorization: Bearer lou_votre_clé_api" \
  -H "Content-Type: application/json" \
  -d '{"message": "Bonjour"}'

GET /api/v1

Vérifie que l'API est en ligne et affiche les endpoints disponibles.

{
  "service": "Louana API",
  "version": "1.0",
  "status": "ok",
  "endpoints": ["/api/v1/chat", "/api/v1/stream-chat", "/api/v1/stats"]
}

POST /api/v1/stream-chat

Établit une connexion Server-Sent Events (SSE) pour recevoir la réponse de l'IA mot par mot en temps réel.

Body (JSON)

{
  "message": "Ton message ici"
}

Flux de données SSE

data: {"chunk": "Salut"}

data: {"chunk": " !"}

data: [DONE]

Codes d'état

200	Connexion établie (Content-Type: text/event-stream)
401	Clé API invalide
403	Quota épuisé ou accès non autorisé
500	Erreur interne serveur

Exemple cURL

curl -N -X POST https://louana.echo-host.net/api/v1/stream-chat \
  -H "Authorization: Bearer lou_votre_clé_api" \
  -H "Content-Type: application/json" \
  -d '{"message": "Bonjour Louana !"}'

Note: L'option -N est recommandée pour désactiver le buffering de cURL et voir le stream en direct.

GET /api/v1/stats

Retourne les informations de quota et d'utilisation du compte associé à la clé API.

Body

Aucun body requis

Réponse 200

{
  "quotaUsed": number,
  "quotaMax":  number
}

Codes d'erreur

401	Clé API invalide ou expirée
500	Erreur interne serveur

Exemple cURL

curl https://louana.echo-host.net/api/v1/stats \
  -H "Authorization: Bearer lou_votre_clé_api"