Kirim pekerjaan watermarking A/B melalui SubmitTraceAbJob - Intelligent Media Services - Alibaba Cloud - Intelligent Media Services

Mengirim pekerjaan untuk menghasilkan varian aliran A/B dari video untuk watermark forensik.

Deskripsi operasi

Operasi ini hanya mendukung video yang berdurasi tiga menit atau lebih. Mengirim pekerjaan untuk video yang lebih pendek dapat menyebabkan panggilan API gagal atau tidak menghasilkan output.
Ini adalah antarmuka asinkron. Setelah Anda mengirim pekerjaan, sistem akan mengembalikan ID pekerjaan dan memproses pekerjaan tersebut secara asinkron. Anda dapat memperoleh hasil pemrosesan melalui callback atau dengan mengkueri daftar pekerjaan watermark forensik aliran A/B.

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:SubmitTraceAbJob

none

*Semua resource.

*

None

Sintaks permintaan

POST  HTTP/1.1

Parameter permintaan

Parameter	Type	Required	Description	Example
Input	object	Yes	Video input untuk pekerjaan watermark forensik aliran A/B. Catatan File Object Storage Service (OSS) atau aset media harus berada di wilayah yang sama dengan tempat Intelligent Media Services (IMS) diterapkan. Operasi ini hanya mendukung video yang berdurasi tiga menit atau lebih. Menggunakan video yang lebih pendek dapat menyebabkan panggilan API gagal atau tidak menghasilkan output.
Type	string	Yes	Tipe file input. Nilai valid: `OSS`: File ditentukan oleh URL OSS. `Media`: File ditentukan oleh ID aset media.	OSS
Media	string	Yes	Lokasi file input. Ini dapat berupa URL OSS atau ID aset media. Format URL OSS yang didukung adalah: 1. `oss://<bucket>/<objek>` 2. `http(s)://<bucket>.oss-[regionId].aliyuncs.com/<objek>` Dalam format ini, `<bucket>` adalah nama bucket OSS, yang harus berada di wilayah yang sama dengan proyek Anda, dan `<objek>` adalah jalur ke file.	oss://bucket/object
Output	object	Yes	Lokasi output untuk pekerjaan aliran A/B. Ini harus berupa direktori OSS.
Type	string	Yes	Tipe objek output. Nilai valid: `OSS`: Objek OSS. `Media`: ID aset media.	OSS
Media	string	Yes	Jalur output. Tentukan URL direktori OSS atau ID aset media. Jika Anda menentukan URL OSS, gunakan salah satu format berikut untuk direktori output: 1. `oss://<bucket>/<dir>/` 2. `http(s)://<bucket>.oss-[regionId].aliyuncs.com/<dir>/` Dalam format ini, `<bucket>` adalah nama bucket OSS, yang harus berada di wilayah yang sama dengan proyek Anda, dan `<dir>` adalah jalur direktori output.	oss://bucket/dir/
StartTime	integer	No	Pengatur waktu mulai untuk penyematan watermark, dalam detik.	0
TotalTime	integer	No	Durasi total untuk penyematan watermark, dalam detik.	360
Level	integer	No	Level watermark, yang menentukan saluran penyematan. Nilai valid: `0` (saluran U), `1` (saluran UV), dan `2` (saluran YUV).	0
UserData	string	No	Data pengguna untuk disertakan dalam permintaan. Panjang maksimum adalah 1.024 byte.	123
CipherBase64ed	string	No	Kunci enkripsi yang dienkode Base64.	Qh6OdgIMcliQSI1fReOw****

Elemen respons

Element	Type	Description	Example
	object	Badan respons.
Data	object	Berisi ID untuk pekerjaan yang dikirim dan aset media output.
JobId	string	ID pekerjaan.	bfb786c639894f4d80648792021e****
TraceMediaId	string	ID aset media yang dibuat untuk jejak.	bf53333264f4d80648792021e****
Message	string	Paket tanggapan. Nilai `ok` menunjukkan permintaan berhasil.	ok
RequestId	string	Pengidentifikasi unik untuk permintaan. Jika Anda mengalami masalah, berikan ID ini untuk dukungan teknis.	****36-3C1E-4417-BDB2-1E034F****
StatusCode	integer	Kode status HTTP. Nilai `200` menunjukkan keberhasilan.	200

Contoh

Respons sukses

JSONformat

{
  "Data": {
    "JobId": "bfb786c639894f4d80648792021e****",
    "TraceMediaId": "bf53333264f4d80648792021e****"
  },
  "Message": "ok",
  "RequestId": "******36-3C1E-4417-BDB2-1E034F******",
  "StatusCode": 200
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.