API de transcription des Reels Facebook

Transformez des Reels et vidéos Facebook publics en texte depuis votre service dorsal. Envoyez l’URL Facebook, interrogez la tâche asynchrone, puis exploitez la transcription terminée et ses segments horodatés dans votre application.

Intégrer la transcription de vidéos Facebook aux opérations de publication

Une vidéo Facebook publique peut intégrer un processus de révision, d’archivage ou d’accessibilité au moyen du même contrat d’API que les autres sources compatibles. Votre système conserve un seul modèle d’authentification et un seul schéma de transcription, sans maintenir un service propre à Facebook.

Choisir la bonne URL pour un Reel ou une vidéo Facebook publique

Reels : envoyez l’URL facebook.com/reel/{id} copiée depuis le Reel public.
Publications vidéo : les liens publics facebook.com/.../videos/{id} désignent les vidéos Facebook ordinaires publiées en dehors de l’espace Reels.
Liens de partage courts : les liens fb.watch peuvent fonctionner lorsqu’ils redirigent encore vers une vidéo publique qui ne nécessite pas de compte.

Démarrage rapide : mettre en file d’attente la transcription de un Reel ou une vidéo Facebook 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://www.facebook.com/reel/123456789012345",
    "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 Reel ou une vidéo Facebook publique

Archives de médias : rendez des collections autorisées de vidéos publiques consultables selon les mots prononcés dans chaque extrait.
Révision de campagnes : convertissez les Reels et vidéos approuvés en texte pour les processus de marque, juridiques ou de localisation.
Opérations de contenu : créez un texte source aligné dans le temps pour les résumés, extraits et sous-titres relus par une personne.

Liens pris en charge et conditions d’accès

Le résolveur de liens accepte les URL compatibles de Reels et de vidéos Facebook publics qui sont visibles sans compte Facebook.

Le Reel ou la vidéo doit être public et accessible sans connexion.
Les publications privées, groupes restreints, médias supprimés et vidéos protégées par une connexion ne peuvent pas être importés.
Lorsqu’une vidéo intégrée est hébergée par une autre plateforme, envoyez si possible l’URL du média compatible sur sa plateforme d’origine.

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 Reel ou une vidéo Facebook publique

Distinguer les publications publiques des Pages publiques : le caractère public d’une Page ne garantit pas que chacune de ses vidéos soit visible sans connexion. Testez l’URL précise de la vidéo.
Éviter les URL de groupes et de fils d’actualité : les publications de groupes restreints, pages de fil et URL génériques de profil ne fournissent pas de source vidéo récupérable publiquement.
Revenir à l’hébergeur d’origine : lorsqu’une publication Facebook intègre une vidéo externe, envoyez plutôt l’URL YouTube ou l’URL directe du média d’origine.

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 prend-elle en charge les Reels et les vidéos Facebook ?

Elle accepte les URL compatibles de Reels et de vidéos Facebook publics qui s’ouvrent sans connexion.

Les publications privées ou vidéos de groupes restreints fonctionnent-elles ?

Non. Le média doit être accessible publiquement sans connexion à Facebook.

La transcription peut-elle distinguer les intervenants ?

La diarisation des intervenants est disponible avec l’offre Pro en définissant speaker_diarization sur true.