Wie lege ich fest, welcher Frame zum Thumbnail wird?

Übergib im params-Objekt einen Zeitpunkt – entweder als HH:MM:SS.mmm-String oder als Sekundenzahl. Fotovid springt an diese Stelle und extrahiert genau diesen Frame. Gängige Praxis: ein bis zwei Sekunden hineingehen, damit du schwarze Intro-Frames überspringst.

In welchem Format kommt das Thumbnail zurück?

Die Response ist flaches JSON mit einer von Fotovid gehosteten url auf das extrahierte Frame-Bild, dazu id, type und expires_at. Du hängst dein an diese url oder lädst die Bytes herunter und hostest sie selbst.

Muss ich die Videodatei selbst hochladen?

Nein. Jeder Endpoint nimmt eine source_url entgegen – die https-URL deines Ausgangsvideos. Fotovid holt sie serverseitig, du schleust die Datei also nie durch deine eigene Function oder durch den Request-Body.

Kann ich mich langfristig auf die gehostete URL verlassen?

Betrachte sie als Arbeitsergebnis, nicht als dauerhaften Speicher. Die Response enthält ein expires_at – alles, was du behalten willst, etwa für eine Galerie oder einen Feed, lädst du besser herunter und legst eine eigene Kopie in deinem Bucket oder CDN ab.

Worin unterscheidet sich das von Cloudinary oder Transloadit?

Die bündeln Storage, eine komplette Transform-Pipeline und ein CDN. Fotovid bündelt nichts davon und ist ganz auf Entwickler ausgelegt: Ein HTTP-Call erledigt genau eine Aufgabe – einen Cover-Frame herausholen – zu einem niedrigen, nutzungsbasierten Preis, ohne dass du auf eine Plattform migrieren musst.

Was kostet eine Thumbnail-Extraktion?

Abgerechnet wird über nutzungsbasierte Credits: $1 = 100 Credits, und die meisten Operationen – extract-cover eingeschlossen – kosten jeweils 1 Credit. Du startest mit kostenlosen Credits, Integration und erste Tests kosten dich also nichts.

Video-Thumbnail / Cover

Video-Thumbnail-API: Cover-Frame zu jedem Zeitpunkt extrahieren

Gib Fotovid einen Zeitpunkt vor, und du bekommst genau diesen Frame als gehostetes Bild zurück – direkt einsetzbar als Galerie-Vorschau, Feed-Thumbnail oder Video-Poster.

API-Schlüssel holen – kostenlos Dokumentation lesen →

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

Warum das Extrahieren eines einzelnen Frames schwieriger ist, als es aussieht

Ein Video-Thumbnail ist konzeptionell trivial: zu einem Zeitpunkt springen, einen Frame decodieren, ihn als Bild encodieren. In der Praxis betreibst du dafür entweder ffmpeg selbst oder hängst dich an eine überladene Media-Plattform. Ein ffmpeg-Binary im Bundle sprengt die Größen- und Speicherlimits von Serverless-Umgebungen, die Cold Starts werden träge, und das Decodieren einer großen Quelldatei kann das Timeout deiner Function überschreiten. Und die komplette Toolchain brauchst du nur selten – du brauchst genau einen Frame.

ffmpeg-Binaries sind für die meisten Serverless-Bundles zu groß und fressen dein Cold-Start-Budget
Ein großes Video nur für einen einzigen Frame zu decodieren kann Speicher- und Timeout-Limits deiner Function sprengen
Du musst die Quelldatei selbst laden, den Prozess starten und das Ergebnis anschließend irgendwo hochladen
Große Media-Plattformen bündeln Transformationen, Storage und CDN, die du gar nicht willst – nur damit du ein einziges Poster bekommst

Request-Parameter

POST /v1/video/extract-cover

Field	Type	Default	Description
source_url*	string (URL)	—	HTTPS-URL des Quellvideos (wird per HTTP Range gelesen)
params.at	number	1	Sekunden ins Video hinein, an denen der Frame entnommen wird

How it works

Dein erster Call in drei Schritten

1
Kostenlosen API-Schlüssel holen
Registrier dich und leg einen Schlüssel an. Jeden Request authentifizierst du mit einem Authorization: Bearer p6_<key_id>:<secret> Header. Neue Schlüssel starten mit kostenlosen Credits – du kannst deine Thumbnail-Integration also aufsetzen, bevor du irgendetwas bezahlst.
2
POST /v1/video/extract-cover aufrufen
Schick einen JSON-Envelope mit source_url auf die https-URL deines Videos, dazu ein params-Objekt, in dem du den gewünschten Zeitpunkt angeben kannst (als HH:MM:SS.mmm-String oder in Sekunden). Fotovid lädt die Quelldatei, decodiert den Frame an dieser Stelle und encodiert ihn auf unserer Infrastruktur als Bild – ffmpeg taucht in deinem Stack nicht auf.
3
Gehostete Bild-URL aus der Response nutzen
Die Response ist flaches JSON mit id, type und einer von Fotovid gehosteten url auf den extrahierten Frame, dazu ein expires_at. Zeig sie direkt als Thumbnail oder Poster an – oder lad das Bild herunter und leg eine eigene Kopie in deinem Bucket ab, damit du die Lebensdauer selbst bestimmst.

Häufige Fragen

Weiterlesen

Serverless ffmpeg — all guides Wasserzeichen-Operation Operation · Audio extrahieren ffmpeg auf AWS Lambda ffmpeg auf Vercel Preise

Mit einem API-Call live gehen

Hol dir einen kostenlosen Schlüssel und mach deinen ersten Call in unter fünf Minuten.

API-Schlüssel holen – kostenlos