API de transcripción de URLs de videos públicos

Usa un solo endpoint para poner en la cola enlaces públicos compatibles de videos sociales, contenido de Google Drive y URLs directas de archivos de audio o video. Fast Transcriber resuelve el contenido, devuelve 202 Accepted y ofrece la transcripción completada mediante una URL de consulta.

Un solo contrato de API para fuentes multimedia públicas compatibles

Un único flujo source_url mantiene uniforme el código de importación para YouTube, Instagram, TikTok, Facebook, Google Drive y contenido multimedia público directo. Tu integración puede guardar un solo modelo de tarea y un solo esquema de transcripción mientras Fast Transcriber se encarga de resolver y transcribir la fuente.

Elige la URL correcta de una URL de video público

Páginas de videos sociales: usa la URL canónica de un video compatible de YouTube, Instagram, TikTok o Facebook, no la de un perfil, feed o colección.
Contenido de Google Drive: usa un enlace a un archivo de audio o video que se pueda descargar sin autenticación de Google.
Archivos multimedia directos: la propia respuesta debe ser audio o video, preferiblemente con una extensión reconocible o un encabezado Content-Type multimedia.

Inicio rápido: pon en la cola una transcripción de una URL de video público

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://cdn.example.com/media/interview.mp4",
    "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 una URL de video público

Importación unificada: acepta varias fuentes multimedia públicas compatibles sin mostrar una interfaz de transcripción distinta para cada una.
Búsqueda y descubrimiento: indexa el texto de la transcripción y conserva los segmentos que apuntan a momentos específicos.
Flujos de automatización: pon contenido permitido en la cola, supervisa el estado de las tareas y envía el texto completado a almacenamiento o procesadores posteriores.

Enlaces compatibles y requisitos de acceso

El sistema actual de enlaces públicos admite YouTube, Instagram, TikTok, Facebook, contenido de Google Drive y URLs directas de archivos públicos de audio o video.

La URL debe usar HTTP o HTTPS y llevar a contenido compatible sin inicio de sesión, cookies ni tokens privados.
Los artículos y las páginas web normales no se convierten en texto; la URL debe identificar contenido de audio o video compatible.
El contenido privado o restringido debe pasar por un flujo de carga directa autorizado y no por una tarea con URL pública.

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 una URL de video público

Valida antes de poner en la cola: rechaza las entradas vacías y que no usen HTTP en tu interfaz, y deja que la API devuelva invalid_source_url para las URLs de origen mal formadas.
Mantén disponibles las URLs: los enlaces firmados con vencimiento deben seguir siendo válidos el tiempo suficiente para que el proceso asíncrono resuelva y descargue el contenido.
Distingue la puesta en cola de la obtención: 202 solo confirma la creación de la tarea. Muestra data.error si una consulta posterior indica que la fuente es inaccesible o no compatible.

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

¿Puede la API transcribir cualquier URL de una página web?

No. Transcribe la voz de enlaces multimedia compatibles y no extrae el texto de páginas web normales.

¿Puedo enviar una URL multimedia directa?

Sí, si se trata de la URL pública de un archivo de audio o video disponible sin autenticación.

¿Qué ocurre si la fuente requiere iniciar sesión o un token privado?

Usa el flujo de carga directa, siempre que tengas autorización para procesar el contenido.