Come scelgo quale fotogramma diventa la thumbnail?

Passa un timestamp nell'oggetto params, come stringa HH:MM:SS.mmm o come numero di secondi. Fotovid si posiziona su quel punto ed estrae quel fotogramma. Uno schema comune è campionare uno o due secondi dopo l'inizio, così eviti i fotogrammi neri dell'intro.

In che formato viene restituita la thumbnail?

La risposta è un JSON piatto che contiene un url ospitato da Fotovid per l'immagine del fotogramma estratto, più id, type e expires_at. Punti il tuo a quell'url oppure scarichi i byte per riospitarli tu.

Devo inviare il file video grezzo?

No. Ogni endpoint accetta un source_url, l'URL https del tuo video di input. Fotovid lo recupera lato server, quindi non carichi mai il file attraverso la tua funzione né lo trasmetti nel corpo della richiesta.

Posso fare affidamento sull'URL ospitato a lungo termine?

Trattalo come un risultato di lavoro, non come uno spazio di archiviazione permanente. La risposta include un expires_at, quindi per tutto ciò che conservi, come una galleria o un feed, scarica l'immagine e conserva una tua copia nel tuo bucket o CDN.

In cosa è diverso da Cloudinary o Transloadit?

Quelle piattaforme includono spazio di archiviazione, un'intera pipeline di trasformazione e una CDN. Fotovid è disaggregato e pensato prima di tutto per gli sviluppatori: una chiamata HTTP fa un solo lavoro, estrarre un fotogramma di copertina, a un prezzo basso e basato sull'uso, senza alcuna piattaforma su cui migrare.

Quanto costa un'estrazione di thumbnail?

I prezzi sono in crediti d'uso: $1 = 100 crediti, e la maggior parte delle operazioni, incluso extract-cover, costa 1 credito ciascuna. Parti con crediti gratuiti, quindi l'integrazione iniziale e i test non costano nulla.

Thumbnail / copertina video

API per thumbnail video: estrai un fotogramma di copertina a qualsiasi timestamp

Indica a Fotovid un timestamp e cattura quel singolo fotogramma come immagine ospitata, pronta da usare come anteprima di galleria, thumbnail del feed o poster del video.

Ottieni la tua chiave API — gratis Leggi la documentazione →

curl -X POST https://api.fotovid.co/v1/video/extract-cover \
  -H "Authorization: Bearer p6_YOUR_KEY_ID:YOUR_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "source_url": "https://cdn.yoursite.com/clip.mp4",
    "params": {
      "at": 3
    }
  }'

Perché estrarre un fotogramma è più difficile di quanto sembri

Una thumbnail video è concettualmente banale: posizionati su un timestamp, decodifica un fotogramma, codificalo come immagine. In pratica devi eseguire ffmpeg tu stesso oppure affidarti a una piattaforma media sovraccarica di funzionalità. Includere un binario ffmpeg supera i limiti di dimensione e memoria serverless, i cold start diventano lenti e decodificare una sorgente di grandi dimensioni può superare il timeout di una funzione. E raramente ti serve l'intera toolchain: ti serve solo un fotogramma.

I binari ffmpeg sono troppo grandi per la maggior parte dei bundle serverless e consumano il budget di cold start
Decodificare un video di grandi dimensioni per estrarre un solo fotogramma può superare i limiti di memoria e timeout della funzione
Devi recuperare la sorgente, eseguire il processo, poi caricare tu stesso il risultato da qualche parte
Le piattaforme media complete includono trasformazioni, spazio di archiviazione e CDN che non ti servono solo per ottenere un poster

Parametri della richiesta

POST /v1/video/extract-cover

Field	Type	Default	Description
source_url*	string (URL)	—	URL HTTPS del video sorgente (letto tramite HTTP Range)
params.at	number	1	Secondi nel video a cui catturare il fotogramma

How it works

La tua prima chiamata in tre passaggi

1
Ottieni una API key gratuita
Registrati e crea una key. Autentichi ogni richiesta con un header Authorization: Bearer p6_<key_id>:<secret>. Le nuove key partono con crediti d'uso gratuiti, così puoi collegare le thumbnail prima di pagare qualsiasi cosa.
2
Chiama POST /v1/video/extract-cover
Invia un involucro JSON con source_url che punta all'URL https del tuo video, più un oggetto params in cui puoi specificare il timestamp da catturare (come stringa HH:MM:SS.mmm o in secondi). Fotovid recupera la sorgente, decodifica il fotogramma in quel punto e lo codifica come immagine sulla nostra infrastruttura: nessun ffmpeg nel tuo stack.
3
Usa l'URL restituito dell'immagine ospitata
La risposta è un JSON piatto con id, type e un url ospitato da Fotovid che punta al fotogramma estratto, insieme a un expires_at. Puoi renderizzarlo direttamente come thumbnail o poster, oppure scaricarlo e conservare una tua copia nel tuo bucket per controllarne la durata.

Domande frequenti

Continua a esplorare

Serverless ffmpeg — all guides Operazione di filigrana Operazione · Estrazione audio ffmpeg su AWS Lambda ffmpeg su Vercel Prezzi

Rilascialo con una sola chiamata API

Prendi una chiave gratuita e fai la tua prima chiamata in meno di cinque minuti.

Ottieni la tua chiave API — gratis