Media

Filigrane de Texte sur Video

Ajoute une filigrane de texte aux videos avec position, taille de police, couleur, opacité et synchronisation personnalisables

file· Résultat fichierOuvrir l'outil

Démarrage rapide

Appelez cet outil depuis votre code en trois langages.

cURL

# 1) Upload each file first → returns { filePath }
curl -X POST 'https://api.elysiatools.com/upload/video-watermark-text' \
  -F 'file=@/path/to/videoFile.ext'

# 2) Call the tool with the returned filePath values
curl -X POST 'https://api.elysiatools.com/fr/api/tools/video-watermark-text' \
  -F 'videoFile=/path/to/file.ext' \
  -F 'text=Watermark' \
  -F 'position=bottom-right' \
  -F 'fontSize=24' \
  -F 'fontColor=#FFFFFF' \
  -F 'opacity=0.7' \
  -F 'margin=20' \
  -F 'animationMode=static' \
  -F 'animationSpeed=50' \
  -F 'backgroundColor=#000000' \
  -F 'backgroundOpacity=0' \
  -F 'shadowOpacity=0.5' \
  -F 'startTime=0' \
  -F 'endTime=-1' \
  -F 'outputFormat=mp4'

Référence de l'API

Envoyez une requête POST avec vos entrées en JSON. Les paramètres de type fichier nécessitent un upload préalable.

Point d'accès

HTTP

POST https://api.elysiatools.com/fr/api/tools/video-watermark-text

Paramètres

Nom	Type	Requis	Description
videoFile	fileupload requis	Oui	—
text	text	Oui	—
position	select	Non	—
fontSize	range	Non	Taille du texte de la filigrane (8-200 pixels)
fontColor	color	Non	Couleur du texte de la filigrane
opacity	range	Non	Opacité du texte (0.1 = transparent, 1 = opaque)
margin	range	Non	Distance des bords video (0-200 pixels)
animationMode	select	Non	—
animationSpeed	range	Non	Vitesse de mouvement en pixels par seconde (10-500)
backgroundColor	color	Non	Couleur de la boîte de fond derrière le texte
backgroundOpacity	range	Non	Opacité du fond (0 = pas de fond, 1 = solide)
shadowOpacity	range	Non	Opacité de l'ombre du texte (0 = pas d'ombre, 1 = ombre solide)
startTime	number	Non	Quand commencer à afficher la filigrane (0 = du début)
endTime	number	Non	Quand arrêter d'afficher la filigrane (-1 = jusqu'à la fin)
outputFormat	select	Non	—

Les paramètres de type fichier doivent d'abord être uploadés via POST /upload/video-watermark-text ; le filePath renvoyé est ensuite transmis au champ correspondant.

Format de réponse

Résultat fichier

JSON

{
  "filePath": "/public/processing/randomid.ext",
  "fileName": "output.ext",
  "contentType": "application/octet-stream",
  "size": 1024,
  "metadata": {
    "key": "value"
  },
  "error": "Error message (optional)",
  "message": "Notification message (optional)"
}

Intégration MCP

Ajoutez cet outil à votre serveur Model Context Protocol pour que les agents IA puissent le lister et l'appeler.

Configuration du serveur

Ajoutez ce bloc à la configuration de votre client MCP :

mcp.json

{
  "mcpServers": {
    "elysiatools-video-watermark-text": {
      "name": "video-watermark-text",
      "description": "Ajoute une filigrane de texte aux videos avec position, taille de police, couleur, opacité et synchronisation personnalisables",
      "baseUrl": "https://api.elysiatools.com/mcp/sse?toolId=video-watermark-text",
      "command": "",
      "args": [],
      "env": {},
      "isActive": true,
      "type": "sse"
    }
  }
}

Lister les outils disponibles

Après connexion au point d'accès SSE, listez les outils exposés :

tools/list

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list"
}

Appeler cet outil

Appelez l'outil par son id ; les arguments sont construits à partir de ses paramètres :

tools/call

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "video-watermark-text",
    "arguments": {
  "videoFile": "https://example.com/file.ext",
  "text": "Watermark",
  "position": "bottom-right",
  "fontSize": 24,
  "fontColor": "#FFFFFF",
  "opacity": 0.7,
  "margin": 20,
  "animationMode": "static",
  "animationSpeed": 50,
  "backgroundColor": "#000000",
  "backgroundOpacity": 0,
  "shadowOpacity": 0.5,
  "startTime": 0,
  "endTime": -1,
  "outputFormat": "mp4"
}
  }
}

Chaînez plusieurs outils dans une session avec une liste toolId séparée par des virgules, ex. /mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp (20 max).

Les paramètres fichier acceptent uniquement une URL de fichier publique (https://…). Les chemins locaux, les data: URI et les chaînes Base64 ne sont pas pris en charge.

Des questions ou un problème ? Contactez [email protected]