Transcripción con IA
Cada grabación completada se transcribe automáticamente — marcas de tiempo a nivel de palabra, tres formatos de salida, detección automática de idioma.
Transcripción con IA
VIDTREO AI transcribe automáticamente cada grabación completada. No existe una API de transcripción que llamar ni audio que extraer: cuando un video termina de subirse en un entorno con la transcripción habilitada, el pipeline se ejecuta por sí solo y notifica a tus sistemas mediante webhooks cuando la transcripción está lista.
La grabación se completa
→ Se extrae el audio del video
→ Se transcribe con marcas de tiempo a nivel de palabra
→ Se detecta el idioma automáticamente
→ La transcripción se almacena en tres formatos (VTT, JSON, TXT)
→ Se dispara el webhook transcriptions.transcription.completedHabilitar la Transcripción
La transcripción se configura por entorno:
Inicia sesión en el Dashboard de VIDTREO
Abre tu entorno y ve a Configuración → General
Activa Transcripción con IA
A partir de ese momento, cada grabación que se completa en el entorno se transcribe automáticamente. Los videos subidos mientras la opción estaba desactivada no se procesan retroactivamente.
El idioma se detecta automáticamente: no existe un parámetro de idioma. Los usuarios pueden grabar en español, portugués, inglés o cualquier otro idioma hablado, y la transcripción se devuelve en ese idioma.
Formatos de Salida
Cada transcripción genera tres archivos:
| Formato | Tipo de contenido | Diseñado para |
|---|---|---|
vtt | text/vtt | Subtítulos WebVTT: se insertan directamente en un elemento <track> para una reproducción accesible |
json | application/json | Segmentos a nivel de palabra con tiempos start/end: búsqueda, interfaces de salto a un momento específico, alimentar LLMs |
txt | text/plain | Transcripción en texto plano: indexación de texto completo, resúmenes, archivo |
El formato JSON es un arreglo de segmentos a nivel de palabra:
[
{ "word": "welcome", "start": 1.02, "end": 1.38 },
{ "word": "to", "start": 1.38, "end": 1.5 },
{ "word": "the", "start": 1.5, "end": 1.62 }
]Ciclo de Vida de la Transcripción
| Estado | Significado |
|---|---|
PENDING | En cola, esperando ser procesada |
PROCESSING | Extracción de audio y transcripción en curso |
COMPLETED | Los archivos de la transcripción están disponibles |
FAILED | El procesamiento falló: se puede volver a procesar desde el dashboard |
SKIPPED | El video no tiene pista de audio: no hay nada que transcribir |
Un video grabado sin micrófono (por ejemplo, una grabación de pantalla silenciada) da como resultado SKIPPED, no FAILED. Gestiona ambos estados si tu flujo de trabajo espera una transcripción para cada video.
Obtener una Transcripción mediante la API
Obtén la transcripción de cualquier video con tu API key (requiere el permiso get_video):
curl https://core.vidtreo.com/api/v1/videos/{videoId}/transcription \
-H "Authorization: Bearer vt_live_xxxxxxxxxxxxxxxxxxxx"Respuesta:
{
"id": "b7e2...",
"videoId": "vid_...",
"environmentId": "env_...",
"status": "COMPLETED",
"language": "en",
"wordCount": 812,
"duration": 294.5,
"files": {
"vtt": { "url": "https://...", "expiresAt": "...", "contentType": "text/vtt" },
"json": { "url": "https://...", "expiresAt": "...", "contentType": "application/json" },
"txt": { "url": "https://...", "expiresAt": "...", "contentType": "text/plain" }
},
"createdAt": "2026-08-03T14:17:00.000Z",
"completedAt": "2026-08-03T14:22:07.000Z"
}files es null hasta que status sea COMPLETED.
Las URLs de los archivos son prefirmadas y expiran 5 minutos después de generarse. Obtén el contenido apenas las recibas, guarda lo que necesites de tu lado y solicita URLs nuevas a este endpoint cada vez que vuelvas a necesitar los archivos. Nunca persistas las URLs en sí.
Cómo Recibir Notificaciones
Hacer polling a este endpoint funciona, pero la integración prevista está basada en eventos: suscribe un endpoint de webhook al evento transcriptions.transcription.completed y recibe los archivos de la transcripción —además de tus propios metadatos— en el momento en que finaliza el procesamiento.
Consulta Webhooks para conocer la forma del payload, la verificación de firma y las garantías de entrega.