Transcribir un vídeo

La transcripción usa IA para generar una pista de texto a partir del audio de un vídeo. La pista de texto generada 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. El token de API que uses debe tener el permiso 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

Field	Required	Description
`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 devuelve de inmediato uno o varios registros de trabajos de transcripción. Los vídeos de más de 3 horas se dividen en varios trozos, 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 se completa, se añade al vídeo una pista de texto generada automáticamente y se rellena la transcripción. Sondea el endpoint obtener vídeo y lee texttracks y transcriptions (o autoTranscription) para obtener el resultado.

Transcribir automáticamente al subir

También puedes iniciar la transcripción automáticamente una vez que termina la codificación. Establece autoTranscribe: true y un language válido cuando creas un vídeo. Esto requiere el permiso create en lugar de update.


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