ApsaraVideo Media Processing:Parameter untuk operasi API produksi cerdas

Parameter

Tipe

Deskripsi

Output

STRING

Jika parameter JobParams dikonfigurasi untuk memisahkan bahasa Cina dan Inggris, placeholder {resultType} didukung dalam jalur file output untuk menentukan apakah file teks keluaran berbahasa Cina atau Inggris. zh menunjukkan Cina dan en menunjukkan Inggris.

Parameter

Tipe

Diperlukan

Deskripsi

fps

INT

Tidak

Laju pengambilan sampel frame. Parameter ini opsional. Nilainya adalah bilangan bulat. Nilai valid: [2,10]. Nilai default: 5.

roi

LIST

Tidak

Daerah yang diminati.

• Jika Anda menentukan daerah yang diminati, hanya teks di dalam daerah tersebut yang diekstraksi, dan teks di luar daerah tersebut diabaikan. Secara default, jika Anda tidak menentukan parameter ini, teks di bagian bawah seperempat gambar video diekstraksi.

• Atur nilainya dalam format berikut: [[atas, bawah], [kiri, kanan]].

• Nilai default: N/A.

sep

BOOLEAN

Tidak

Menentukan apakah akan menghasilkan file SRT terpisah untuk bahasa Cina dan Inggris. Parameter ini opsional. Nilai default: False.

formatter

STRING

Tidak

String format dari teks SRT. Contoh: "{\an8}". Parameter ini opsional. Nilai default: N/A.

Parameter

Tipe

Deskripsi

Result

STRING

Informasi rinci tentang hasil pekerjaan. Contoh informasi hasil sukses: {"Code":"Success","Message":"Successful.","Data":"{\"result\":[{\"file\":\"captionextraction/b48d02b58e9b6a0d1c13271bcf9aa6d7-161121379****.srt\"}]}"}.

Parameter

Tipe

Diperlukan

Deskripsi

bgimage

STRING

Tidak

Gambar latar belakang untuk penggantian. Contoh: http://example-image-****.example-location.aliyuncs.com/example/example.jpg.

• Jika Anda menentukan parameter ini, video MP4 dengan gambar latar belakang yang diganti dikembalikan.

• Jika Anda tidak menentukan parameter ini, video WebM dengan saluran alpha dikembalikan.

Parameter

Tipe

Deskripsi

Result

STRING

Informasi rinci tentang hasil pekerjaan. Contoh informasi hasil sukses: {"Code":"Success","Message":"Successful.","Data":"{\"result\":[{\"file\":\"videogreenscreenmatting/16e6bc5ca802e12429d082010164dba3-160275535****_matting.mp4\"}]}"}.

Parameter

Tipe

Diperlukan

Deskripsi

Tidak ada

Tidak ada

Tidak ada

Tidak ada

Parameter

Tipe

Deskripsi

Result

STRING

Informasi rinci tentang hasil pekerjaan. Contoh informasi hasil sukses: {"Code":"Success","Data":"{\"result\":[{\"start\":39.32,\"end\":63.85,\"title\":\"Chorus\"},{\"start\":86.69,\"end\":114.45,\"title\":\"Chorus\"},{\"start\":135.75,\"end\":160.27,\"title\":\"Chorus\"}]}","Message":"Successful."}.

Parameter

Tipe

Diperlukan

Deskripsi

Text

LIST

Tidak

Lokasi kotak teks yang ingin Anda hapus. Maksimal dua kotak teks didukung. Contoh: [[bx1, by1, bw1, bh1], [bx2, by2, bw2, bh2]].

• bx: Rasio koordinat x normalisasi pojok kiri atas kotak teks terhadap lebar video. Contoh: 0.1.

• by: Rasio koordinat y normalisasi pojok kiri atas kotak teks terhadap tinggi video. Contoh: 0.0.

• bw: Rasio lebar normalisasi kotak teks terhadap lebar video. Contoh: 0.3.

• bh: Rasio tinggi normalisasi kotak teks terhadap tinggi video. Contoh: 0.2.

LimitRegion

LIST

Tidak

