Kirimkan pekerjaan analisis sidik jari media dengan SubmitFpShotJob - ApsaraVideo Media Processing - Alibaba Cloud - ApsaraVideo Media Processing

Deskripsi operasi

Gunakan operasi ini untuk mengirimkan job untuk analisis DNA video, audio, gambar, dan teks.
Ini adalah API asinkron. Setelah Anda mengirimkan job, operasi mengembalikan ID job. Layanan kemudian mengantrekan job untuk pemrosesan di latar belakang. Ketika job selesai, ApsaraVideo Media Processing mengirimkan notifikasi callback dengan hasilnya. Anda juga dapat memanggil operasi QueryFpShotJob untuk memeriksa status job.
Fitur analisis DNA tersedia di region China (Beijing), China (Shanghai), China (Hangzhou), Asia Pacific SE 1 (Singapore), dan Saudi Arabia (Riyadh). Layanan di region Saudi Arabia (Riyadh) dioperasikan oleh mitra. Fitur ini tidak tersedia di region lain. Fitur analisis DNA teks hanya didukung di region China (Shanghai).
Format file input berikut didukung:
- Format gambar: JPEG, PNG, dan BMP.
- Format video: MP4, AVI, MKV, MPG, TS, MOV, FLV, dan MXF.
- Codec video: MPEG-2, MPEG-4, H.264, HEVC, dan WMV.
Untuk analisis DNA teks, pustaka DNA hanya mendukung string teks panjang yang ditambahkan dengan TextType diatur ke Text. Input pencarian harus berupa hasil Automatic Speech Recognition (ASR) dengan TextType diatur ke ASR. Hasil ASR harus berupa array JSON dari objek yang berisi field start, end, dan text.

Batas QPS

Operasi ini dibatasi hingga 100 kueri per detik (QPS) per pengguna. Panggilan yang melebihi batas ini akan terkena throttling, yang dapat memengaruhi bisnis Anda. Rencanakan panggilan Anda sesuai dengan itu. Untuk informasi lebih lanjut, lihat Batas QPS.

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

mts:SubmitFpShotJob

*全部资源

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
Input	string	Yes	File input untuk job. Anda dapat menentukan file dengan menggunakan URL OSS, URL HTTP, atau aset media ApsaraVideo VOD. URL OSS: String JSON yang berisi triplet OSS. Contoh: `{"Bucket":"test-bucket","Location":"oss-cn-shanghai","Object":"test.mp4"}` URL HTTP: URL yang dapat diakses secara publik. Contoh: `http://example-test-**.mp4`. Aset media ApsaraVideo VOD: string JSON yang berisi ID aset media. Contoh: `{"MediaId":"99238321"}` Catatan* Region bucket OSS dan region penyimpanan aset media harus sama dengan region tempat Anda menggunakan layanan ApsaraVideo Media Processing.	{"Bucket":"example-bucket-**","Location":"oss-cn-shanghai","Object":"example-**.flv"}
PipelineId	string	No	ID pipeline yang digunakan untuk notifikasi pesan. Anda dapat menemukan ID pipeline di bawah Global Settings > Pipelines di konsol ApsaraVideo Media Processing.	88c6ca184c0e47098a5b665e2a12****
FpShotConfig	string	Yes	Konfigurasi job DNA video. Nilainya harus berupa objek JSON. Untuk informasi lebih lanjut, lihat FpShotConfig.	{ "PrimaryKey": "12345**", "SaveType": "save", "FpDBId": "417f2ada5999daf**" }
UserData	string	No	Data yang ditentukan pengguna. Nilainya dapat memiliki panjang hingga 128 byte dan tidak boleh dimulai dengan karakter khusus.	testid-****

Elemen respons

Element	Type	Description	Example
	object	Parameter respons.
RequestId	string	ID permintaan.	25818875-5F78-4A13-BEF6-D7393642CA58
JobId	string	ID job DNA video. Kami menyarankan Anda menyimpan ID ini untuk panggilan berikutnya ke operasi terkait.	2a0697e35a7342859f733a9190c4****

Parameter notifikasi asinkron

Parameter	Tipe	Deskripsi
Type	String	Tipe pesan.
FpShotJobNotify	AliyunFpShotJobNotify	Job DNA video. Untuk informasi lebih lanjut, lihat tipe data AliyunFpShotJobNotify.
UserData	String	Data yang ditentukan pengguna.

Contoh

Respons sukses

JSONformat

{
  "RequestId": "25818875-5F78-4A13-BEF6-D7393642CA58",
  "JobId": "2a0697e35a7342859f733a9190c4****"
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.