Référence
Sources
YouTube, TikTok, vos fichiers et les liens directs : URL acceptées, fonctionnement de chaque mode et limites.
Mis à jour le
Quelle que soit la source, vous obtenez le même objet transcription : le texte, les segments horodatés et, lorsque la transcription par IA les a produits, les horodatages par mot. Limites pour toutes les sources : 2 heures et 250 Mo.
Sources#
| Source | Liens acceptés | captions_only | auto / transcribe |
|---|---|---|---|
| YouTube | youtube.com/watch?v=…, youtu.be/…, /shorts/…, /live/… | Sous-titres du créateur ou automatiques, 1 crédit | Forfaits payants |
| TikTok | tiktok.com/@user/video/…, liens de partage vm.tiktok.com/… | Sous-titres du créateur, 1 crédit | Forfaits payants |
| Votre fichier | mp3, wav, m4a, ogg, aac, mp4, webm via POST /v1/uploads | Non disponible | Forfaits payants |
| Lien direct | Toute URL https publique qui sert un fichier audio ou vidéo | Non disponible | Forfaits payants |
GET /v1/capabilities avec votre clé renvoie ce tableau pour votre forfait, afin qu'un client n'affiche que ce qui fonctionnera.
Sous-titres#
- Vidéos publiques uniquement. Les vidéos privées, réservées aux membres ou soumises à une restriction d'âge échouent avec un code
SOURCE_*. - YouTube propose deux types de sous-titres : ceux envoyés par le créateur et les sous-titres automatiques de YouTube.
caption_preferencepermet de choisir. Par défaut, ceux du créateur sont pris lorsqu'ils existent. caption_languagesdemande des pistes précises, par exemple["es", "en"].POST /v1/language-discoveriesliste les langues disponibles pour une vidéo YouTube.- Horodatage par bloc de sous-titres (
timing_granularity: "segment").
Transcription par IA#
- Écoute l'audio, avec ou sans sous-titres. Détecte la langue, ou accepte une indication dans
language. - Renvoie les horodatages par mot et le niveau de confiance (
timing_granularity: "word"). - Prend environ un quart de la durée du média. Utilisez
?wait=25ou un webhook plutôt qu'une interrogation trop fréquente. - 2 crédits par minute commencée, 1 minute minimum. Plafonnez une tâche avec
max_credits.