Documentation · Référence

L’API HTTP

Un contrat unique pour tous les modèles : seul le JSON d’entrée et de sortie change. Les exemples visent l’application locale (port 8787 par défaut).

Les routes

Conventions

Ce qui est commun à tous les modèles

JSON en UTF-8. Les erreurs ont toujours la forme {"error": "message lisible"} avec le code HTTP adapté.

Toute route /api/ (sauf /api/health) exige le jeton d’accès, dans l’en-tête X-PF-Token ou Authorization: Bearer. Le jeton est affiché au démarrage de « serve », ou fixé avec --token ou PF_API_TOKEN.

Un en-tête Origin étranger est refusé (403), et en édition Community toute requête dont l’en-tête Host n’est pas localhost reçoit 421.

Entrées par modèle

Un exemple par modèle

Chaque requête est un POST sur /api/demo/infer. Pour les modèles qui génèrent, /api/demo/stream renvoie le même résultat en flux.

Champs d’entrée

Flux

Réponses en flux (SSE)

Les modèles qui génèrent répondent par une suite de trames. Fermer la connexion interrompt la génération côté serveur.

Limites et codes d’erreur

Une question sur l’intégration ?

Décrivez votre application et la machine cible, nous vous répondons avec des chiffres.