Area di mana Anda ingin menghapus teks. Sistem mendeteksi teks dalam area yang ditentukan dan menghapus teks yang terdeteksi. Parameter ini memiliki prioritas lebih rendah daripada parameter Text yang secara langsung menentukan lokasi kotak teks yang akan dihapus. Contoh: [[0, 0.6, 1, 0.4]]. Dalam contoh ini, sistem mendeteksi teks dalam 40% bagian bawah gambar video dan menghapus teks yang terdeteksi.

Parameter

Tipe

Deskripsi

Result

STRING

Informasi rinci tentang hasil pekerjaan. Contoh informasi hasil sukses: {"Details":[],"Message":"success","Code":"Success"}.

Parameter

Tipe

Diperlukan

Deskripsi

Tidak ada

Tidak ada

Tidak ada

Tidak ada

Parameter

Tipe

Deskripsi

Result

STRING

Informasi rinci tentang hasil pekerjaan. Contoh informasi hasil sukses: {"Details":[],"Message":"success","Code":"Success"}.

Parameter

Tipe

Diperlukan

Deskripsi

Logo

STRING

Tidak

Posisi logo yang ingin Anda hapus. Atur nilai dalam format [xmin, ymin, width, height]. Anda dapat menghapus hingga dua logo sekaligus. Contoh: [[0, 0, 0.3, 0.3], [0.7, 0, 0.3, 0.3]].

Parameter

Tipe

Deskripsi

Result

STRING

Informasi rinci tentang hasil pekerjaan. Contoh informasi hasil sukses: {"Details":[],"Message":"success","Code":"Success"}.

Parameter

Tipe

Diperlukan

Deskripsi

Model

STRING

Tidak

Model gambar mini pintar. Gambar mini diam dihasilkan jika parameter ini dibiarkan kosong, dan gambar mini animasi dihasilkan jika parameter ini disetel ke gif.

Parameter

Tipe

Deskripsi

Result

STRING

Informasi rinci tentang hasil pekerjaan. Contoh informasi hasil sukses: {"Details":[],"Message":"success","Code":"Success"}{"Message":"success","Data":"[{\"Score\":8.270855992569906,\"Time\":\"28278.25\",\"Url\":\"cover/test-00001.jpg\"},{\"Score\":7.474117489692728,\"Time\":\"25942.583333333332\",\"Url\":\"cover/test-00002.jpg\"}]","Code":"Success"}. Dalam contoh ini, Score menunjukkan tingkat kepercayaan hasil gambar mini, Time menunjukkan cap waktu frame gambar mini, dan Url menunjukkan URL gambar mini.

Parameter

Tipe

Diperlukan

Deskripsi

Tidak ada

Tidak ada

Tidak ada

Tidak ada

Parameter

Tipe

Deskripsi

Result

STRING

Informasi rinci tentang hasil pekerjaan. Contoh informasi hasil sukses:

{"Code":"Success","Message":"Successful.","Data":"{\"result\":[{\"file\":\"videoclip/16e6bc5ca802e12429d082010164****-1602755353502-origin.mp4\"}]}"}

Parameter

Tipe

Diperlukan

Deskripsi

Tidak ada

Tidak ada

Tidak ada

Tidak ada

Parameter

Tipe

Deskripsi

Result

STRINGN

Informasi rinci tentang hasil pekerjaan. Contoh informasi hasil sukses: {"Details":[],"Message":"success","Code":"Success"}.

Parameter

Tipe

Diperlukan

Deskripsi

Tidak ada

Tidak ada

Tidak ada

Tidak ada

Parameter

Tipe

Deskripsi

Result

STRING

Informasi rinci tentang hasil pekerjaan. Contoh informasi hasil sukses: {"Details":[],"Message":"success","Code":"Success"}.

Parameter

Tipe

Diperlukan

Deskripsi

Tidak ada

Tidak ada

Tidak ada

Tidak ada

Parameter

Tipe

Deskripsi

Result

STRING

Informasi rinci tentang hasil pekerjaan. Contoh informasi hasil sukses: {"Code":"Success","Data":"{\"result\":[{\"file\":\"detectresult/normalvideo-161225931****.txt\"}]}","Message":"Successful."}.

