Nouveaux utilisateurs : crédits gratuits, sans carte bancaire Commencer
APIAny.Dev logoAPIAny.Dev

Add Watermark

Apply a text or image watermark to a single image.

POST /api/free/watermark

Utiliser Add Watermark en ligne

Importez, réglez, prévisualisez et téléchargez sans clé API.

Sans connexion ni clé API

1. Import et réglages

Utilisez l’outil sans clé. Les fichiers ne sont envoyés qu’au lancement.

Source image *
Watermark image
Watermark text
Position
Opacity
Font size
Text color
Complétez les champs requis pour lancer l’outil.POST /api/free-online/watermark

2. Aperçu et téléchargement

Le résultat apparaîtra ici

L’aperçu, les variations de taille et le téléchargement s’affichent ici

Intégrer via l’API

Seuls les appels programmatiques nécessitent une clé API. Les paramètres, réponses et erreurs sont documentés ci-dessous.

Endpoint API
POST /api/free/watermark

L’usage en ligne est sans clé. Les appels programmatiques nécessitent une clé APIAny.

Fonctionnement
  • Provide watermarkImage for image watermark or text for text watermark.
  • Returns a PNG image response.

Réponse

Une requête réussie renvoie une réponse image avec le Content-Type décrit ici.

Erreurs fréquentes

400
Un fichier ou paramètre manque, est invalide ou dépasse une limite.
401
La clé des appels programmatiques manque, est invalide ou désactivée.
429
La limite partagée en ligne ou authentifiée est atteinte.

Paramètres et limites

ParamètreExigenceDéfautValeurs acceptées
imageSource imageRequis—file
watermarkImageWatermark imageOptionnel—file
textWatermark textOptionnel—text
positionPositionOptionnelbottom-righttop-left, top-right, bottom-left, bottom-right, center
opacityOpacityOptionnel0.5number
fontSizeFont sizeOptionnel32number
colorText colorOptionnel#fffffftext

Exemple API

Cet exemple authentifié est destiné au code. Le Playground ne demande ni n’expose votre clé.

curl -X POST "https://apiany.ai/api/free/watermark" \
  -H "Authorization: Bearer $API_KEY" \
  -F "image=@input.png" \
  -F "text=APIAny" \
  -F "position=bottom-right" \
  --output watermarked.png

Questions fréquentes

Faut-il une clé API pour Add Watermark ?

Non dans le Playground. Les appels programmatiques utilisent Authorization: Bearer ou X-API-Key.

Quelles limites pour Add Watermark ?

En ligne : 3 requêtes par minute et 30 par jour. Les comptes gratuits authentifiés ont 5 RPM et les comptes payants 500 RPM pour toutes les API gratuites.

Quelles entrées accepte Add Watermark ?

Utilisez les champs requis et optionnels du tableau. Les formats non pris en charge et valeurs hors plage sont refusés.

Que renvoie Add Watermark ?

Les requêtes réussies renvoient une réponse image ; les erreurs utilisent les codes HTTP indiqués.

Source : catalogue APIAny et comportement réel des routes. Révision : 2026-07-17.