Taglia il video in un clip preciso al frame, senza impacchettare ffmpeg.
Taglia il video in un clip che finisce esattamente sul frame giusto — Fotovid gestisce i keyframe così i bordi del taglio restano puliti. Il microservizio ffmpeg pronto all'uso ti restituisce un URL MP4 ospitato.
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"
}
}'Tagliare video su serverless è più difficile di quanto sembri
Tagliare un clip sembra richiedere un solo comando ffmpeg, ma eseguire quel comando su Vercel, Lambda o Workers significa distribuire un binario statico di oltre 70MB, combattere contro cold start e limiti di memoria, e trasmettere in streaming l'input e ospitare l'output da qualche parte dove possa restare. I tagli precisi al frame richiedono una ricodifica, che spinge l'uso della CPU e il tempo di esecuzione oltre quanto consentito dalla maggior parte delle funzioni serverless. Finisci per mantenere un'infrastruttura che non ha nulla a che fare con il tuo prodotto.
- I binari di ffmpeg superano di gran lunga i limiti di dimensione del bundle e di memoria del serverless
- Il taglio preciso al frame richiede una ricodifica — un lavoro lento e pesante per la CPU su cui le funzioni vanno in timeout
- Devi comunque occuparti di scaricare l'input e ospitare il clip risultante
- Usa questo endpoint quando hai bisogno di highlight puliti, tagli per i social o anteprime brevi senza dover gestire una pipeline multimediale
Parametri della richiesta
POST /v1/video/trim
| Field | Type | Default | Description |
|---|---|---|---|
| source_url* | string (URL) | — | URL HTTPS del video sorgente |
| params.start* | string | number | — | "HH:MM:SS(.mmm)" o secondi (es. 5.5) |
| params.end* | string | number | — | Deve essere maggiore di start; troncato a EOF |
La tua prima chiamata in tre passaggi
- 1Ottieni un'API key gratuita
Registrati e crea una chiave API dalla dashboard. Ti autentichi inviando un header Authorization: Bearer p6_<key_id>:<secret>. Ogni nuovo account parte con crediti di utilizzo gratuiti, e con $1 ottieni 100 crediti — un trim costa un credito per chiamata.
- 2Chiama POST /v1/video/trim
Invia una richiesta a https://api.fotovid.co/v1/video/trim con un body JSON che contiene source_url (l'URL HTTPS del tuo video di input) e un oggetto params con start ed end. Entrambi accettano un timestamp HH:MM:SS.mmm o un numero di secondi; il taglio è preciso al frame sull'intervallo semiaperto [start, end) e viene ricodificato in MP4 con x264.
- 3Usa l'URL del clip restituito
La risposta è un JSON piatto con id, type, una url ospitata da fotovid per l'MP4 tagliato, un expires_at e la durata del clip. Scarica il file e conserva una tua copia per controllare dove risiede — poi puoi servirlo, allegarlo o passarlo al passaggio successivo del tuo workflow.
Domande frequenti
Rilascialo con una sola chiamata API
Prendi una chiave gratuita e fai la tua prima chiamata in meno di cinque minuti.