Parameter

Tipe

Diperlukan

Deskripsi

inputs

STRING

Tidak

Daftar URL file trek audio yang akan dicampur. Anda hanya dapat menentukan satu URL. Contoh: {"file":"http://example-bucket-****.oss-cn-shanghai.aliyuncs.com/2.mp4"}.

Parameter

Tipe

Deskripsi

Result

STRING

Informasi rinci tentang hasil pekerjaan. Contoh informasi hasil sukses: {"Message":"Successful.","Data":"{\"result\":[{\"file\":\"audiomix/alibaba-161283935****-origin.mp4\"}]}","Code":"Success"}.

Parameter

Tipe

Deskripsi

Output

STRING

{resultType} placeholder didukung dalam jalur untuk membedakan apakah file hasil adalah gambar kartun atau gambar asli. result menunjukkan gambar kartun, dan origin menunjukkan gambar asli.

Parameter

Tipe

Deskripsi

Result

STRING

Informasi rinci tentang hasil pekerjaan. Contoh informasi hasil sukses: {"Code":"Success","Data":"{\"result\":[{\"file\":\"iproduction/test-result.jpg\"},{\"file\":\"iproduction/test-origin.jpg\"}]}","Message":"Successful."}.

Parameter

Tipe

Deskripsi

Result

STRING

Informasi rinci tentang hasil pekerjaan. Kode berikut menunjukkan contoh informasi hasil sukses.

Parameter

Deskripsi

Time

Timestamp yang dihasilkan ketika file input dinilai.

Input

Nama file input.

Total Duration

Durasi file input. Satuan: detik.

Speech Ratio

Rasio durasi data audio terhadap durasi file input. Nilai valid: [0,100]. Satuan: persentase.

Tag

Tag untuk file input, yang digunakan untuk menunjukkan validitas deteksi. Nilai valid:

• Valid: Deteksi valid, yang menunjukkan bahwa metrik kunci dan skor opini rata-rata (MOS) valid.

• File terlalu Pendek: Durasi file input kurang dari 2 detik.

• Bisu: File input tidak mengandung data audio.

• Suara terlalu Pendek: Durasi data audio kurang dari 2 detik.

MOS(0-5)

Skor MOS dari file input, yang menggambarkan kualitas data audio. Nilai valid: [0,5].

MOS

Deskripsi MOS. Nilai valid:

• (4,5]: Kualitas data audio sangat baik.

• [3,4): Kualitas data audio baik.

• [2,3): Kualitas data audio cukup.

• [1,2): Kualitas data audio buruk.

• [0,1): Kualitas data audio sangat buruk.

Discontinuity(0-5)

Skor kontinuitas data audio. Skor kontinuitas berkurang karena alasan berikut: masalah tersendat pada penangkapan data audio, masalah gema akibat audio multi-saluran, dan masalah kehilangan paket akibat konektivitas jaringan yang buruk. Nilai valid: [0,5].

Discontinuity

Deskripsi skor kontinuitas. Nilai valid:

• (4,5]: Kontinuitas data audio sangat baik.

• [3,4): Kontinuitas data audio baik.

• [2,3): Kontinuitas data audio cukup.

• [1,2): Kontinuitas data audio buruk.

• [0,1): Kontinuitas data audio sangat buruk.

Coloration(0-5)

Skor kejelasan data audio. Skor kejelasan berkurang karena alasan berikut: reverb besar, bitrate rendah, kesalahan pengkodean, dan pengucapan yang ambigu. Nilai valid: [0,5].

Coloration

Deskripsi skor kejelasan. Nilai valid:

• (4,5]: Kejelasan data audio sangat baik.

• [3,4): Kejelasan data audio baik.

• [2,3): Kejelasan data audio cukup.

• [1,2): Kejelasan data audio buruk.

• [0,1): Kejelasan data audio sangat buruk.

Noisiness(0-5)

Skor kebisingan data audio. Nilai valid: [0,5].

Noisiness

Deskripsi skor kebisingan. Nilai valid:

• (4,5]: Ketidaktergangguan data audio sangat baik.

• [3,4): Ketidaktergangguan data audio baik.

