API de transcription Google Drive

Reliez un média partagé sur Google Drive à un processus de transcription sans commencer par déplacer le fichier dans votre application. Envoyez le lien de partage accessible d’un fichier audio ou vidéo, puis interrogez la tâche jusqu’à l’obtention de la transcription.

Transcrire un média Drive partagé depuis un service dorsal

Un lien de partage Drive public peut servir de source à une tâche de transcription asynchrone. Cette solution convient lorsque des collaborateurs livrent déjà leurs enregistrements par Drive et que votre application n’a besoin que de la transcription, des horodatages et de l’état de la tâche.

Choisir la bonne URL pour un fichier audio ou vidéo Google Drive

Partages de fichiers standard : les liens drive.google.com/file/d/{file-id}/view constituent le choix le plus clair pour un fichier audio ou vidéo importé.
Partages fondés sur l’identifiant : les liens drive.google.com/open?id={file-id} et les liens de téléchargement Drive peuvent être résolus lorsque le même fichier est téléchargeable publiquement.
Médias réels uniquement : le fichier ciblé doit contenir de l’audio ou de la vidéo ; un dossier Drive ou un document Google Workspace ne constitue pas une source multimédia.

Démarrage rapide : mettre en file d’attente la transcription de un fichier audio ou vidéo Google Drive

Créez une clé d’API Fast Transcriber et conservez-la dans une variable d’environnement côté serveur. Envoyez l’URL publique du média dans source_url. N’exposez jamais la clé Bearer dans le code du navigateur et ne l’enregistrez pas dans le dépôt du code source.

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
  }'

Une requête valide renvoie 202 Accepted. Cela signifie que la tâche a été mise en file d’attente, et non que la source a bien été récupérée. Lisez l’en-tête de réponse Location, affectez ce chemin à LOCATION_PATH, puis interrogez-le jusqu’à ce que l’état de la tâche soit completed ou failed.

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

Prêt à envoyer cette requête ? Créez une clé d’API ou consultez tous les points de terminaison dans la documentation de l’API.

Exploiter le texte et les segments horodatés

Les tâches terminées contiennent le texte de la transcription et les segments horodatés disponibles selon les limites de l’offre du compte authentifié. Grâce à ce format de réponse commun, une application peut indexer une vidéo, accéder directement aux passages cités, créer des résumés ou transmettre la transcription à un processus de recherche ou de génération augmentée par récupération autorisé.

{
  "data": {
    "id": "95c3fdd8-...",
    "filename": "video-source.mp4",
    "status": "completed",
    "duration_seconds": 84,
    "text": "Texte intégral de la transcription...",
    "segments": [
      { "start": 0, "end": 3.8, "text": "Premier segment..." }
    ]
  }
}

Définissez speaker_diarization sur true lorsque vous avez besoin d’identifier les intervenants. La diarisation nécessite un compte Pro et utilise les mêmes limites que l’application web.

Ce que les développeurs créent à partir des transcriptions de un fichier audio ou vidéo Google Drive

Collecte d’entretiens : transformez les enregistrements de recherche ou de journalisme partagés en transcriptions consultables après leur import par les collaborateurs.
Archives de réunions : traitez les enregistrements exportés et conservés dans un emplacement Drive partagé autorisé.
Transferts de production : créez du texte et des horodatages à partir de ressources audio ou vidéo livrées par Drive.

Liens pris en charge et conditions d’accès

La source doit être un véritable fichier audio ou vidéo dans Google Drive dont l’option Accès général est réglée sur Toute personne disposant du lien.

Le fichier doit pouvoir s’ouvrir et se télécharger sans authentification Google.
Google Docs, Sheets, Slides, les dossiers et les pages web ordinaires ne sont pas des sources de transcription audio ou vidéo.
Si votre organisation interdit le partage public, récupérez le média autorisé au moyen de votre propre intégration, puis utilisez l’API d’import direct.

Si un enregistrement est privé et que vous êtes autorisé à le traiter, récupérez le média au moyen de votre propre processus authentifié, puis utilisez l’API d’import direct de fichiers audio et vidéo.

Résoudre les problèmes d’import de un fichier audio ou vidéo Google Drive

Vérifier l’Accès général : réglez le fichier sur Toute personne disposant du lien et confirmez qu’il s’ouvre dans une fenêtre de navigation privée sans demander de choisir un compte Google.
Contrôler la réponse de téléchargement : le lien doit renvoyer le média et non une page HTML d’autorisation, de quota ou d’avertissement d’accès.
Conserver l’authentification Drive privée dans votre application : pour les fichiers restreints d’une organisation, utilisez votre propre intégration Drive autorisée pour récupérer les octets, puis envoyez-les avec l’API d’import.

Prévoir les erreurs asynchrones

Une intégration en production doit gérer les sources non valides ou inaccessibles, les échecs d’authentification, les limites du compte et les défaillances temporaires du traitement. Les erreurs HTTP immédiates utilisent l’enveloppe {"error":{"code":"...","message":"..."}}. Lors de l’interrogation, une source déjà mise en file d’attente peut ensuite renvoyer data.status avec la valeur failed et des précisions dans data.error. Ne relancez pas indéfiniment un média privé, supprimé ou protégé par une connexion : affichez un message clair ou proposez l’import autorisé d’un fichier.

Questions fréquentes

Quel réglage de partage Drive est nécessaire ?

Le fichier multimédia doit utiliser l’option Toute personne disposant du lien et s’ouvrir sans authentification Google.

L’API peut-elle transcrire des fichiers Google Docs, Sheets ou Slides ?

Non. Ce processus est réservé aux fichiers audio et vidéo stockés dans Drive.

Que faire d’un enregistrement Drive privé ?

Si vous êtes autorisé à l’utiliser, récupérez le média au moyen de votre processus Drive authentifié, puis envoyez le fichier à l’API d’import direct.