Estrai l'audio da un video e ricevi un MP3, completo di durata.
Invia in POST l'URL di un video e ricevi un MP3, con la durata già pronta nella risposta. Fotovid esegue l'estrazione su infrastruttura ospitata, quindi niente binari né pipeline nel tuo 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"
}'Estrarre l'audio da un video non dovrebbe richiedere ffmpeg sul tuo server
Estrarre la traccia audio da un video è un comando ffmpeg di una riga — finché non provi a eseguirlo in una funzione serverless. Il binario statico di ffmpeg pesa decine di megabyte, il che supera i limiti di dimensione del deploy su Vercel, Netlify e Lambda. Decodificare il video per ricodificare un MP3 richiede molta CPU e memoria, quindi fa scattare i timeout delle funzioni e i limiti di cold start su tutte le istanze tranne le più grandi. E devi comunque scaricare la sorgente, lanciare un sottoprocesso, catturare il file di output e caricare il risultato da qualche parte in modo duraturo.
- Le build statiche di ffmpeg sono troppo grandi per essere incluse nella maggior parte degli artefatti di deploy serverless
- L'estrazione audio ricodifica l'intera traccia, quindi raggiunge i limiti di CPU, memoria e timeout
- Ti serve un posto dove ospitare l'MP3 risultante e restituire un URL utilizzabile dalla tua app
- Usa questo endpoint quando vuoi l'MP3 senza doverti occupare di tutta la parte tecnica sui media
Parametri della richiesta
POST /v1/video/extract-audio
Nessun parametro — invia in POST una source_url e ricevi un MP3 con la durata inclusa.
| Field | Type | Default | Description |
|---|---|---|---|
| source_url* | string (URL) | — | URL HTTPS del video sorgente (MP4, MOV, WebM, MKV, ...) |
La tua prima chiamata in tre passaggi
- 1Ottieni una chiave API gratuita
Registrati e crea una chiave dalla dashboard. Le richieste si autenticano con un header Authorization: Bearer p6_<key_id>:<secret>. Le nuove chiavi partono con credits gratuiti e la tariffazione è a puro consumo — $1 = 100 credits e questa operazione costa circa 1 credit per chiamata, quindi non devi impegnarti in anticipo con nulla.
- 2Invia in POST il video a /v1/video/extract-audio
Invia una richiesta a https://api.fotovid.co/v1/video/extract-audio con l'envelope standard: una source_url che punta all'URL HTTPS del tuo video, e un oggetto params vuoto — l'estrazione audio non richiede parametri. Fotovid scarica il video, ne estrae la traccia audio e la codifica in MP3 in modo sincrono, restituendo la risposta non appena il file è pronto.
- 3Usa l'URL dell'MP3 restituito
La risposta è un JSON piatto: un id, un type, un URL ospitato da Fotovid per l'MP3, un expires_at e la durata dell'audio in secondi. Usa direttamente l'URL in un feed podcast, in una pipeline di trascrizione o IA, oppure in un player. Poiché i risultati ospitati sono temporanei, scarica e conserva una tua copia dell'MP3 come parte del tuo flusso.
Domande frequenti
Rilascialo con una sola chiamata API
Prendi una chiave gratuita e fai la tua prima chiamata in meno di cinque minuti.