Hoe kies ik welk frame de thumbnail wordt?

Geef een tijdstip mee in het params-object — als HH:MM:SS.mmm-string of als aantal seconden. Fotovid springt naar dat punt en extraheert dat frame. Een gangbare aanpak is een seconde of twee verder te gaan, zodat je zwarte intro-frames overslaat.

In welk formaat komt de thumbnail terug?

De response is flat JSON met een door Fotovid gehoste url voor de geëxtraheerde frame-afbeelding, plus id, type en expires_at. Je richt je op die url, of download de bytes om zelf te hosten.

Moet ik het ruwe videobestand zelf versturen?

Nee. Elke endpoint verwacht een source_url — de https-URL van je invoervideo. Fotovid haalt deze server-side op, dus je uploadt het bestand nooit via je eigen functie of stuurt het via de request body.

Moet ik op de lange termijn op de hosted URL vertrouwen?

Beschouw het als een tussentijds resultaat, niet als permanente opslag. De response bevat een expires_at, dus voor alles wat je bewaart — een galerij of feed — download je de afbeelding en sla je een eigen kopie op in je bucket of CDN.

Wat is het verschil met Cloudinary of Transloadit?

Die bundelen storage, een volledige transform-pipeline en een CDN. Fotovid is unbundled en developer-first: één HTTP call doet één taak — een coverframe ophalen — tegen een lage, usage-based prijs, zonder platform waar je naartoe moet migreren.

Wat kost een thumbnail-extractie?

Prijzen zijn gebaseerd op credits: $1 = 100 credits, en de meeste operaties, inclusief extract-cover, kosten elk 1 credit. Je start met gratis credits, dus de eerste integratie en tests kosten niets.

Videothumbnail / cover

Video Thumbnail API: coverframe extraheren op elk tijdstip

Geef Fotovid een tijdstip op en het legt precies dat frame vast als hosted image — direct te gebruiken als galerijpreview, feed-thumbnail of video-poster.

Haal je gratis API-key Lees de docs →

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
    }
  }'

Waarom één frame vastleggen lastiger is dan het lijkt

Een video-thumbnail is conceptueel simpel: naar een tijdstip springen, één frame decoderen, het als afbeelding encoderen. In de praktijk draai je zelf ffmpeg of leun je op een log mediaplatform. Een ffmpeg-binary meebundelen overschrijdt al snel de grootte- en geheugenlimieten van serverless, cold starts worden traag, en het decoderen van een grote bron kan de timeout van je functie overschrijden. En zelden heb je de hele toolchain nodig — je wilt gewoon één frame eruit.

ffmpeg-binaries zijn te groot voor de meeste serverless bundles en vreten je cold-start-budget op
Een grote video decoderen voor één enkel frame kan de geheugen- en timeoutlimieten van je functie overschrijden
Je moet de bron zelf ophalen, het proces draaien en het resultaat vervolgens ergens uploaden
Volledige mediaplatforms bundelen transforms, storage en CDN die je helemaal niet wilt, alleen om aan één poster te komen

Request-parameters

POST /v1/video/extract-cover

Field	Type	Default	Description
source_url*	string (URL)	—	HTTPS-URL van de bronvideo (uitgelezen via HTTP Range)
params.at	number	1	Seconden in de video waarop het frame wordt opgehaald

How it works

Je eerste call in drie stappen

1
Vraag een gratis API key aan
Meld je aan en maak een key aan. Je authenticeert elke request met een Authorization: Bearer p6_<key_id>:<secret> header. Nieuwe keys starten met gratis credits, zodat je thumbnails kunt opzetten voordat je iets betaalt.
2
Roep POST /v1/video/extract-cover aan
Stuur een JSON-envelope waarin source_url naar de https-URL van je video wijst, plus een params-object waarin je het gewenste tijdstip opgeeft (als HH:MM:SS.mmm-string of in seconden). Fotovid haalt de bron op, decodeert het frame op dat punt en encodeert het als afbeelding op onze infrastructuur — geen ffmpeg in jouw stack.
3
Gebruik de teruggegeven, door Fotovid gehoste image-URL
De response is flat JSON met id, type en een door Fotovid gehoste url die naar het geëxtraheerde frame wijst, plus een expires_at. Render het direct als thumbnail of poster, of download het en bewaar je eigen kopie in je bucket, zodat jij de levensduur bepaalt.

Veelgestelde vragen

Blijf verkennen

Serverless ffmpeg — all guides Watermerk-operatie Operatie · Audio extraheren ffmpeg op AWS Lambda ffmpeg op Vercel Prijzen

Zet het live met één API-aanroep

Pak een gratis key en doe je eerste aanroep in minder dan vijf minuten.

Haal je gratis API-key