All Products
Search
Document Center

CDN:Tambahkan watermark

Last Updated:Aug 21, 2026

Anda dapat menambahkan watermark untuk branding dan publisitas, yang membantu melindungi hak cipta gambar serta mencegah penggunaannya tanpa izin. Alibaba Cloud CDN mendukung watermark gambar dan teks. Anda dapat menempatkan watermark pada gambar dan mengatur transparansinya agar tidak mengganggu konten gambar.

Fitur image editing Alibaba Cloud CDN, fitur image editing Dynamic Content Delivery Network (DCDN), dan fitur Image Processing (IMG) Object Storage Service (OSS) merupakan fitur independen dan tidak dapat saling dipertukarkan.

Image editing gratis hingga pemberitahuan lebih lanjut.

Usage notes

  • Anda dapat menambahkan hingga lima watermark ke dalam satu gambar. Watermark gambar dan teks didukung.

  • Ukuran watermark gambar tidak dapat diubah. Ukuran gambar dasar yang digunakan sebagai watermark tidak boleh melebihi 1 MB.

Parameters

Action: watermark

  • Basic parameters

    Parameter

    Description

    Value range

    t

    Opasitas watermark teks atau gambar.

    [0,100]

    Nilai default: 100. Nilai 100 berarti watermark bersifat opaque (tidak transparan).

    g

    Posisi watermark pada gambar.

    • nw: kiri atas.

    • north: tengah atas.

    • ne: kanan atas.

    • west: kiri tengah.

    • center: tengah.

    • east: kanan tengah.

    • sw: kiri bawah.

    • south: tengah bawah.

    • se: kanan bawah.

    Untuk informasi lebih lanjut mengenai posisi-posisi tersebut, lihat gambar berikut.

    x

    Margin horizontal, yaitu jarak horizontal antara watermark dan tepi gambar. Parameter ini hanya berlaku jika watermark berada di kiri atas, kiri tengah, kiri bawah, kanan atas, kanan tengah, atau kanan bawah gambar.

    [0,4096]

    Nilai default: 10. Satuan: piksel.

    y

    Margin vertikal, yaitu jarak vertikal antara watermark dan tepi bawah gambar. Parameter ini hanya berlaku jika watermark berada di kiri atas, tengah atas, kanan atas, tengah bawah, atau kanan bawah gambar.

    [0,4096]

    Nilai default: 10. Satuan: piksel.

Anda dapat menggunakan x, y, dan offset untuk menyesuaikan posisi watermark pada gambar. Anda juga dapat menggunakan parameter-parameter ini untuk mengatur tata letak watermark saat gambar memiliki beberapa watermark.

水印位置

  • Picture watermark parameters

    Parameter

    Description

    Value range

    image

    URL watermark yang dapat diakses melalui Internet. Jika URL yang ditentukan memerlukan autentikasi atau izin untuk diakses, Alibaba Cloud CDN mungkin gagal mengambil URL watermark tersebut.

    URL watermark harus diencode dalam bentuk Base64. Untuk informasi selengkapnya, lihat Encode watermarks.

    String yang diencode Base64

  • Text watermark parameters

    Parameter

    Description

    Value range

    text

    Konten watermark teks. Konten teks harus diencode dalam bentuk Base64. Untuk informasi selengkapnya, lihat Encode watermarks.

    String yang diencode Base64 dengan panjang maksimal 60 karakter.

    type

    Font watermark teks. Nama font harus diencode dalam bentuk Base64. Untuk informasi selengkapnya, lihat Encode watermarks.

    Hingga 10 font didukung. Untuk informasi selengkapnya, lihat tabel berikut.

    Catatan

    Jika Anda menentukan font yang tidak didukung, sistem akan menggunakan alihyaihei secara default.

    color

    Warna watermark teks. Nilai yang valid untuk parameter ini adalah nilai warna RGB.

    Contohnya, 000000 merepresentasikan hitam, dan FFFFFF merepresentasikan putih.

    Nilai default: 000000.

    rotate

    Sudut rotasi watermark teks searah jarum jam.

    [0,360]

    Nilai default: 0. Nilai 0 berarti watermark teks tidak diputar.

    fill

    Menentukan apakah gambar dasar akan diisi (tile) dengan watermark teks.

    Nilai yang valid: 0 dan 1. Nilai default: 0.

    • 0: tidak mengisi gambar dasar dengan watermark teks.

    • 1: mengisi gambar dasar dengan watermark teks.

    size

    Ukuran watermark teks.

    (0,1000]

    Nilai default: 40.

    Satuan: piksel.

    Tabel berikut menjelaskan nilai-nilai yang valid untuk parameter type beserta string terencode dari nilai-nilai tersebut.

    Text font

    Description

    Encoded value

    alihyaihei

    Font tebal. Ini adalah font default.

    YWxpaHlhaWhlaQ

    hysong

    Variasi font Songti.

    aHlzb25n

    hyhei

    Variasi font Heiti.

    aHloZWk

    hyshuangxian

    Font garis ganda.

    aHlzaHVhbmd4aWFu

    comfortaa

    Comfortaa

    Y29tZm9ydGFh

    notosans

    NotoSans

    bm90b3NhbnM

