API PicassoIA
Prédictions
Une prédiction est une exécution d'un modèle : vous la créez, vous l'interrogez et vous lisez sa sortie.
Créer une prédiction
POST /v1/models/{owner}/{name}/predictions avec le corps { "input": { … } }.
- L’API répond dès que le modèle a accepté la tâche, généralement en quelques secondes, avec la prédiction à l’état
starting. Elle n’attend jamais le résultat. - Si la prédiction échoue immédiatement, la réponse reste
201, avec la prédiction à l’étatfailedet sonerror. C’est le cas, par exemple, lorsque l’entrée est refusée par le filtre de sécurité. - Si aucune prédiction n’a été créée, la réponse est une erreur : entrée non valide, forfait, trop de prédictions en cours, service indisponible.
Lister les prédictions
GET /v1/predictions renvoie vos prédictions effectuées via l’API, 50 par page, de la plus récente à la plus ancienne, toutes clés confondues.
nextest l’URL de la page suivante (…/v1/predictions?cursor=…), ounullsur la dernière page.previousvaut toujoursnull.- Les prédictions que vous avez supprimées sur picassoia.com sont exclues.
Une prédiction est accessible avec n’importe laquelle de vos clés, et n’est jamais visible par quelqu’un d’autre.
L’objet prédiction
États.
La distinction entre starting et processing est une estimation, établie à partir de la position dans la file au moment de la création. Une nouvelle prédiction est toujours à l’état starting. Les trois derniers états sont définitifs : une prédiction qui a atteint l’un d’eux ne change plus jamais.
Erreurs d’une prédiction échouée. Le champ error d’une prédiction échouée contient l’un des messages suivants :
- L’entrée ou la sortie a été refusée par le filtre de sécurité. Le message se termine par
(SAFETY_CHECKER_PICASSO_FILTER_S4). The prediction failed. You can try again.The prediction timed out. You can try again.La prédiction ne s’est pas terminée dans un délai de 3 heures.
Sorties. Les URL de sortie sont hébergées par PicassoIA. Téléchargez les fichiers que vous souhaitez conserver.
Interrogation périodique et ETA
eta.next_poll_in_seconds vous indique quand la prochaine interrogation sera utile :
- À la moitié du temps estimé.
- Lorsque le temps estimé est atteint.
- Puis toutes les 2 secondes.
Exemple avec une estimation de 10 s : interrogez au bout de 5 s, puis de 10 s, puis toutes les 2 s. Interroger plus souvent ne vous donnera pas le résultat plus tôt.
Annulation
POST /v1/predictions/{id}/cancel :
Une prédiction annulée libère immédiatement sa place parmi vos 5 prédictions en cours.