This page was machine-translated. Spotted a mistake?Help improve it.
Skip to content

Watermark Video

Incruste un filigrane texte sur chaque image d'une vidéo avec une position, une taille, une opacité et une couleur configurables.

API Endpoint

POST /api/v1/tools/video/watermark-video

Accepte des données de formulaire multipart avec un fichier vidéo et un champ JSON settings.

Parameters

ParameterTypeRequiredDefaultDescription
textstringYes-Texte du filigrane (1-200 caractères)
positionstringNo"br"Position sur l'image : tl, tc, tr, l, c, r, bl, bc, br
fontSizeintegerNo36Taille de police en pixels (8-120)
opacitynumberNo0.5Opacité du filigrane (0.05-1)
colorstringNo"#ffffff"Couleur hexadécimale du texte (par exemple "#ffffff")

Position Values

  • tl - En haut à gauche, tc - En haut au centre, tr - En haut à droite
  • l - Au milieu à gauche, c - Au centre, r - Au milieu à droite
  • bl - En bas à gauche, bc - En bas au centre, br - En bas à droite

Example Request

bash
curl -X POST http://localhost:1349/api/v1/tools/video/watermark-video \
  -H "Authorization: Bearer si_your-api-key" \
  -F "[email protected]" \
  -F 'settings={"text": "PREVIEW", "position": "c", "fontSize": 48, "opacity": 0.3}'

Example Response

json
{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/clip.mp4",
  "originalSize": 12500000,
  "processedSize": 12400000
}

Notes

  • Le filigrane est incrusté définitivement dans les images de la vidéo et ne peut pas être retiré après le traitement.
  • Le filigrane utilise une police sans empattement intégrée à FFmpeg.
  • Pour les filigranes image, utilisez plutôt l'outil image Watermark.