• [2,3): Ketidaktergangguan data audio cukup.

• [1,2): Ketidaktergangguan data audio buruk.

• [0,1): Ketidaktergangguan data audio sangat buruk.

Loudness(0-5)

Skor kerasnya suara manusia. Jika suara manusia jelas dan kuat, skor kerasnya tinggi; jika suara manusia sulit didengar, skor kerasnya cenderung menjadi 0. Nilai valid: [0,5].

Loudness

Deskripsi skor kerasnya. Nilai valid:

• (4,5]: Kerasnya suara manusia sangat baik.

• [3,4): Kerasnya suara manusia baik.

• [2,3): Kerasnya suara manusia cukup.

• [1,2): Kerasnya suara manusia buruk.

• [0,1): Kerasnya suara manusia sangat buruk.

Loudness(-90dB-0dB)

Rata-rata volume suara manusia. Nilai valid: [-90,0]. Satuan: desibel.

• Parameter ini menggambarkan volume suara manusia dalam desibel. Pada sebagian besar kasus, jika nilai parameter kurang dari -24, suara manusia terdengar rendah.

• Nilai default: -90.0. Ini menunjukkan bahwa tidak ada suara manusia yang terdeteksi secara eksplisit.

Double Talk Ratio(%)

Rasio durasi data audio dua saluran terhadap durasi data audio. Parameter ini membantu menentukan faktor-faktor kemungkinan skor kontinuitas rendah. Nilai valid: [0,100]. Satuan: persentase.

Bad Mute Ratio(%)

Persentase frame mute abnormal. Semua frame mute abnormal dari data audio yang tidak termasuk data audio dua saluran dihitung, tidak termasuk frame mute yang disebabkan oleh pemotongan data audio dua saluran. Nilai valid: [0,100]. Satuan: persentase.

Saturated Ratio(%)

Persentase segmen ledakan suara terhadap segmen suara. Parameter ini membantu menentukan apakah volume berlebihan menghasilkan ledakan suara dalam skala besar. Nilai valid: [0,100]. Satuan: persentase.

Worst MOS(0-5)

Skor MOS terendah selama proses penilaian. Nilai valid: [0,5].

Worst Discontinuity(0-5)

Skor kontinuitas terendah selama proses penilaian. Nilai valid: [0,5].

Worst Noisiness(0-5)

Skor kebisingan tertinggi selama proses penilaian. Nilai valid: [0,5].

Worst Coloration(0-5)

Skor kejelasan terendah selama proses penilaian. Nilai valid: [0,5].

Parameter

Tipe

Diperlukan

Deskripsi

beauty_params

STRING

Tidak

Parameter operasi FaceBeauty. Contoh: "whiten=20,smooth=50,face_thin=50"

Parameter

Tipe

Deskripsi

skin_beauty_enable

INT

Menentukan apakah akan mengaktifkan penghalusan kulit.

• Nilai valid: [0,1].

• 0: menonaktifkan penghalusan kulit.

• 1: mengaktifkan penghalusan kulit.

• Nilai default: 1.

shape_beauty_enable

INT

Menentukan apakah akan mengaktifkan pembentukan wajah.

• Nilai valid: [0,1].

• 0: menonaktifkan pembentukan wajah.

• 1: mengaktifkan pembentukan wajah.

• Nilai default: 1.

whiten

INT

Tingkat pemutihan kulit. Semakin besar nilainya, semakin putih kulit terlihat.

• Nilai valid: [0,100].

• Nilai default: 20

smooth

INT

Tingkat penghalusan kulit. Semakin besar nilainya, semakin halus kulit terlihat.

• Nilai valid: [0,100].

• Nilai default: 20

detail

INT

Tingkat granularitas kulit. Semakin besar nilainya, semakin halus kulit, dan semakin banyak detail kulit yang ada.

• Nilai valid: [0,100].

• Nilai default: 20

skin_model

INT

Menentukan apakah akan mengaktifkan fitur model kulit. Jika Anda mengaktifkan fitur ini, pemutihan kulit hanya berlaku untuk bagian yang terdeteksi sebagai kulit.

