Add Watermark
Apply a text or image watermark to a single image.
POST /api/free/watermarkUsar Add Watermark en línea
Sube, configura, previsualiza y descarga sin clave API.
1. Subida y ajustes
Úsalo sin clave. Los archivos solo se envían al ejecutar la solicitud.
2. Vista previa y descarga
Aquí se muestran la vista previa, los cambios de tamaño y la descarga
Integrar mediante API
Solo las llamadas programáticas requieren una clave API. Abajo se documentan parámetros, respuestas y errores.
POST /api/free/watermarkEl uso en línea no requiere clave; las llamadas programáticas necesitan una clave de APIAny.
- Provide watermarkImage for image watermark or text for text watermark.
- Returns a PNG image response.
Respuesta
Una solicitud correcta devuelve una respuesta image con el Content-Type descrito.
Errores comunes
- 400
- Falta un archivo o parámetro, no es válido o supera un límite.
- 401
- Falta la clave para la llamada programática, es inválida o está desactivada.
- 429
- Se alcanzó el límite compartido en línea o autenticado.
Parámetros y límites
| Parámetro | Requisito | Predeterminado | Valores aceptados |
|---|---|---|---|
imageSource image | Obligatorio | — | file |
watermarkImageWatermark image | Opcional | — | file |
textWatermark text | Opcional | — | text |
positionPosition | Opcional | bottom-right | top-left, top-right, bottom-left, bottom-right, center |
opacityOpacity | Opcional | 0.5 | number |
fontSizeFont size | Opcional | 32 | number |
colorText color | Opcional | #ffffff | text |
Ejemplo de API
Este ejemplo autenticado es para código. El Playground no solicita ni expone tu clave.
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
Preguntas frecuentes
¿Necesito una clave para Add Watermark?
No en el Playground. Las llamadas programáticas usan Authorization: Bearer o X-API-Key.
¿Qué límites tiene Add Watermark?
En línea: 3 solicitudes por minuto y 30 al día. Las cuentas gratuitas autenticadas tienen 5 RPM y las de pago 500 RPM entre todas las API gratuitas.
¿Qué entradas acepta Add Watermark?
Usa los campos obligatorios y opcionales de la tabla. Los formatos no admitidos y valores fuera de rango se rechazan.
¿Qué devuelve Add Watermark?
Las solicitudes correctas devuelven una respuesta image; los errores usan los códigos HTTP indicados.