Transcribir un vídeo

La transcripción usa IA para generar un Text track a partir del audio de un vídeo. El text track generado se añade al vídeo como una pista de subtítulos generada automáticamente y también está disponible como transcripción en texto plano.

Las funciones de IA requieren un plan con las funciones de IA habilitadas. La Clave API que uses debe tener el permiso videos.update.

Iniciar transcripción

Inicia una transcripción enviando una solicitud POST al endpoint /videos/:id/transcribe. El campo language indica al motor de transcripción en qué idioma está el audio.

CURL


curl -X POST https://app.ignitevideo.cloud/api/videos/[VIDEO_ID]/transcribe \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"language": "en"}'

JavaScript / Node.js


const data = {
language: "en" // BCP-47 language tag, e.g. "en", "en-US", "de", "de-DE"
};
 
const response = await fetch('https://app.ignitevideo.cloud/api/videos/[VIDEO_ID]/transcribe', {
method: 'POST',
body: JSON.stringify(data),
headers: {
  'Authorization': 'Bearer YOUR_TOKEN',
  'Content-Type': 'application/json'
}
});
 
const result = await response.json();

PHP


$client = new GuzzleHttp\Client();
$data = [
"language" => "en" // BCP-47 language tag, e.g. "en", "en-US", "de", "de-DE"
];
 
$response = $client->request('POST', 'https://app.ignitevideo.cloud/api/videos/[VIDEO_ID]/transcribe', [
'body' => json_encode($data),
'headers' => [
  'Authorization' => 'Bearer YOUR_TOKEN',
  'Content-Type' => 'application/json'
]
]);
 
$result = json_decode($response->getBody(), true);

Parámetros

Campo	Obligatorio	Descripción
`language`	Sí	Idioma del audio como etiqueta BCP-47 (`en`, `en-US`, `de`, `de-DE`, …).

Respuesta

La transcripción se ejecuta de forma asíncrona. La solicitud responde de inmediato con uno o más registros de trabajo de transcripción. Los vídeos de más de 3 horas se dividen en varios fragmentos, por lo que la respuesta puede contener más de una entrada.


[
  {
    "id": string,
    "status": "QUEUED" | "IN_PROGRESS" | "COMPLETED" | "FAILED" | "NONE",
    "language": string,
    "jobName": string
  }
]

Cuando un trabajo termina, se añade al vídeo un text track generado automáticamente y se completa la transcripción. Consulta el endpoint obtener vídeo y lee texttracks y transcriptions (o autoTranscription) para recuperar el resultado.

Transcribir automáticamente al subir

También puedes iniciar la transcripción automáticamente cuando termine la codificación. Establece autoTranscribe: true y un language válido al crear un vídeo. Esto requiere el permiso videos.create en lugar de videos.update.


{
  "title": "Your video title",
  "language": "en",
  "autoTranscribe": true
}