¿Cómo defino el inicio y el final del clip?

Pasa start y end dentro del objeto params. Cada uno puede ser un string de timestamp como "00:01:30.500" o un número de segundos como 90.5. El clip cubre el rango semiabierto [start, end), así que el frame en end no queda incluido.

¿El corte es preciso por frame?

Sí. Fotovid re-encodifica el rango seleccionado con x264 en lugar de copiar hasta el keyframe más cercano, así que el clip empieza y termina exactamente donde lo pediste. La contrapartida es el re-encode, que es justo la razón por la que hacerlo tú mismo en serverless resulta tan doloroso.

¿En qué formato viene el resultado?

El resultado siempre es un MP4 re-encodificado con x264, devuelto como una URL alojada por fotovid en el campo url de la respuesta, junto con la duración del clip.

¿Cuánto tiempo está disponible la URL del resultado?

Cada respuesta incluye un timestamp expires_at. Trata la URL alojada como temporal y descarga el clip para guardar tu propia copia donde sea que sirvas tus archivos.

¿Cuánto cuesta un recorte?

Recortar es una operación de credits de uso: cuesta un credit por llamada. Los credits son $1 por 100, y cada cuenta empieza con credits gratis, así que puedes construir y probar antes de pagar nada.

¿Puedo usar esto en lugar de ffmpeg en Vercel o Lambda?

Ese es justamente el punto. Fotovid es el microservicio ffmpeg listo para integrar en serverless — haces una sola llamada HTTPS en lugar de empaquetar ffmpeg, así que no hay binarios, penalizaciones de cold start ni límites de memoria que sortear.

Operación de video

Recorta video a un clip preciso por frame, sin empaquetar ffmpeg.

Recorta video a un clip que termina exactamente en el frame indicado — Fotovid se encarga de los keyframes para que los límites del corte queden limpios. El microservicio ffmpeg listo para integrar te entrega una URL de MP4 alojada.

Obtén tu API key — gratis Lee la documentación →

curl -X POST https://api.fotovid.co/v1/video/trim \
  -H "Authorization: Bearer p6_YOUR_KEY_ID:YOUR_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "source_url": "https://cdn.yoursite.com/recording.mp4",
    "params": {
      "start": "00:00:05",
      "end": "00:00:20"
    }
  }'

Recortar video en serverless es más difícil de lo que parece

Cortar un clip suena como un solo comando de ffmpeg, pero ejecutar ese comando en Vercel, Lambda o Workers implica desplegar un binario estático de más de 70MB, lidiar con cold starts y límites de memoria, y transmitir el input además de alojar el output en algún lugar donde pueda quedarse. Los cortes precisos por frame obligan a un re-encode, lo que empuja el uso de CPU y el tiempo de ejecución más allá de lo que permiten la mayoría de las funciones serverless. Terminas manteniendo infraestructura que no tiene nada que ver con tu producto.

Los binarios de ffmpeg superan por mucho los límites de tamaño de bundle y memoria en serverless
El recorte preciso por frame exige un re-encode: trabajo lento y pesado en CPU que agota el timeout de las funciones
Aun así tienes que encargarte de descargar el input y alojar el clip resultante
Recurre a este endpoint cuando necesites highlights limpios, cortes para redes sociales o previews cortos sin tener que operar tu propio pipeline de media

Parámetros de la solicitud

POST /v1/video/trim

Field	Type	Default	Description
source_url*	string (URL)	—	URL HTTPS del video de origen
params.start*	string \| number	—	"HH:MM:SS(.mmm)" o segundos (p. ej. 5.5)
params.end*	string \| number	—	Debe ser mayor que start; se trunca al llegar a EOF

How it works

Tu primera llamada en tres pasos

1
Consigue una clave de API gratis
Regístrate y crea una clave desde el dashboard. Te autenticas enviando un header Authorization: Bearer p6_<key_id>:<secret>. Cada cuenta nueva empieza con credits de uso gratis, y $1 compra 100 credits — un recorte cuesta un credit por llamada.
2
Llama a POST /v1/video/trim
Envía una solicitud a https://api.fotovid.co/v1/video/trim con un body JSON que contenga source_url (la URL HTTPS de tu input) y un objeto params con start y end. Ambos aceptan un timestamp HH:MM:SS.mmm o un número de segundos; el corte es preciso por frame sobre el rango semiabierto [start, end) y se re-encodifica a MP4 con x264.
3
Usa la URL del clip que recibes
La respuesta es un JSON plano con id, type, una url alojada por fotovid para el MP4 recortado, un expires_at y la duración del clip. Descarga el archivo y guarda tu propia copia para controlar dónde vive — luego sírvelo, adjúntalo o pásalo al siguiente paso de tu workflow.

Preguntas frecuentes

Sigue explorando

Serverless ffmpeg — all guides Operaciones de audio Miniatura / portada de video ffmpeg en Supabase Edge Functions ffmpeg en AWS Lambda Precios

Lánzalo con una sola llamada a la API

Consigue una key gratis y haz tu primera llamada en menos de cinco minutos.

Obtén tu API key — gratis