Opérations audio

Découper de l'audio en ligne — n'importe quelle fenêtre, un MP3 hébergé en sortie.

Fotovid peut découper de l'audio sans réencodage — le codec et le débit sont conservés tels quels, donc l'extrait correspond à la source. Un appel, rien à installer.

curl -X POST https://api.fotovid.co/v1/audio/trim \
  -H "Authorization: Bearer p6_YOUR_KEY_ID:YOUR_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "source_url": "https://cdn.yoursite.com/voice-note.mp3",
    "params": {
      "start": 18.7,
      "end": 42
    }
  }'

Pourquoi ne pas simplement lancer ffmpeg toi-même ?

Découper un extrait audio, c'est une commande ffmpeg d'une ligne — jusqu'au jour où tu essaies de la déployer en serverless. Le binaire ffmpeg dépasse largement la plupart des limites de taille des bundles de fonctions, les cold starts explosent, et il faut quand même télécharger le fichier source, lancer un sous-processus, récupérer la sortie, puis envoyer le résultat vers un stockage durable. Ça fait beaucoup de plomberie indifférenciée pour une opération aussi simple que découper un extrait.

  • Le binaire statique ffmpeg dépasse largement les limites de taille de bundle et de mémoire de Lambda/Vercel/Netlify, et les layers sont fragiles à maintenir
  • Il faut récupérer l'entrée, lancer un sous-processus, et streamer la sortie standard sans saturer le disque ou le timeout de la fonction
  • Le fichier découpé a quand même besoin d'un hébergement — tu gères le stockage, l'hébergement et le nettoyage
  • Utilise cet endpoint quand tu veux une sonnerie, un court extrait, un mémo vocal découpé ou un aperçu, sans avoir à gérer tout ça

Paramètres de la requête

POST /v1/audio/trim

FieldTypeDefaultDescription
source_url*string (URL)URL HTTPS de l'audio source (MP3, M4A, WAV, ...)
params.start*string | number"HH:MM:SS(.mmm)" ou secondes (par ex. 18.73)
params.end*string | numberDoit être supérieur à start ; tronqué à la fin du fichier (EOF)
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. Chaque requête s'authentifie avec un header Authorization: Bearer p6_<key_id>:<secret>. Les nouvelles clés démarrent avec des credits d'usage gratuits — la plupart des opérations, y compris la découpe audio, coûtent 1 credit (1 $ = 100 credits).

  2. 2
    POST vers /v1/audio/trim

    Envoie un corps JSON avec source_url pointant vers l'URL https de ton audio d'entrée, et un objet params contenant start et end. Les deux acceptent soit une chaîne au format HH:MM:SS.mmm, soit un nombre de secondes — par exemple start: "00:00:12.500", end: "00:00:27". Fotovid télécharge la source, découpe cette fenêtre et encode le résultat en MP3.

  3. 3
    Utilise l'URL MP3 renvoyée

    La réponse est un JSON plat : { id, type, url, expires_at, duration }. url est un MP3 hébergé par Fotovid correspondant à ton extrait découpé. Lis-le directement ou télécharge-le et garde ta propre copie dans ton bucket pour contrôler la rétention.

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.