Envoi des vidéos

Il y a deux façons de transmettre une vidéo à Pixamake.

Option A : envoi direct

1. POST /v1/uploads avec le nom, le type et la taille exacte du fichier.
2. PUT du fichier sur l'upload_url renvoyée, avec le même Content-Type.
3. Création de la tâche avec upload_id.

curl https://pixamake.ai/v1/uploads \
  -H "Authorization: Bearer $PIXAMAKE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"filename": "pub.mov", "content_type": "video/quicktime", "size_bytes": 18734102}'

L'URL d'envoi est valable une heure et n'accepte qu'un fichier de la taille et du type déclarés. Un envoi jamais rattaché à une tâche est supprimé après 24 heures. Un envoi ne sert qu'à une seule tâche.

Option B : URL publique

Passez video_url à la création de la tâche. L'URL doit :

• utiliser http ou https et être joignable depuis internet (adresses privées et locales refusées) ;
• accepter les requêtes partielles HTTP (statut 206), comme la plupart des CDN et stockages objet ;
• pointer vers un MP4 ou MOV de 2 Go maximum.

Pixamake lit tout de suite la durée et la résolution, pour réserver le prix exact, puis copie le fichier au lancement de la tâche.

Vidéos acceptées

Les erreurs à cette étape utilisent le statut 422 avec les codes unsupported_format, unreadable_video, video_too_long, resolution_too_high, et 413 video_too_large au-delà de 2 Go.