API de transcripción de YouTube para videos y Shorts

Integra la conversión de YouTube a texto en bases de conocimiento, productos educativos y flujos multimedia. Envía la URL de un video público, Short o enlace youtu.be y consulta la ubicación de la tarea para obtener resultados estructurados.

Crea texto que se pueda buscar a partir de videos de YouTube

Fast Transcriber genera una transcripción mediante su proceso multimedia y de voz a texto, por lo que tu aplicación no tiene que depender de una pista de subtítulos proporcionada por el creador. El texto y los segmentos completados usan el mismo formato que las demás tareas de la API.

Elige la URL correcta de un video o Short público de YouTube

Videos estándar: youtube.com/watch?v={video-id} es la forma canónica de una carga pública normal.
Shorts: youtube.com/shorts/{video-id} identifica un Short público sin tener que convertirlo primero en una URL watch.
Enlaces compartidos compactos: los enlaces youtu.be/{video-id} usan el mismo proceso después de resolver la redirección. Envía un video, no una página de lista de reproducción.

Inicio rápido: pon en la cola una transcripción de un video o Short público de YouTube

Crea una clave de API de Fast Transcriber y guárdala en una variable de entorno del servidor. Envía la URL pública del contenido multimedia como source_url; nunca expongas la clave Bearer en el código del navegador ni la subas al repositorio del código fuente.

curl --request POST https://fast-transcriber.com/api/v1/transcriptions \
  --header "Authorization: Bearer $FAST_TRANSCRIBER_API_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
    "source_url": "https://www.youtube.com/watch?v=VIDEO_ID",
    "speaker_diarization": false
  }'

Una solicitud válida devuelve 202 Accepted. Esto significa que la tarea se puso en la cola, no que la fuente se haya recuperado correctamente. Lee el encabezado de respuesta Location, asigna esa ruta a LOCATION_PATH y consúltala hasta que el estado de la tarea sea completed o failed.

LOCATION_PATH="/api/v1/transcriptions/95c3fdd8-..."
curl --request GET "https://fast-transcriber.com$LOCATION_PATH" \
  --header "Authorization: Bearer $FAST_TRANSCRIBER_API_TOKEN"

¿Todo listo para ejecutar esta solicitud? Crea una clave de API o consulta todos los endpoints en la documentación de la API.

Trabaja con texto y segmentos con marcas de tiempo

Las tareas completadas contienen el texto de la transcripción y los segmentos con marcas de tiempo disponibles según los límites del plan de la cuenta autenticada. El mismo formato de respuesta permite que una aplicación indexe un video, salte a los momentos citados, cree resúmenes o envíe la transcripción a una búsqueda autorizada o a un flujo RAG.

{
  "data": {
    "id": "95c3fdd8-...",
    "filename": "video-source.mp4",
    "status": "completed",
    "duration_seconds": 84,
    "text": "Texto completo de la transcripción...",
    "segments": [
      { "start": 0, "end": 3.8, "text": "Primer segmento..." }
    ]
  }
}

Establece speaker_diarization en true cuando necesites etiquetas de hablantes. La diarización requiere una cuenta Pro y usa los mismos límites que la aplicación web.

Qué crean los desarrolladores con transcripciones de un video o Short público de YouTube

Bases de conocimiento: indexa bibliotecas autorizadas de videos educativos o empresariales por su contenido hablado.
Herramientas de investigación: busca y cita momentos relevantes mediante los tiempos de los segmentos.
Flujos de publicación: convierte videos propios en borradores de artículos, notas del programa, capítulos o texto accesible para revisión humana.

Enlaces compatibles y requisitos de acceso

Los videos públicos de YouTube, Shorts y enlaces youtu.be compatibles se pueden enviar mediante source_url.

El video debe ser público, estar disponible y poder verse sin iniciar sesión.
Los videos privados, solo para miembros, eliminados, con restricción de edad y las transmisiones en vivo activas no se pueden importar.
Envía la URL canónica del video, Short o enlace youtu.be y gestiona en tu aplicación los errores de contenido inaccesible.

Si una grabación es privada y tienes autorización para procesarla, recupera el contenido multimedia mediante tu propio flujo autenticado y usa la API de carga directa de audio y video.

Soluciona problemas al importar un video o Short público de YouTube

Excluye las transmisiones en vivo activas: espera a que termine la transmisión y haya una repetición pública antes de poner la transcripción en la cola.
Prueba la reproducción sin una cuenta: los videos solo para miembros, privados, con restricción de edad y algunos videos restringidos por región no se pueden obtener mediante un sistema de enlaces públicos.
Guarda el ID del video: el ID estable ayuda a tu aplicación a eliminar duplicados entre las variantes watch, Shorts y youtu.be que apuntan al mismo contenido.

Planifica el tratamiento de errores asíncronos

Las integraciones de producción deben gestionar fuentes no válidas o inaccesibles, fallos de autenticación, límites de la cuenta y fallos temporales de procesamiento. Los errores HTTP inmediatos usan una estructura {"error":{"code":"...","message":"..."}}. Una fuente puesta en la cola puede devolver después data.status como failed, con detalles en data.error, al consultar la tarea. No reintentes indefinidamente contenido privado, eliminado o protegido por inicio de sesión; muestra un mensaje claro u ofrece una alternativa de carga autorizada.

Preguntas frecuentes

¿Qué formatos de URL de YouTube funcionan?

Los videos públicos, Shorts y enlaces youtu.be compatibles usan el mismo sistema que la herramienta de Fast Transcriber en el navegador.

¿Puede la API acceder a contenido privado de YouTube?

No. Las fuentes enviadas mediante una URL deben estar disponibles públicamente. Usa una carga directa autorizada para contenido privado que tengas permiso para procesar.

¿Por qué el endpoint devuelve 202?

La transcripción es asíncrona. Usa el encabezado Location para recuperar el estado de la tarea y el resultado final.