Télécharger des vidéos

Pour télécharger une vidéo, envoie une requête PUT à l’endpoint /videos/upload afin de créer un nouvel objet vidéo. Tu recevras une réponse contenant une URL S3 signée pour télécharger le fichier vidéo.

Créer l’objet vidéo

CURL


curl -X PUT https://app.ignitevideo.cloud/api/videos/upload \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"title": "Your video title", "visibility": "private" | "public"}'

JavaScript / Node.js


const data = {
  "title": "Your video title",
  "visibility": "private" | "public" // optional
  "categories": ["category-id", "..."] // optional
  "tags": ["tag-id", "..."] // optional
}
const response = await fetch(`https://app.ignitevideo.cloud/api/videos/upload`, {
method: 'PUT',
body: JSON.stringify(data),
headers: {
  'Authorization': 'Bearer YOUR_TOKEN',
  'Content-Type': 'application/json'
}
});

PHP


$client = new GuzzleHttp\Client();
$data = [
  "title" => "Your video title",
  "visibility" => "private" | "public" // optional
  "categories" => ["category-id", "..."] // optional
  "tags" => ["tag-id", "..."] // optional
];
 
$response = $client->request('PUT', 'https://app.ignitevideo.cloud/api/videos/upload', [
'body' => json_encode($data),
'headers' => [
  'Authorization' => 'Bearer YOUR_TOKEN',
  'Content-Type' => 'application/json'
]
]);

Si ta vidéo contient de la parole et que tu veux lancer la transcription automatique par IA juste après l’encodage de la vidéo, tu peux le faire en ajoutant deux paramètres supplémentaires lors de la requête PUT pour créer la nouvelle vidéo :


{ 
  ...,
  "language": string, // "de-DE" | "..."  locale of the spoken language
  "autoTranscribe": true
}

Réponse


{
  "videoId": "[VIDEO_ID]",
  "title": "Your video title",
  "signedUrl": "[SIGNED_URL]",
}

Télécharger le fichier vidéo

Envoie ton fichier vidéo en requête PUT vers l’URL signée renvoyée à l’étape précédente. Tu dois indiquer le type MIME du fichier dans l’en-tête Content-Type. Tu peux obtenir le type MIME depuis ton fichier vidéo local via l’élément input de type fichier.

Pour les gros fichiers (plus de 100 Mo), nous recommandons d’utiliser plutôt le téléchargement multipart, plus fiable et prenant en charge des fichiers jusqu’à 60 Go. Tu peux aussi utiliser la bibliothèque Uppy pour une implémentation plus simple avec découpage automatique et suivi de progression.

CURL


curl -X PUT [SIGNED_URL] \
  -H "Content-Type: [MIME_TYPE]" \
  --data-binary "@[PATH_TO_VIDEO_FILE]"

JavaScript / Node.js


const response = await fetch([SIGNED_URL], {
  method: 'PUT',
  body: [VIDEO_FILE],
  headers: {
    'Content-Type': [MIME_TYPE]
  }
});

PHP


$client = new GuzzleHttp\Client();
$response = $client->request('PUT', [SIGNED_URL], [
  'body' => [VIDEO_FILE],
  'headers' => [
    'Content-Type' => [MIME_TYPE]
  ]
]);

Processus d’encodage

Une fois le téléchargement du fichier vidéo terminé, la vidéo est encodée. Ce processus peut prendre du temps, selon la taille de la vidéo et la complexité de l’encodage.

Tu peux vérifier le statut d’encodage d’une vidéo en appelant l’endpoint /videos/[VIDEO_ID] comme décrit dans la section Obtenir une vidéo.