Documentation · Référence
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).
Métadonnées du moteur : nom, version, poids en mémoire, schéma d’entrée.
Une inférence. Réponse JSON complète.
Même entrée, réponse en flux SSE (modèles qui génèrent : Plume, Nashira, Iris, Castor).
État de l’application : édition, version, modèle installé, licence.
Sonde de santé, sans jeton.
Conventions
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
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.
message (texte), think (booléen, raisonnement à voix haute), max_tokens et temperature optionnels
text : un texte en français. Réponse : la probabilité de chacune des 25 émotions, phrase par phrase, et pour l’ensemble.
text, options (de 2 à 100 libellés), temperature et min_entailment optionnels. Réponse : une décision, un score par option.
prompt, max_tokens (512 au plus), temperature et language optionnels. Réponse : text, tokens, tokensPerSecond, finish.
prompt, steps et seed optionnels. Une même graine redonne la même image.
text, to (langue cible, obligatoire), from et beam optionnels. En développement.
Flux
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.
16 Ko au plus par requête (413 au-delà).
Une inférence à la fois par instance : 503 si le moteur est occupé, à réessayer.
Entrée invalide, avec un message précis.
Jeton absent ou faux · origine étrangère · hôte non local.
Moteur occupé, ou modèle pas encore installé (« plume model download »).
Erreur d’inférence.
Décrivez votre application et la machine cible, nous vous répondons avec des chiffres.