Lindungi IP Video dengan menambahkan watermark tidak terlihat melalui SubmitCopyrightJob - Intelligent Media Services - Alibaba Cloud - Intelligent Media Services

Mengirimkan pekerjaan watermark hak cipta video.

Deskripsi operasi

Secara default, mengirimkan pekerjaan watermark hak cipta video hanya mendukung video dengan durasi 3 menit atau lebih. Jika video terlalu pendek, hal ini dapat menyebabkan pemanggilan API gagal atau tidak ada output. Untuk menambahkan watermark hak cipta ke video pendek yang berdurasi kurang dari 3 menit, tentukan parameter di Params. Untuk informasi lebih lanjut, lihat deskripsi parameter.
Setiap kali Anda memanggil API untuk mengirimkan pekerjaan watermark hak cipta video, watermark ditambahkan ke satu video. Mengirimkan beberapa video secara bersamaan tidak didukung.
Saat ini, operasi API yang terkait dengan watermark digital hanya didukung di wilayah China (Shanghai) dan China (Beijing).
Ini adalah operasi API asinkron. Setelah Anda mengirimkan node, ID node akan dikembalikan. Node belum selesai pada saat ini dan masuk ke antrian latar belakang untuk dieksekusi secara asinkron. Hasil akhir akan diberi tahu melalui callback. Anda juga dapat secara aktif mengkueri status node dengan memanggil operasi Daftar pekerjaan watermark hak cipta video.

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

ice:SubmitCopyrightJob

none

*Semua Sumber daya.

*

None

Sintaks permintaan

POST  HTTP/1.1

Parameter permintaan

Parameter	Type	Required	Description	Example
Input	object	Yes	File video yang akan ditambahkan watermark. Catatan Wilayah file OSS atau aset media harus sama dengan wilayah IMS saat ini.
Type	string	Yes	Tipe file input. Nilai valid: OSS: URL file OSS. Media: ID aset media.	OSS
Media	string	Yes	Informasi tentang file input. URL OSS dan ID aset media didukung. Aturan URL OSS adalah sebagai berikut: oss://bucket/object http(s)://bucket.oss-[regionId].aliyuncs.com/object Di URL, bucket adalah nama bucket OSS yang berada di wilayah yang sama dengan proyek saat ini, dan objek adalah jalur file.	oss://bucket/object
Output	object	Yes	URL file output. Catatan Wilayah OSS harus sama dengan wilayah IMS saat ini.
Type	string	Yes	Tipe file output. Nilai valid: OSS: URL file OSS.	OSS
Media	string	Yes	Informasi tentang file output. Hanya URL OSS yang didukung. Aturan URL OSS adalah sebagai berikut: oss://bucket/object http(s)://bucket.oss-[regionId].aliyuncs.com/object Di URL, bucket adalah nama bucket OSS yang berada di wilayah yang sama dengan proyek saat ini, dan objek adalah jalur file.	oss://test-bucket/output.mp4
Message	string	Yes	Informasi watermark yang akan ditambahkan.	Copyright watermark test
StartTime	integer	No	Waktu mulai watermark, dalam detik. Jika Anda tidak menentukan parameter ini, nilai default adalah 0.	0
TotalTime	integer	No	Waktu akhir watermark, dalam detik. Jika Anda tidak menentukan parameter ini, nilai default adalah durasi video.	10
Level	integer	No	Level watermark, yang menunjukkan saluran penyematan. Nilai valid: 0 (0u), 1 (1uv), dan 2 (2yuv).	0
Description	string	No	Deskripsi informasi watermark.	Task description
UserData	string	No	Data yang ditentukan pengguna, dengan panjang maksimum 1.024 byte.	123
Params	string	No	Parameter pekerjaan watermark, dalam format string JSON. Parameter berikut didukung: algoType: tipe algoritma. Nilai default: v1. v1: watermark hak cipta video panjang, yang hanya mendukung video dengan durasi lebih dari 3 menit. v2: watermark hak cipta video pendek.	{"algoType":"v2"}

Elemen respons

Element	Type	Description	Example
	object	Skema tanggapan.
Data	object	Data tanggapan.
JobId	string	ID pekerjaan.	bfb786c63****f4d80648792021eff90
Message	string	Paket tanggapan.	ok
RequestId	string	ID permintaan.	FA258E67-09B8-4EAA-8F33-BA567834A2C3
StatusCode	integer	Kode status.	200

Contoh

Respons sukses

JSONformat

{
  "Data": {
    "JobId": "bfb786c63****f4d80648792021eff90"
  },
  "Message": "ok",
  "RequestId": "FA258E67-09B8-4EAA-8F33-BA567834A2C3\n",
  "StatusCode": 200
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.