Operazione video

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

FieldTypeDefaultDescription
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 | numberDeve essere maggiore di start; troncato a EOF
How it works

La tua prima chiamata in tre passaggi

  1. 1
    Ottieni 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.

  2. 2
    Chiama 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.

  3. 3
    Usa 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.