Todos los productos
Search
Centro de documentos

Edge Security Acceleration:Agregar marcas de agua a las imágenes

Última actualización: Sep 06, 2026

Las marcas de agua ayudan a proteger los derechos de autor de las imágenes y a promover su marca. Edge Security Acceleration (ESA) es compatible con marcas de agua de texto y de imagen. Puede colocar las marcas de agua en posiciones específicas de una imagen y ajustar su transparencia.

Parámetros

image_process=watermark

  • Parámetros básicos (posiciones de la marca de agua)

    水印位置

Parámetro

Descripción

Rango de valores

t

La opacidad de la marca de agua.

[0,100]

Valor predeterminado: 100. Un valor de 100 indica que la marca de agua es completamente opaca.

g

La posición de la marca de agua en la imagen.

  • nw: superior izquierda

  • north: superior central

  • ne: superior derecha

  • west: central izquierda

  • center: centro

  • east: central derecha

  • sw: inferior izquierda

  • south: inferior central

  • se: inferior derecha

x

El margen horizontal entre la marca de agua y el borde de la imagen. Este parámetro solo surte efecto cuando la marca de agua se ubica en el lado izquierdo o derecho de la imagen.

[0,4096]

Valor predeterminado: 10. Unidad: px.

y

El margen vertical entre la marca de agua y el borde de la imagen. Este parámetro solo surte efecto cuando la marca de agua se ubica en la parte superior o inferior de la imagen.

[0,4096]

Valor predeterminado: 10. Unidad: px.

Nota

Puede usar x, y y offset para ajustar las posiciones de la marca de agua. Estos parámetros también facilitan la distribución del diseño cuando una imagen tiene varias marcas de agua.

  • Parámetros de la marca de agua de imagen

Parámetro

Descripción

Rango de valores

image

La URL de la imagen de la marca de agua, la cual debe ser de acceso público. Si la URL requiere autenticación o permisos específicos, ESA podría no recuperar la imagen.

La URL debe estar codificada en Base64. Para obtener más información, consulte Encode watermarks.

Cadenas codificadas en Base64

  • Parámetros de la marca de agua de texto

Parámetro

Descripción

Rango de valores

text

El contenido de la marca de agua de texto, el cual debe estar codificado en Base64. Para obtener más información, consulte Encode watermarks.

Una cadena codificada en Base64 de hasta 60 caracteres

type

La fuente de la marca de agua de texto, la cual debe estar codificada en Base64. Para obtener más información, consulte Encode watermarks.

Puede especificar hasta 10 fuentes. Para obtener información sobre las fuentes compatibles y sus valores codificados, consulte type settings and encoding.

color

El color de la marca de agua de texto, definido como un valor hexadecimal RGB.

Por ejemplo, 000000 representa el negro y FFFFFF representa el blanco.

Valor predeterminado: 000000.

rotate

El ángulo de rotación en sentido horario de la marca de agua de texto.

[0,360]

Valor predeterminado: 0. Un valor de 0 significa que no hay rotación. Unidad: °.

fill

Indica si se debe aplicar un mosaico de la marca de agua de texto sobre la imagen.

Valores válidos: 0 y 1. Valor predeterminado: 0.

  • 0: no aplica el mosaico de la marca de agua de texto sobre la imagen.

  • 1: aplica el mosaico de la marca de agua de texto sobre la imagen.

size

El tamaño de fuente de la marca de agua de texto.

[1,1000]

Valor predeterminado: 40.

Unidad: px.

Configuración y codificación de type

Fuente de texto

Descripción

Valor codificado

alihyaihei

Una fuente en negritas. Esta es la fuente predeterminada.

YWxpaHlhaWhlaQ

hysong

Una variante de la fuente Songti.

aHlzb25n

hyhei

Una variante de la fuente Heiti.

aHloZWk

hyshuangxian

Una fuente de doble línea.

aHlzaHVhbmd4aWFu

fzltzhk

Una variante de la fuente Heiti.

ZnpsdHpoaw

fzshengsks

Una fuente de estilo caligráfico regular.

ZnpzaGVuZ3Nrcw

fzqusongjian

Una variante de la fuente Songti.

ZnpxdXNvbmdqaWFu

zzgfxingyan

Una fuente artística.

enpnZnhpbmd5YW4

comfortaa

Comfortaa

Y29tZm9ydGFh

notosans

NotoSans

bm90b3NhbnM

Nota

Si especifica una fuente que no aparece en la lista anterior, se utiliza la fuente predeterminada alihyaihei.

Codificar marcas de agua

Cuando agrega marcas de agua, debe codificar en Base64 el contenido de texto y el nombre de la fuente, o bien la URL de la imagen de la marca de agua, mediante caracteres seguros para URL. Siga estos pasos para codificar las marcas de agua:

  1. Codifique el contenido de la marca de agua en Base64.

Nota

Se recomienda utilizar herramientas de codificación Base64 seguras para URL para codificar el contenido de texto, los nombres de las fuentes y las URL de las imágenes de las marcas de agua. El contenido de la marca de agua codificado en Base64 solo aplica a los parámetros específicos de dicha marca. No incluya este contenido codificado en las cadenas de firma.

  1. Reemplace los caracteres del contenido de la marca de agua codificado en Base64 según las siguientes reglas:

    • Sustituya los signos más (+) por guiones (-).

    • Sustituya las barras diagonales (/) por guiones bajos (_).

    • Omita los signos igual (=) al final del contenido de la marca de agua codificado en Base64.

Ejemplos

  • Agregar la marca de agua de texto "Hello World".

Codifique la marca de agua de texto Hello World en Base64 seguro para URL. Para obtener más información, consulte Encode watermarks. El texto codificado es SGVsbG8gV29ybGQ. El valor codificado de la fuente hysong es aHlzb25n. La URL de procesamiento de imágenes es http(s)://example.com/image01.png?image_process=watermark,text_SGVsbG8gV29ybGQ,type_aHlzb25n.

  • Agregar marcas de agua de texto y de imagen.

    • Codifique la marca de agua de texto "Happy New Year" en Base64 seguro para URL para obtener la cadena 5paw5bm05b-r5LmQ. Establezca la posición de la marca de agua en la esquina inferior derecha, el margen horizontal en 10 píxeles y el desplazamiento vertical en 10 píxeles mediante g_se,x_10,y_10.

    • Codifique la URL de la imagen de la marca de agua http://example-test.oss-ap-southeast-1.aliyuncs.com/image/shuiyin.png en Base64 seguro para URL para obtener la cadena aHR0cDovL2V4YW1wbGUtdGVzdC5vc3MtYXAtc291dGhlYXN0LTEuYWxpeXVuY3MuY29tL2ltYWdlL3NodWl5aW4ucG5n. Establezca la posición de la marca de agua en la esquina superior izquierda, el margen horizontal en 10 píxeles y el desplazamiento vertical en 10 píxeles mediante g_nw,x_10,y_10.

    • Especifique la URL de procesamiento de imágenes como http(s)://example.com/image01.png?image_process=watermark,text_5paw5bm05b-r5LmQ,g_se,x_10,y_10/watermark,image_aHR0cDovL2V4YW1wbGUtdGVzdC5vc3MtYXAtc291dGhlYXN0LTEuYWxpeXVuY3MuY29tL2ltYWdlL3NodWl5aW4ucG5n,g_nw,x_10,y_10.