API de transcription Instagram pour les Reels

Ajoutez la transcription de vidéos Instagram à un service dorsal avec un seul point de terminaison REST asynchrone. Envoyez l’URL d’un Reel ou d’une vidéo publique, recevez l’emplacement à interroger, puis récupérez le texte structuré de la transcription et ses segments horodatés.

Transcrire des médias Instagram sans maintenir votre propre outil de téléchargement

Les méthodes d’import de médias Instagram évoluent et peuvent demander une maintenance importante. Fast Transcriber prend en charge la résolution des liens publics compatibles ainsi que la reconnaissance vocale derrière une seule requête authentifiée. Votre application peut ainsi se concentrer sur la transcription et sur le processus qui l’exploite.

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

Reels : utilisez l’URL instagram.com/reel/{shortcode} ou instagram.com/reels/{shortcode} copiée depuis un Reel public.
Publications vidéo : une URL instagram.com/p/{shortcode} fonctionne lorsque la publication contient une seule vidéo publique ; une publication composée uniquement d’images ne contient aucune parole à transcrire.
Anciens liens vidéo : les liens instagram.com/tv/{shortcode} peuvent être envoyés si la vidéo est toujours disponible publiquement.

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

Archives de créateurs : conservez du texte consultable avec les Reels publics que votre application est autorisée à indexer.
Révision de contenu : intégrez les affirmations orales, messages de campagne ou propositions de créateurs à un processus de révision textuel.
Réutilisation de contenu : transformez les paroles de vidéos approuvées en briefs, sous-titres, citations ou brouillons tout en conservant les horodatages.

Liens pris en charge et conditions d’accès

L’API prend en charge les URL de Reels Instagram publics et de publications contenant une seule vidéo que le résolveur de liens peut ouvrir sans session Instagram.

Le Reel ou la publication vidéo doit être public et accessible sans connexion.
Les profils privés, publications réservées aux amis proches, médias supprimés et contrôles de connexion ne peuvent pas être importés par URL.
La disponibilité d’Instagram et ses limites de débit peuvent parfois bloquer une URL pourtant publique ; gérez l’échec de la tâche et proposez un import de fichier autorisé.
Pour une publication carrousel, utilisez le lien direct d’une publication contenant une seule vidéo ou importez la vidéo précise que vous êtes autorisé à traiter.

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 Instagram publique

Tester l’accès sans connexion : ouvrez le Reel ou la publication précise dans une fenêtre de navigation privée. Si une page de connexion s’affiche, le processus de transcription ne pourra généralement pas non plus récupérer le média.
Traiter explicitement les carrousels : ne partez pas du principe que l’URL d’une publication sélectionne chaque élément. Lorsqu’un carrousel contient plusieurs médias, importez la vidéo autorisée précise.
Gérer les échecs d’accès à la plateforme : une limite de débit ou un contrôle d’accès Instagram peut faire échouer la tâche après sa mise en file d’attente. Espacez les tentatives et proposez l’import direct au lieu de réessayer sans fin.

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

Quels liens Instagram l’API peut-elle transcrire ?

Vous pouvez envoyer dans source_url les URL de Reels Instagram publics et de publications contenant une seule vidéo qui s’ouvrent sans connexion.

L’API peut-elle transcrire un contenu Instagram privé ?

Non. Si vous êtes autorisé à utiliser un média privé, téléchargez-le au moyen de votre propre processus authentifié, puis utilisez l’API d’import direct.

La requête POST renvoie-t-elle la transcription terminée ?

Non. Elle renvoie 202 Accepted et un en-tête Location. L’acceptation signifie que la tâche est en file d’attente, et non que le média a été récupéré ; interrogez cette URL jusqu’à la réussite ou l’échec de la tâche.