Wasserzeichen auf Video oder Bilder legen – die API für Logo- und Text-Overlays.
Mit einem einzigen POST legst du ein Logo oder einen Text über jedes Video oder Bild. Position, Deckkraft und Skalierung setzt du direkt im Request; zurück kommt eine von Fotovid gehostete Datei, fertig zum Ausliefern.
curl -X POST https://api.fotovid.co/v1/video/watermark \
-H "Authorization: Bearer p6_YOUR_KEY_ID:YOUR_SECRET" \
-H "Content-Type: application/json" \
-d '{
"source_url": "https://cdn.yoursite.com/clip.mp4",
"params": {
"type": "image",
"watermark_image_url": "https://cdn.yoursite.com/logo.png",
"position": "bottom-right",
"opacity": 0.7,
"scale": 0.2
}
}'Warum Wasserzeichen in Serverless-Functions nerven
Wasserzeichen wirken trivial – bis du sie in einer Serverless-Function laufen lassen willst. Der overlay-Filter von ffmpeg braucht das komplette Binary plus dein Logo auf einem beschreibbaren Datenträger, dann dekodiert und kodiert er die komplette Datei neu. Bei allem, was länger als ein kurzer Clip ist, sprengt das regelmäßig die Laufzeit- und Speicherlimits von Lambda und Vercel. Am Ende jonglierst du mit Layer-Bundles, temporärem Speicher und Cold Starts – nur um ein Logo in eine Ecke zu stempeln.
- Das ffmpeg-Binary samt Libraries bläht dein Deployment weit über die üblichen Serverless-Größenlimits hinaus
- Ein Video in voller Länge neu zu kodieren sprengt Function-Timeouts und Arbeitsspeicher
- Ein Bild einzublenden heißt: Dateien laden, auf einem kurzlebigen Datenträger zwischenspeichern und wieder aufräumen
- Position, Deckkraft und Skalierung über alle Auflösungen hinweg pixelgenau hinzubekommen, ist fummelige Filtergraph-Arbeit
Request-Parameter
POST /v1/video/watermark & /v1/image/watermark
| Field | Type | Default | Description |
|---|---|---|---|
| source_url* | string (URL) | — | HTTPS-URL des Quellvideos oder -bilds |
| params.type | "image" | "text" | "combo" | "text" | Art des Wasserzeichens |
| params.watermark_image_url | string (URL) | — | URL des Logo-Bilds (Pflicht bei image/combo) |
| params.text | string | — | Text für das Overlay (Pflicht bei text/combo) |
| params.position | string | "bottom-right" | top-left · top-right · bottom-left · bottom-right · center |
| params.opacity | number | 1 | 0–1 |
| params.scale | number | 0.15 | Breite des Wasserzeichens relativ zur Quelle (0–1) |
Dein erster Call in drei Schritten
- 1Kostenlosen API-Schlüssel holen
Registrier dich und leg einen Schlüssel an. Jeden Request authentifizierst du mit dem Header Authorization: Bearer p6_<key_id>:<secret>. Für den Start brauchst du keine Kreditkarte – abgerechnet wird über Credits (1 $ = 100 Credits, ein Wasserzeichen kostet 1 Credit).
- 2Quelle und Wasserzeichen-Parameter per POST schicken
Ruf POST /v1/video/watermark oder POST /v1/image/watermark mit dem Standard-Envelope auf: eine source_url, die auf deine Eingabe zeigt (eine https-URL), plus ein params-Objekt. Setz type auf image, text oder combo und übergib dann watermark_image_url und/oder text – dazu position (top-left, top-right, bottom-left, bottom-right oder center), opacity (0–1), scale (0–1, Standard 0.15) und padding. Fotovid lädt die Eingabe herunter, legt das Wasserzeichen darüber und antwortet synchron.
- 3Die zurückgegebene Ergebnis-URL speichern
Die Antwort ist flaches JSON mit id, type und einer von Fotovid gehosteten url für die Datei mit Wasserzeichen (bei Video kommt zusätzlich duration zurück). Lade sie herunter und leg eine eigene Kopie ab – die gehostete URL ist nur eine Zwischenstation, kein dauerhafter Speicher, denn sie läuft ab.
Häufige Fragen
Mit einem API-Call live gehen
Hol dir einen kostenlosen Schlüssel und mach deinen ersten Call in unter fünf Minuten.