API de transcripción de Google Drive

Conecta contenido compartido en Google Drive a un flujo de transcripción sin mover primero el archivo a tu aplicación. Envía un enlace accesible a un archivo de audio o video y consulta la tarea hasta obtener la transcripción completada.

Transcribe contenido compartido de Drive desde un backend

Un enlace público de Drive puede servir como fuente de una tarea de transcripción asíncrona. Es útil cuando los colaboradores ya entregan grabaciones mediante Drive y tu aplicación solo necesita la transcripción, las marcas de tiempo y el estado de la tarea.

Elige la URL correcta de un archivo de audio o video de Google Drive

Enlaces estándar de archivos: los enlaces drive.google.com/file/d/{file-id}/view son la opción más clara para un archivo de audio o video cargado.
Enlaces basados en ID: los enlaces drive.google.com/open?id={file-id} y los enlaces de descarga de Drive pueden funcionar cuando el mismo archivo se puede descargar públicamente.
Solo contenido multimedia real: el archivo del enlace debe contener audio o video; una carpeta de Drive o un documento de Google Workspace no es una fuente multimedia.

Inicio rápido: pon en la cola una transcripción de un archivo de audio o video de Google Drive

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://drive.google.com/file/d/FILE_ID/view?usp=sharing",
    "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 archivo de audio o video de Google Drive

Recepción de entrevistas: convierte grabaciones compartidas de investigación o periodismo en transcripciones que se puedan buscar después de que los colaboradores las carguen.
Archivos de reuniones: procesa grabaciones exportadas y almacenadas en una ubicación compartida de Drive con los permisos adecuados.
Entregas de producción: crea texto y marcas de tiempo a partir de recursos de audio o video entregados mediante Drive.

Enlaces compatibles y requisitos de acceso

La fuente debe ser un archivo de audio o video real de Google Drive con el acceso general configurado como Cualquier persona con el enlace.

El archivo debe abrirse y descargarse sin autenticación de Google.
Google Docs, Sheets, Slides, las carpetas y las páginas web normales no son fuentes de transcripción de audio o video.
Si tu organización no permite enlaces públicos, obtén el contenido autorizado mediante tu propia integración y usa la API de carga directa.

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 archivo de audio o video de Google Drive

Comprueba el acceso general: configura el archivo como Cualquier persona con el enlace y confirma que se abre en una ventana privada sin pedir que elijas una cuenta de Google.
Comprueba la respuesta de descarga: el enlace debe devolver el contenido multimedia, no una página HTML de permisos, cuota o advertencia de acceso.
Mantén la autenticación de Drive dentro de tu aplicación: para archivos restringidos de una organización, usa tu propia integración autorizada con Drive para obtener los bytes y después usa la API de carga.

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é configuración de uso compartido de Drive se necesita?

El archivo multimedia debe usar la opción Cualquier persona con el enlace y abrirse sin autenticación de Google.

¿Puede transcribir Google Docs, Sheets o Slides?

No. Este flujo es para archivos de audio y video almacenados en Drive.

¿Qué debo hacer con una grabación privada de Drive?

Si tienes permiso para usarla, obtén el contenido mediante tu flujo autenticado de Drive y envía el archivo por la API de carga directa.