Commencez par une vidéo autorisée
YouTube vers MP3 accepte un lien vidéo. Connectez-vous, collez le lien, sélectionnez MP3, AAC ou WAV, choisissez un débit binaire pour l’audio compressé et lancez la conversion. Gardez la page ouverte et au premier plan jusqu’à ce que le fichier ait fini de se télécharger.
Utilisez les vidéos que vous possédez ou dont vous avez l’autorisation de télécharger et de traiter, et respectez les conditions d’utilisation et la législation applicables de YouTube. Ce flux de travail ne permet pas de contourner l’accès vidéo privé, les paywalls ou le DRM.
Le validateur d’URL accepte les formulaires reconnus YouTube watch, short-link, Shorts et embed et normalise un ID vidéo valide de 11 caractères en une URL de visionnage. Les hôtes non reconnus et les identifiants malformés sont rejetés. Les playlists et les diffusions en direct actives ne sont pas prises en charge ; une URL valide ne garantit pas l’accessibilité de la vidéo.
Extraction séparée de l’encodage final
La tâche de téléchargement utilise yt-dlp pour sélectionner le meilleur flux audio disponible plutôt que de récupérer des images vidéo. La source peut arriver dans un conteneur tel que WebM ou M4A ; son extension ne garantit pas qu’il est déjà MP3.
Le backend prépare cet audio source et l’expose à l’étape d’exportation. FFmpeg décode ensuite la source et encode le format de destination sélectionné. Le statut de prêt source du serveur n’est donc pas le même qu’un téléchargement MP3 complet.
La préparation du source, le transfert, l’encodage et la sauvegarde sont des étapes distinctes. La barre de progression combine ces étapes et ne doit pas être lue comme une prévision exacte du temps écoulé. Ces descriptions sont basées sur la mise en œuvre, et non sur un benchmark de vitesse mesuré.
Video URL
-> validated single-video task
-> yt-dlp audio-only source
-> source transfer
-> FFmpeg audio encoding
-> downloadable MP3, AAC or WAVChoisissez l’encodage de sortie réel
| Format audio | Encodeur et conteneur | Distinction pratique |
|---|---|---|
| MP3 | libmp3lame encodeur ; Conteneur MP3 | Audio compressé avec perte et large support du lecteur ; Sélectionnable à 128, 192 ou 320 kbps |
| AAC | encodeur AAC ; ADTS conteneur avec une extension .aac | Audio compressé avec perte ; cette sortie n’est pas un fichier M4A |
| WAV | pcm_s16le encodeur ; Conteneur WAV | PCM 16 bits non compressé ; Le sélecteur de débit binaire audio compressé est caché |
La commande export supprime la sortie vidéo et sélectionne explicitement l’encodeur audio et le conteneur. Il ne force pas explicitement un taux d’échantillonnage ni un nombre de chaînes, donc ne garantez pas que chaque résultat soit stéréo à 44,1 kHz. Vérifiez le fichier complété lorsque ces propriétés comptent.
ffmpeg -i input.webm -vn -codec:a libmp3lame -b:a 192k -f mp3 output.mp3
ffmpeg -i input.webm -vn -codec:a aac -b:a 192k -f adts output.aac
ffmpeg -i input.webm -vn -codec:a pcm_s16le -f wav output.wavCes commandes illustrent les arguments d’exportation configurés avec un nom d’entrée exemplaire. Ce n’est pas un service de téléchargement en ligne de commande distinct. Pour les fichiers audio que vous avez déjà, utilisez Convertisseur audio; Pour extraire une bande-son d’un fichier vidéo, utilisez Vidéo en audio.
Le débit binaire change la taille, pas l’enregistrement source
Choisir 320 kbps ne rétablit pas les détails déjà absents de la source. Une source avec perte réencodée en MP3 ou AAC subit une autre étape d’encodage avec perte. WAV évite ce codec supplémentaire avec perte mais ne peut pas reconstituer l’enregistrement studio original.
Pour l’audio compressé, la taille approximative de la charge utile est multipliée par le débit binaire par la durée, divisée par huit. Un passage de dix minutes à 192 kbps représente environ 14,4 Mo avant la surcharge du conteneur, utilisant des mégaoctets décimaux. Il s’agit d’une estimation de taille, pas d’une mesure de qualité ou de timing.
Compressed payload bytes ~= bitrate_bits_per_second * duration_seconds / 8
192000 * 600 / 8 = 14400000 bytes = 14.4 MB
16-bit PCM payload bytes ~= sample_rate * channels * 2 * duration_seconds
48000 * 2 * 2 * 600 = 115200000 bytes = 115.2 MBL’exemple WAV suppose la stéréo 48 kHz uniquement pour illustrer le calcul ; Ce n’est pas une garantie de sortie. Les en-têtes de conteneurs et le comportement réel d’encodage peuvent modifier la taille du fichier. Choisissez un format pour le lecteur de destination ou le flux de travail d’édition, pas parce qu’un fichier plus volumineux doit sonner meilleur.
États de la tâche, accès et expiration
Créer une tâche nécessite un compte authentifié. Les points de terminaison de statut, de battement cardiaque, de récupération de source, de complétion et d’annulation vérifient la propriété de la tâche ; un identifiant de tâche seul ne signifie pas l’autorisation de télécharger le résultat de quelqu’un d’autre.
POST /api/jobs create an authenticated task (202)
POST /api/jobs/{id}/heartbeat keep the task active and read status
GET /api/jobs/{id}/source retrieve source audio when ready
POST /api/jobs/{id}/complete report successful export
POST /api/jobs/{id}/cancel cancel the taskLa tâche source peut être mise en file d’attente, téléchargement, récupération, téléversement, terminée ou par erreur. Certaines étapes dépendent des paramètres de déploiement. Le stockage optionnel d’objets modifie la source de distribution, et non le codec de sortie sélectionné. Le point de terminaison source renvoie soit une route source-file, soit une URL de stockage expirante.
La durée de vie source-résultat configurée est d’une heure après la fin de la tâche backend. Téléchargez rapidement ; L’expiration peut survenir avant la fin d’une longue exportation. L’expiration de la source et un fichier final sauvegardé avec succès sont des choses différentes. La restauration de session ne garantit pas qu’un lien d’exportation ou de téléchargement en mémoire précédent survive à un rafraîchissement.
Limites et défaillances courantes
Le téléchargeur est configuré pour des vidéos allant jusqu’à 7 200 secondes et une capacité maximale de téléchargement source de 250 M. Ce sont des limites de tâches source, pas une promesse que chaque vidéo de deux heures réussira ou que le WAV final conviendra à cette taille. Les tentatives de téléchargement ont également un délai d’attente de 1 800 secondes.
Une file d’attente complète ou peu de ressources serveur peuvent retarder ou rejeter une tâche. Une vidéo supprimée, restreinte ou indisponible, une vérification de plateforme, une défaillance réseau, une expiration de la source ou une erreur d’encodage peuvent également empêcher l’achèvement. Une URL valide et une barre de progression visible ne prouvent pas que l’ensemble du pipeline a réussi.
Si l’encodage échoue après la préparation du code source, l’interface peut proposer un téléchargement audio original. Ce fichier conserve le format source et n’est pas un MP3 de secours. Vérifiez son extension et le support des joueurs avant de l’utiliser. Essayez une vidéo autorisée plus courte, gardez la page au premier plan et ne réessayez qu’après avoir vérifié l’erreur signalée.