• Nilai valid: [0,1].

• 0: menonaktifkan fitur model kulit.

• 1: mengaktifkan fitur model kulit.

• Nilai default: 1.

cheek_thin

FLOAT

Tingkat penirusan tulang pipi depan.

• Nilai valid: [0,100].

• Nilai default: 0.

face_cut

FLOAT

Tingkat penyempitan tulang pipi.

• Nilai valid: [0,100].

• Nilai default: 0.

face_thin

FLOAT

Tingkat penirusan wajah.

• Nilai valid: [0,100].

• Nilai default: 0.

face_length

FLOAT

Tingkat penyesuaian panjang wajah (dua arah).

• Nilai valid: [-100,100].

• Nilai default: 0.

chin_length

FLOAT

Tingkat penyesuaian panjang dagu (dua arah).

• Nilai valid: [-100,100].

• Nilai default: 0.

chin_thin

FLOAT

Tingkat penirusan dagu.

• Nilai valid: [0,100].

• Nilai default: 0.

eye_size

FLOAT

Tingkat pelebaran mata.

• Nilai valid: [0,100].

• Nilai default: 0.

eye_corner1

FLOAT

Tingkat penyesuaian canthus vertikal (dua arah).

• Nilai valid: [-100,100].

• Nilai default: 0.

eye_distance

FLOAT

Tingkat penyesuaian jarak mata (dua arah).

• Nilai valid: [-100,100].

• Nilai default: 0.

nose_thin

FLOAT

Tingkat penirusan hidung (dua arah).

• Nilai valid: [-100,100].

• Nilai default: 0.

nose_wing

FLOAT

Tingkat penirusan sayap hidung (dua arah).

• Nilai valid: [-100,100].

• Nilai default: 0.

nose_length

FLOAT

Tingkat penyesuaian panjang hidung (dua arah).

• Nilai valid: [-100,100].

• Nilai default: 0.

mouth_size

FLOAT

Tingkat penyesuaian ukuran mulut (dua arah).

• Nilai valid: [-100,100].

• Nilai default: 0.

mouth_position

FLOAT

Tingkat penyesuaian panjang philtrum (dua arah).

• Nilai valid: [-100,100].

• Nilai default: 0.

lip_thickness

FLOAT

Tingkat penyesuaian ketebalan bibir (dua arah).

• Nilai valid: [-100,100].

• Nilai default: 0.

hair_line

FLOAT

Tingkat penyesuaian garis rambut (dua arah).

• Nilai valid: [-100,100].

• Nilai default: 0.

smile

FLOAT

Tingkat penyesuaian senyum.

• Nilai valid: [0,100].

• Nilai default: 0.

detect_mode

FLOAT

Mode deteksi wajah.

• Nilai valid: [0,1].

• 0: mode video.

• 1: mode gambar.

• Nilai default: 1.

detect_level

FLOAT

Resolusi detektor wajah. Wajah yang lebih kecil mungkin tidak terdeteksi pada resolusi rendah.

• Nilai valid: [0,2].

• 0: resolusi terendah dengan kecepatan deteksi tercepat.

• 1: resolusi sedang dengan kecepatan deteksi sedang.

• 2: resolusi tertinggi dengan kecepatan deteksi paling lambat.

• Nilai default: 1.

threshold

FLOAT

Ambang batas kepercayaan deteksi wajah.

• Nilai valid: [0,1].

• Nilai default: 0.8.

detect_interval

FLOAT

Jumlah frame antara dua deteksi wajah berturut-turut dalam mode video.

• Nilai valid: [1,65535].

• Nilai default: 5.

max_face_num

FLOAT

Jumlah maksimum wajah yang dapat dideteksi.

• Nilai valid: [0,32].

• Nilai default: 32.

min_face

FLOAT

Lebar terkecil wajah.

• Nilai valid: [10,1024].

• Nilai default: 40.

Parameter

Tipe

Deskripsi

Result

STRING

Informasi rinci tentang hasil pekerjaan. Contoh informasi hasil sukses: {"Code":"Success","Data":"{\"result\":[{\"file\":\"result.mp4\"}]}","Message":"Successful."}.