Subir vídeos

Para subir vídeos, envía una solicitud PUT al endpoint /videos/upload y crea un objeto de vídeo nuevo. Recibirás una respuesta con una URL firmada de S3 a la que subir el archivo de vídeo.

Crear un vídeo requiere el permiso videos.create. Establecer visibility en public también requiere videos.publish. Sin publish, el vídeo se crea como private. Consulta Autenticación.

Crear objeto de vídeo

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 vídeo con contenido hablado y quieres que la autotranscripción con IA empiece justo después de la codificación, puedes hacerlo estableciendo dos parámetros adicionales en la solicitud PUT al crear el vídeo 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 vídeo

Sube tu archivo de vídeo con una solicitud PUT a la URL firmada que recibiste en el paso anterior. Debes pasar el tipo MIME del archivo en el encabezado Content-Type. Puedes obtener el tipo MIME de tu archivo de vídeo local mediante el elemento de entrada de archivo.

Para archivos grandes (más de 100 MB), recomendamos usar multipart upload, 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 fragmentación automática 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

Después de subir el archivo de vídeo, el vídeo se codifica. Este proceso puede tardar un tiempo, según el tamaño del vídeo y la complejidad de la codificación.

Puedes consultar el estado de codificación de un vídeo llamando al endpoint /videos/[VIDEO_ID] como se describe en la sección obtener vídeo.