API de transcription d’URL vidéo publiques

Utilisez un seul point de terminaison pour mettre en file d’attente des liens publics compatibles de vidéos sociales, des médias Google Drive et des URL directes de fichiers audio ou vidéo. Fast Transcriber résout le média, renvoie 202 Accepted et expose la transcription terminée au moyen d’une URL d’interrogation.

Un seul contrat d’API pour les sources multimédias publiques compatibles

Un processus source_url unique harmonise le code d’import pour YouTube, Instagram, TikTok, Facebook, Google Drive et les médias publics directs. Votre intégration peut conserver un seul modèle de tâche et un seul schéma de transcription pendant que Fast Transcriber prend en charge la résolution et la transcription de la source.

Choisir la bonne URL pour une URL vidéo publique

Pages de vidéos sociales : utilisez l’URL canonique d’une seule vidéo YouTube, Instagram, TikTok ou Facebook compatible, et non celle d’un profil, d’un fil ou d’une collection.
Médias Google Drive : utilisez le lien de partage d’un fichier audio ou vidéo qui se télécharge sans authentification Google.
Fichiers multimédias directs : la réponse elle-même doit contenir de l’audio ou de la vidéo, idéalement avec une extension reconnaissable ou un en-tête Content-Type de média.

Démarrage rapide : mettre en file d’attente la transcription de une URL vidéo publique

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://cdn.example.com/media/interview.mp4",
    "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 une URL vidéo publique

Import unifié : acceptez plusieurs sources multimédias publiques compatibles sans exposer une interface de transcription différente pour chacune.
Recherche et découverte : indexez le texte de la transcription tout en conservant les segments qui renvoient à des passages précis.
Pipelines d’automatisation : mettez les médias autorisés en file d’attente, surveillez l’état des tâches et transmettez le texte terminé au stockage ou aux traitements en aval.

Liens pris en charge et conditions d’accès

Le pipeline actuel de liens publics prend en charge YouTube, Instagram, TikTok, Facebook, les médias Google Drive et les URL directes de fichiers audio ou vidéo publics.

L’URL doit utiliser HTTP ou HTTPS et mener à un média compatible sans connexion, cookie ni jeton privé.
Les articles et pages web ordinaires ne sont pas convertis en texte : l’URL doit désigner un média audio ou vidéo compatible.
Les médias privés ou restreints doivent passer par un processus d’import direct autorisé plutôt que par une tâche d’URL publique.

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 une URL vidéo publique

Valider avant la mise en file d’attente : refusez les entrées vides et non HTTP dans votre interface, puis laissez l’API renvoyer invalid_source_url pour les URL sources mal formées.
Maintenir les URL disponibles : les liens signés à durée limitée doivent rester valides assez longtemps pour que le processus asynchrone résolve et télécharge le média.
Distinguer la mise en file d’attente de la récupération : 202 confirme uniquement la création de la tâche. Affichez data.error si l’interrogation signale ensuite une source inaccessible ou non prise en charge.

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

L’API peut-elle transcrire n’importe quelle URL de page web ?

Non. Elle transcrit la parole de liens multimédias compatibles et n’extrait pas le texte des pages web ordinaires.

Puis-je envoyer l’URL directe d’un média ?

Oui, lorsqu’il s’agit de l’URL publique d’un fichier audio ou vidéo accessible sans authentification.

Que faire si la source nécessite une connexion ou un jeton privé ?

Utilisez plutôt le processus d’import direct, à condition d’être autorisé à traiter le média.