All Products
Search
Document Center

ApsaraVideo VOD:AddWatermark

Last Updated:Oct 27, 2026

Membuat template watermark gambar atau teks. Untuk menyederhanakan pemrosesan watermark, ApsaraVideo VOD mengemas parameter watermark kompleks seperti posisi, ukuran, font, dan warna ke dalam template, yang direferensikan oleh ID template watermark yang unik.

Deskripsi operasi

  • Anda dapat memanggil operasi ini untuk menambahkan template watermark gambar (Image) atau teks (Text). Template watermark gambar mendukung format berikut: gambar statis (PNG) dan gambar animasi (GIF, APNG, dan MOV).

  • Setelah Anda menambahkan template watermark gambar atau teks, Anda harus memanggil operasi AddTranscodeTemplateGroup atau UpdateTranscodeTemplateGroup untuk mengaitkan template watermark dengan kelompok template transkoding. Ini memungkinkan Anda menggunakan template watermark untuk tugas transkoding watermark berikutnya.

  • Untuk informasi selengkapnya tentang penambahan watermark gambar atau teks ke video, lihat Watermark gambar dan teks.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

  • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

  • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

  • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

  • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

    • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

    • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

  • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

  • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

vod:AddWatermark

create

*Semua resource.

*

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

Type

string

Yes

Tipe template watermark. Nilai valid:

  • Image: template watermark gambar. Ini adalah nilai default.

  • Text: template watermark teks.

Image

Name

string

Yes

Nama template watermark.

  • Nama hanya dapat berisi karakter dan digit bahasa Mandarin dan Inggris.

  • Panjang nama dapat mencapai 128 byte.

  • Nama harus dienkode dalam UTF-8.

Image watermark template

WatermarkConfig

string

Yes

Informasi konfigurasi watermark gambar atau teks dalam format JSON. Konfigurasi mencakup posisi tampilan dan efek watermark. Parameter konfigurasi untuk watermark gambar dan watermark teks berbeda. Untuk informasi selengkapnya tentang struktur parameter, lihat WatermarkConfig.

{ "Width": "55", "Height": "55", "Dx": "9", "Dy": "9", "ReferPos": "BottomLeft" }

FileUrl

string

No

URL OSS dari file gambar watermark. URL tidak berisi informasi otentikasi.

Catatan
  • Parameter permintaan diperlukan saat Anda membuat template watermark gambar dengan menetapkan Type ke Image.

  • Anda dapat memanggil operasi CreateUploadAttachedMedia untuk mengunggah gambar watermark ke ApsaraVideo VOD. Nilai parameter FileURL yang dikembalikan setelah pengunggahan dapat digunakan sebagai nilai parameter permintaan.

http://outin-326268*****63e1403e7.oss-cn-shanghai.aliyuncs.com/image/cover/C99345*****E7FDEC-6-2.png

AppId

string

No

ID aplikasi. Nilai default: app-1000000. Jika sistem multi-aplikasi diaktifkan, Anda dapat menentukan ID aplikasi untuk menambahkan template watermark ke aplikasi tertentu. Untuk informasi selengkapnya, lihat Sistem multi-aplikasi.

app-****

Elemen respons

Element

Type

Description

Example

object

RequestId

string

ID permintaan.

25818875-5F78-4A*****F6-D7393642CA58

WatermarkInfo

object

Informasi template watermark.

CreationTime

string

Waktu pembuatan template watermark. Waktu mengikuti format yyyy-MM-ddTHH:mm:ssZ. Waktu ditampilkan dalam UTC.

2018-11-07T09:05:52Z

Type

string

Tipe template watermark. Nilai valid:

  • Image: template watermark gambar

  • Text: template watermark teks

Image

IsDefault

string

Apakah template watermark merupakan template watermark gambar atau teks default. Nilai valid:

  • Default: template watermark gambar atau teks default

  • NotDefault: template watermark gambar atau teks non-default

NotDefault

FileUrl

string

URL file watermark. URL dapat berupa URL OSS atau URL CDN.

Catatan

Parameter ini hanya dikembalikan untuk template watermark gambar.

https://outin-3262*****9f4b3e7.oss-cn-shanghai.aliyuncs.com/image/cover/E6C3448CC8B715E6F8A72EC6B-6-2.png?Expires=1541600583&OSSAccessKeyId=****&Signature=gmf1eYMoDVg%2BHQCb4UGozBW****

WatermarkConfig

string

Informasi konfigurasi watermark gambar atau teks dalam format JSON. Konfigurasi mencakup posisi tampilan dan efek watermark. Parameter konfigurasi untuk watermark gambar dan watermark teks berbeda. Untuk informasi selengkapnya tentang struktur parameter, lihat WatermarkConfig.

{ "Width": "55", "Height": "55", "Dx": "9", "Dy": "9", "ReferPos": "BottomLeft" }

Name

string

Nama template watermark.

Image watermark template

WatermarkId

string

ID template watermark. Anda dapat menggunakan ID template watermark untuk mengaitkan template watermark dengan kelompok template transkoding, atau mengkueri, mengubah, atau menghapus template watermark, atau mengaturnya sebagai template watermark default.

9bcc8bfadb84*****109a2671d0df97

Contoh

Respons sukses

JSONformat

{
  "RequestId": "25818875-5F78-4A*****F6-D7393642CA58",
  "WatermarkInfo": {
    "CreationTime": "2018-11-07T09:05:52Z",
    "Type": "Image",
    "IsDefault": "NotDefault",
    "FileUrl": "https://outin-3262*****9f4b3e7.oss-cn-shanghai.aliyuncs.com/image/cover/E6C3448CC8B715E6F8A72EC6B-6-2.png?Expires=1541600583&OSSAccessKeyId=****&Signature=gmf1eYMoDVg%2BHQCb4UGozBW****",
    "WatermarkConfig": "{\n      \"Width\": \"55\",\n      \"Height\": \"55\",\n      \"Dx\": \"9\",\n      \"Dy\": \"9\",\n      \"ReferPos\": \"BottomLeft\"\n}",
    "Name": "Image watermark template",
    "WatermarkId": "9bcc8bfadb84*****109a2671d0df97"
  }
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.