Watermerk toevoegen aan video of afbeeldingen — de API voor logo- en tekstoverlays.
Overlay een logo-afbeelding of tekst op elke video of afbeelding met één POST. Positie, dekking en schaal stel je direct in de request in; je krijgt een door fotovid gehost bestand terug, klaar om te serveren.
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
}
}'Waarom watermerken op serverless zo lastig is
Een watermerk toevoegen lijkt triviaal, tot je het binnen een serverless function probeert uit te voeren. Het overlay-filter van ffmpeg heeft de volledige binary nodig plus je logo op een schrijfbare schijf, en decodeert en her-encodeert vervolgens het hele bestand — wat bij alles dat langer is dan een korte clip structureel de executielimieten en geheugenlimieten van Lambda en Vercel overschrijdt. Je blijft dan layer-bundels, tijdelijke opslag en cold starts beheren, alleen om een logo in een hoek te stempelen.
- De ffmpeg-binary en -libraries blazen je deploy op tot ver voorbij de gebruikelijke serverless-groottelimieten
- Een video in volledige lengte opnieuw encoderen overschrijdt al snel function-timeouts en geheugenlimieten
- Een afbeelding overlayen betekent bestanden ophalen, klaarzetten en weer opruimen op een kortstondige schijf
- Positie, dekking en schaal pixelperfect afstemmen over verschillende resoluties is priegelig filter-graph-werk
Request-parameters
POST /v1/video/watermark & /v1/image/watermark
| Field | Type | Default | Description |
|---|---|---|---|
| source_url* | string (URL) | — | HTTPS-URL van de bronvideo of -afbeelding |
| params.type | "image" | "text" | "combo" | "text" | Soort watermerk |
| params.watermark_image_url | string (URL) | — | URL van de logo-afbeelding (verplicht bij image/combo) |
| params.text | string | — | Tekst voor de overlay (verplicht bij 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 | Breedte van het watermerk relatief ten opzichte van de bron (0–1) |
Je eerste call in drie stappen
- 1Haal een gratis API key op
Meld je aan en maak een key aan. Je authenticeert elke request met een Authorization: Bearer p6_<key_id>:<secret>-header. Geen kaart nodig om te starten — je betaalt met credits ($1 = 100 credits, en een watermerk kost 1 credit).
- 2POST je bron en watermerk-parameters
Roep POST /v1/video/watermark of POST /v1/image/watermark aan met de standaard envelope: een source_url die naar je input wijst (een https-URL), plus een params-object. Zet type op image, text of combo, en geef dan watermark_image_url en/of text mee, samen met position (top-left, top-right, bottom-left, bottom-right of center), opacity (0–1), scale (0–1, standaard 0.15) en padding. Fotovid downloadt de input, overlayt het watermerk en antwoordt synchroon.
- 3Sla de teruggegeven result-URL op
De response is platte JSON met een id, type en een door fotovid gehoste url voor het bestand met watermerk (bij video's wordt er ook een duration meegegeven). Download het bestand en bewaar je eigen kopie — behandel de gehoste URL als een tussenstap, niet als permanente opslag, want hij verloopt.
Veelgestelde vragen
Zet het live met één API-aanroep
Pak een gratis key en doe je eerste aanroep in minder dan vijf minuten.