API de transcription TikTok : convertir une vidéo en texte

Mettez des vidéos TikTok publiques en file d’attente pour les transcrire depuis une application ou un service dorsal. Fast Transcriber accepte l’URL de la vidéo, la traite de façon asynchrone et renvoie du texte structuré ainsi que des segments horodatés.

Ajouter la conversion de TikTok en texte à un produit ou à un processus de contenu

Au lieu de demander aux utilisateurs de télécharger une vidéo TikTok publique puis de la réimporter, envoyez directement son URL compatible. L’API attribue un identifiant à chaque tâche et renvoie un format prévisible, adapté aux files d’attente, bases de données, index de recherche et systèmes d’IA en aval.

Choisir la bonne URL pour une vidéo TikTok publique

Vidéos canoniques : privilégiez tiktok.com/@creator/video/{id}, qui désigne une seule vidéo et se prête mieux à la journalisation et à la déduplication.
Liens courts copiés : les liens de partage vm.tiktok.com et vt.tiktok.com peuvent être envoyés tant que leur redirection mène encore à une vidéo publique.
Sources qui ne sont pas des vidéos : les profils de créateurs, pages de hashtags, pages de recherche et collections ne désignent pas une source unique à transcrire.

Démarrage rapide : mettre en file d’attente la transcription de une vidéo TikTok 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.tiktok.com/@creator/video/1234567890123456789",
    "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 vidéo TikTok publique

Propositions de créateurs approuvées : convertissez les vidéos de campagne en texte consultable à des fins de révision et de rapport.
Recherche sur les tendances : analysez le langage parlé dans un ensemble autorisé de vidéos publiques sans transcrire manuellement chaque extrait.
Processus de contenu accessible : utilisez les segments horodatés comme point de départ pour créer des sous-titres et des alternatives textuelles relues par une personne.

Liens pris en charge et conditions d’accès

Envoyez l’URL d’une vidéo TikTok publique qui peut être ouverte sans connexion à TikTok. Le résolveur se charge d’obtenir le média avant le début de la transcription.

La vidéo doit être publique et toujours disponible à l’URL envoyée.
Les vidéos privées, réservées aux amis, soumises à une limite d’âge, supprimées ou protégées par une connexion ne peuvent pas être importées.
Envoyez une seule vidéo par tâche de transcription et respectez les droits du créateur ainsi que les règles applicables de la plateforme.

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

Vérifier le réglage de l’audience : une publication réservée aux amis ou privée peut sembler valide au créateur connecté tout en restant inaccessible au processus de transcription.
Tenir compte des restrictions : les limites d’âge, de région ou de connexion peuvent empêcher la résolution du média même lorsque l’URL est bien formée.
Prévoir l’échec des vidéos supprimées : une vidéo supprimée ou modérée peut disparaître entre l’envoi et le traitement ; gérez toujours un résultat d’échec lors de l’interrogation.

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

Les vidéos TikTok privées fonctionnent-elles ?

Non. L’URL doit être accessible publiquement sans connexion à TikTok.

Mon application doit-elle d’abord télécharger la vidéo TikTok ?

Pas pour une URL publique compatible. Envoyez-la directement dans source_url et Fast Transcriber se charge de résoudre le lien.

L’API peut-elle renvoyer des horodatages ?

Oui. Les tâches terminées contiennent le texte de la transcription et des segments horodatés, dans les limites de l’offre du compte authentifié.