PicassoIA Video

1. 1

   Créez la prédiction

   Envoyez l'entrée dans un POST. L'API répond 201 immédiatement, sans attendre le résultat : la prédiction est à l'état starting, avec une estimation dans eta et l'adresse à interroger dans urls.get.

   Requête

   curl -s -X POST https://api.picassoia.com/v1/models/picassoia/picassoia-video/predictions \
     -H "Authorization: Bearer $PICASSOIA_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{"input":{"prompt":"waves crashing on a rocky shore at night, cinematic"}}'

   Réponse · 201 Createdstarting

   {
     "id": "api_3f9c2b7e8d1a4c6f9e0b1a2c3d4e5f60",
     "model": "picassoia/picassoia-video",
     "input": {
       "prompt": "waves crashing on a rocky shore at night, cinematic",
       "resolution": "480p",
       "duration": 5,
       "aspect_ratio": "16:9",
       "save_audio": true,
       "enhance_prompt": true
     },
     "output": null,
     "error": null,
     "status": "starting",
     "created_at": "2026-10-01T09:30:00.000Z",
     "started_at": null,
     "completed_at": null,
     "metrics": {
       "predict_time": null
     },
     "urls": {
       "get": "https://api.picassoia.com/v1/predictions/api_3f9c2b7e8d1a4c6f9e0b1a2c3d4e5f60",
       "cancel": "https://api.picassoia.com/v1/predictions/api_3f9c2b7e8d1a4c6f9e0b1a2c3d4e5f60/cancel"
     },
     "eta": {
       "seconds": 60,
       "next_poll_in_seconds": 30
     }
   }

2. 2

   Interrogez-la jusqu'à ce qu'elle soit terminée

   Interrogez de nouveau urls.get au bout de eta.next_poll_in_seconds secondes : à la moitié du temps estimé, lorsque le temps estimé est atteint, puis toutes les 2 secondes. Interroger plus souvent ne vous donnera pas le résultat plus tôt.

   États :startingprocessingsucceeded·failed·canceled

   Requête

   # Repeat after eta.next_poll_in_seconds until status is
   # succeeded, failed or canceled.
   curl -s https://api.picassoia.com/v1/predictions/api_3f9c2b7e8d1a4c6f9e0b1a2c3d4e5f60 \
     -H "Authorization: Bearer $PICASSOIA_API_KEY"

   Réponse · 200 OK · en coursprocessing

   {
     "id": "api_3f9c2b7e8d1a4c6f9e0b1a2c3d4e5f60",
     "status": "processing",
     "output": null,
     "eta": {
       "seconds": 30,
       "next_poll_in_seconds": 30
     }
   }

   Seuls les champs qui changent sont affichés ; les autres sont identiques à ceux de l'étape 1.

3. 3

   Lisez le résultat

   Lorsque status vaut succeeded, output est l'URL du MP4. Téléchargez les fichiers que vous souhaitez conserver.

   Si status vaut failed, error en indique la raison ; canceled signifie que la prédiction a été annulée avant la fin. Ces trois états sont définitifs : la prédiction ne change plus jamais.

   Requête

   # The last poll holds the result: "output" when "status" is succeeded,
   # "error" when it is failed. With jq, just those three fields:
   curl -s https://api.picassoia.com/v1/predictions/api_3f9c2b7e8d1a4c6f9e0b1a2c3d4e5f60 \
     -H "Authorization: Bearer $PICASSOIA_API_KEY" | jq '.status, .output, .error'

   Réponse · 200 OK · terminéesucceeded

   {
     "id": "api_3f9c2b7e8d1a4c6f9e0b1a2c3d4e5f60",
     "status": "succeeded",
     "output": "https://…/output.mp4",
     "error": null,
     "completed_at": "2026-10-01T09:30:54.000Z",
     "metrics": {
       "predict_time": 52.8
     },
     "eta": null
   }

   Seuls les champs qui changent sont affichés ; les autres sont identiques à ceux de l'étape 1.

Les identifiants, les horodatages et les URL de ces réponses sont des exemples : les vôtres arrivent dans chaque réponse.