Encode watermarks

Saat menambahkan watermark, konten dan font watermark teks serta URL watermark gambar harus diencode dalam bentuk URL-safe Base64. Untuk mengencode watermark, lakukan langkah-langkah berikut:

  1. Encode konten watermark dalam bentuk Base64.

    Kami menyarankan Anda menggunakan alat pengkodean URL-safe Base64 untuk mengencode konten dan font watermark teks serta URL watermark gambar. String terencode watermark hanya dapat digunakan dalam parameter yang digunakan untuk menambahkan watermark. Jangan sertakan string terencode watermark dalam string signature.

  2. Ganti karakter dalam konten watermark yang telah diencode Base64 berdasarkan aturan berikut:

    • Ganti tanda plus (+) dengan tanda hubung (-).

    • Ganti garis miring (/) dengan garis bawah (_).

    • Abaikan tanda sama dengan (=) di akhir konten watermark yang telah diencode Base64.

Examples

  • Tambahkan watermark teks "Hello World":

    Encode string "Hello World" ke dalam bentuk string URL-safe Base64. Untuk informasi selengkapnya, lihat Encode watermarks. Hasil pengkodean watermark teks adalah SGVsbG8gV29ybGQ. Hasil pengkodean font hysong adalah aHlzb25n. URL pemrosesan gambar adalah http(s)://example.com/image01.png?image_process=watermark,text_SGVsbG8gV29ybGQ,type_aHlzb25n.

  • Tambahkan watermark teks dan gambar:

    • Tambahkan watermark teks: Hello World. String URL-safe Base64-nya adalah SGVsbG8gV29ybGQ.

    • Atur posisi watermark teks ke kanan bawah, margin horizontal ke 10 piksel, dan offset vertikal dari garis tengah ke 10 piksel menggunakan g_se,x_10,y_10.

    • Encode URL watermark gambar http://example-test.oss-ap-southeast-1.aliyuncs.com/image/shuiyin.png menjadi string aHR0cDovL2V4YW1wbGUtdGVzdC5vc3MtYXAtc291dGhlYXN0LTEuYWxpeXVuY3MuY29tL2ltYWdlL3NodWl5aW4ucG5n.

    • Atur posisi watermark gambar ke kiri atas, margin horizontal ke 10 piksel, dan offset vertikal dari garis tengah ke 10 piksel menggunakan g_nw,x_10,y_10.

    • URL pemrosesan gambar adalah http(s)://example.com/image01.png?image_process=watermark,text_SGVsbG8gV29ybGQ,g_se,x_10,y_10/watermark,image_aHR0cDovL2V4YW1wbGUtdGVzdC5vc3MtYXAtc291dGhlYXN0LTEuYWxpeXVuY3MuY29tL2ltYWdlL3NodWl5aW4ucG5n,g_nw,x_10,y_10