Subir videos

Subir videos se realiza enviando una solicitud PUT al endpoint /videos/upload para crear un objeto de video nuevo. Recibirás una respuesta con una URL firmada de S3 para subir el archivo de video.

Crear objeto de video

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 tienes un video con voz y quieres que la transcripción automática por IA arranque justo después de la codificación del video, puedes hacerlo añadiendo dos parámetros más en la solicitud PUT para crear el video nuevo:


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

Respuesta


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

Subir archivo de video

Sube el archivo de video con una solicitud PUT a la URL firmada que devolvió el paso anterior. Debes enviar el tipo MIME del archivo en la cabecera Content-Type. Puedes obtener el tipo MIME del video local mediante el elemento input de tipo archivo.

Para archivos grandes (más de 100 MB), te recomendamos usar la subida multiparte, que ofrece mayor fiabilidad y admite archivos de hasta 60 GB. También puedes usar la biblioteca Uppy para una implementación más sencilla con troceado automático y seguimiento del progreso.

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]
  ]
]);

Proceso de codificación

Cuando el archivo de video se haya subido, el video pasará a codificarse. El proceso puede tardar según el tamaño del video y la complejidad de la codificación.

Puedes comprobar el estado de codificación de un video llamando al endpoint /videos/[VIDEO_ID] como se describe en la sección Obtener un video.