Extrae el audio de un video y recibe un MP3 más su duración.
Envía un POST con la URL de un video y recibe un MP3 — más su duración. Fotovid ejecuta la extracción en infraestructura alojada, así que no necesitas ningún binario ni pipeline en tu 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"
}'Sacarle el audio a un video no debería exigir ffmpeg en tu servidor
Extraer la pista de audio de un video es un comando de ffmpeg de una sola línea — hasta que intentas ejecutarlo en una función serverless. El binario estático de ffmpeg pesa decenas de megabytes, lo que supera los límites de tamaño de despliegue en Vercel, Netlify y Lambda. Decodificar el video para volver a codificar el MP3 consume muchísima CPU y memoria, así que agota los timeouts y los límites de cold start en cualquier instancia que no sea de las más grandes. Y encima aún tienes que descargar el origen, invocar un subproceso, capturar el archivo de salida y subir el resultado a algún lugar duradero.
- Los builds estáticos de ffmpeg son demasiado pesados para incluirlos en la mayoría de los artefactos de despliegue serverless
- La extracción de audio vuelve a codificar toda la pista, así que llega a los límites de CPU, memoria y timeout
- Necesitas un lugar donde alojar el MP3 resultante y devolver una URL que tu app pueda usar
- Recurre a este endpoint cuando quieras el MP3 sin encargarte de ninguna parte de la infraestructura de medios
Parámetros de la solicitud
POST /v1/video/extract-audio
Sin parámetros — envía un source_url y recibe un MP3 con su duración.
| Field | Type | Default | Description |
|---|---|---|---|
| source_url* | string (URL) | — | URL HTTPS del video de origen (MP4, MOV, WebM, MKV, ...) |
Tu primera llamada en tres pasos
- 1Consigue una API key gratuita
Regístrate y crea una key desde el dashboard. Las solicitudes se autentican con un encabezado Authorization: Bearer p6_<key_id>:<secret>. Las keys nuevas empiezan con créditos gratuitos, y la facturación es 100% por consumo — $1 equivale a 100 créditos y esta operación cuesta alrededor de 1 crédito por llamada, así que no hay ningún compromiso previo.
- 2Envía el video mediante POST a /v1/video/extract-audio
Envía una solicitud a https://api.fotovid.co/v1/video/extract-audio con el sobre estándar: un source_url que apunte a la URL HTTPS de tu video, y un objeto params vacío — la extracción de audio no toma parámetros. Fotovid descarga el video, extrae la pista de audio y la codifica a MP3 de forma síncrona, devolviendo la respuesta en cuanto el archivo está listo.
- 3Usa la URL del MP3 devuelto
La respuesta es un JSON plano: un id, un type, una url alojada por Fotovid para el MP3, un expires_at y la duración del audio en segundos. Pasa la url directamente a un feed de podcast, un pipeline de transcripción o de IA, o un reproductor. Como los resultados alojados son temporales, descarga y guarda tu propia copia del MP3 como parte de tu flujo.
Preguntas frecuentes
Lánzalo con una sola llamada a la API
Consigue una key gratis y haz tu primera llamada en menos de cinco minutos.