Opération · Extraction audio

Extrais l'audio d'une vidéo et récupère un MP3 et sa durée.

Envoie une URL vidéo en POST, récupère un MP3 en retour, accompagné de sa durée. Fotovid exécute l'extraction sur une infrastructure hébergée, donc pas de binaire ni de pipeline dans ta stack.

curl -X POST https://api.fotovid.co/v1/video/extract-audio \
  -H "Authorization: Bearer p6_YOUR_KEY_ID:YOUR_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "source_url": "https://cdn.yoursite.com/talk.mp4"
  }'

Extraire l'audio d'une vidéo ne devrait pas nécessiter ffmpeg sur ton serveur

Extraire la piste audio d'une vidéo tient en une ligne de commande ffmpeg — jusqu'à ce que tu essaies de l'exécuter dans une fonction serverless. Le binaire ffmpeg statique pèse plusieurs dizaines de mégaoctets, ce qui dépasse largement les limites de taille de déploiement sur Vercel, Netlify et Lambda. Décoder une vidéo pour réencoder un MP3 est gourmand en CPU et en mémoire, ce qui déclenche les timeouts de fonction et les limites de cold start sur toutes les instances sauf les plus grosses. Et il te reste encore à télécharger la source, lancer un sous-processus, récupérer le fichier de sortie et uploader le résultat vers un espace de stockage durable.

  • Les builds statiques de ffmpeg sont trop volumineux pour être intégrés dans la plupart des artefacts de déploiement serverless
  • L'extraction audio réencode toute la piste, ce qui atteint les plafonds de CPU, de mémoire et de timeout
  • Il te faut un endroit pour héberger le MP3 résultant et renvoyer une URL utilisable par ton app
  • Utilise cet endpoint quand tu veux le MP3 sans avoir à gérer toute la plomberie média

Paramètres de la requête

POST /v1/video/extract-audio

Aucun paramètre — envoie une source_url en POST et récupère un MP3 avec sa durée.

FieldTypeDefaultDescription
source_url*string (URL)URL HTTPS de la vidéo source (MP4, MOV, WebM, MKV, ...)
How it works

Ton premier appel en trois étapes

  1. 1
    Récupère une clé API gratuite

    Inscris-toi et crée une clé depuis le dashboard. Les requêtes s'authentifient avec un header Authorization: Bearer p6_<key_id>:<secret>. Les nouvelles clés démarrent avec des crédits gratuits, et la tarification est purement à l'usage — 1 $ achète 100 crédits et cette opération coûte environ 1 crédit par appel, donc rien à engager au départ.

  2. 2
    Envoie la vidéo en POST vers /v1/video/extract-audio

    Envoie une requête à https://api.fotovid.co/v1/video/extract-audio avec l'enveloppe standard : une source_url pointant vers l'URL HTTPS de ta vidéo, et un objet params vide — l'extraction audio ne prend aucun paramètre. Fotovid télécharge la vidéo, en extrait la piste audio et l'encode en MP3 de façon synchrone, en renvoyant la réponse dès que le fichier est prêt.

  3. 3
    Utilise l'URL du MP3 renvoyé

    La réponse est un JSON plat : un id, un type, une url hébergée par Fotovid pour le MP3, un expires_at, et la durée de l'audio en secondes. Utilise directement l'url dans un flux podcast, un pipeline de transcription ou d'IA, ou un lecteur. Comme les résultats hébergés sont temporaires, télécharge et stocke ta propre copie du MP3 dans le cadre de ton flux.

Questions fréquentes

Déploie-le avec un seul appel API

Récupère une clé gratuite et fais ton premier appel en moins de cinq minutes.