Gunakan operasi SubmitIProductionJob untuk mengirimkan pekerjaan produksi cerdas.
Deskripsi operasi
Ini adalah API asinkron. Saat Anda mengirimkan tugas, API akan mengembalikan ID tugas dan mengantri tugas tersebut untuk diproses secara asinkron. Hasil akhir dikirimkan melalui callback. Anda juga dapat mengecek status tugas dengan memanggil QuerySmartProductionTask.
Coba sekarang
Test
RAM authorization
|
Action |
Access level |
Resource type |
Condition key |
Dependent action |
|
ice:SubmitIProductionJob |
create |
*全部资源
|
None | None |
Parameter permintaan
|
Parameter |
Type |
Required |
Description |
Example |
| Name |
string |
No |
Nama pekerjaan, yang panjangnya maksimal 100 karakter. |
测试任务 |
| FunctionName |
string |
Yes |
Nama fungsi algoritma. Nilai yang valid:
|
Cover |
| Input |
object |
Yes |
Aset media input. Anda dapat menentukan file OSS atau ID aset media. Persyaratan untuk file input bervariasi tergantung fungsi algoritma. Untuk informasi lebih lanjut, lihat petunjuk tambahan. |
|
| Type |
string |
Yes |
Jenis media input. Nilai yang valid:
|
OSS |
| Media |
string |
Yes |
URL OSS dari file input atau ID aset media input. URL OSS dapat dalam salah satu format berikut:
|
oss://bucket/object |
| Output |
object |
Yes |
Tujuan output. Anda dapat menentukan jalur file OSS atau ID aset media. File output bervariasi tergantung fungsi algoritma. Untuk informasi lebih lanjut, lihat petunjuk tambahan. |
|
| Type |
string |
Yes |
Jenis media output. Nilai yang valid:
|
OSS |
| Biz |
string |
No |
Layanan tempat aset media tersebut berada. |
IMS |
| Media |
string |
Yes |
Tujuan output. Jika URL OSS dapat dalam salah satu format berikut:
ID aset media:
Catatan
Jalur file OSS mendukung placeholder. Contoh:
|
oss://bucket/object |
| OutputUrl |
string |
No |
Jika |
http(s)://bucket.oss-[RegionId].aliyuncs.com/object |
| TemplateId |
string |
No |
ID templat. |
****20b48fb04483915d4f2cd8ac**** |
| JobParams |
string |
No |
Parameter pekerjaan algoritma, ditentukan sebagai string berformat JSON. Konten objek JSON bervariasi tergantung fungsi algoritma. Untuk informasi lebih lanjut, lihat petunjuk tambahan. |
{"Model":"gif"} |
| ScheduleConfig |
object |
No |
Konfigurasi penjadwalan pekerjaan. |
|
| PipelineId |
string |
No |
ID pipeline. |
5246b8d12a62433ab77845074039c3dc |
| Priority |
integer |
No |
Prioritas pekerjaan, yang dapat berupa bilangan bulat dari 1 hingga 10. Nilai yang lebih kecil menunjukkan prioritas yang lebih tinggi. |
6 |
| UserData |
string |
No |
Data pengguna kustom. Sistem meneruskan data ini dan mengembalikannya apa adanya dalam callback atau respons. Panjangnya tidak boleh melebihi 256 karakter. |
{"test":1} |
| ModelId |
string |
No |
ID model algoritma. Jika Anda tidak menentukan parameter ini, sistem akan menggunakan model default untuk fungsi yang dipilih. Kami merekomendasikan untuk membiarkan parameter ini kosong kecuali Anda perlu menggunakan model alternatif tertentu. Fungsi berikut menawarkan model alternatif:
|
Bidang input dan output
Cover
Menerima file video sebagai input dan menghasilkan beberapa gambar (tiga secara default). Anda harus menggunakan placeholder untuk membedakan file output. Format output berupa PNG untuk gambar statis atau GIF untuk gambar animasi, tergantung pada parameter yang ditentukan dalam JobParams.
VideoDelogo
Menghapus logo dari file video dan menghasilkan video MP4.
VideoDetext
Menghapus subtitle dari file video dan menghasilkan video MP4.
CaptionExtraction
Mengekstraksi subtitle dari file video dan menghasilkannya sebagai file SRT.
VideoGreenScreenMatting
Menerima file video sebagai input dan menghasilkan video dengan latar belakang layar hijau yang dihapus. Format output berupa MP4 atau WebM, tergantung pada parameter dalam JobParams.
FaceBeauty
Menerima file video sebagai input dan menghasilkan video dalam format MP4 dengan efek kecantikan wajah.
VideoH2V
Menerima file video sebagai input dan menghasilkan video MP4 vertikal yang dikonversi dari sumber horizontal.
MusicSegmentDetect
Menerima file audio sebagai input dan menghasilkan file JSON yang berisi hasil deteksi chorus.
AudioBeatDetection
Menerima file audio sebagai input dan menghasilkan file JSON yang berisi hasil deteksi ketukan.
AudioQualityAssessment
Menerima file audio sebagai input. Tidak ada file output yang dihasilkan. Hasil penilaian kualitas audio dikembalikan langsung dalam respons QueryIProductionJob.
SpeechDenoise
Mengurangi kebisingan dalam file audio dan menghasilkan output dalam format file WAV.
AudioMixing
Mencampur file audio input dengan trek tambahan yang ditentukan dalam JobParams dan menghasilkan output dalam format WAV.
MusicDemix
Memisahkan file audio (lagu) menjadi dua file audio terpisah: satu untuk vokal dan satu untuk iringan. Jalur Output harus menyertakan placeholder {resultType} untuk membedakan kedua file tersebut.
Bidang JSON JobParams
Cover
Model: String. Menentukan model Smart Cover. Jika dibiarkan kosong, gambar statis akan dihasilkan. Jika diatur kegif, gambar animasi akan dihasilkan.
VideoDelogo
LogoModel: String. Menentukan jenis logo yang akan dihapus. Nilai yang valid:tv(logo siaran televisi) daninternet(logo media online). Anda dapat menentukan beberapa nilai, dipisahkan dengan koma.Boxes: String. Koordinat kotak pembatas untuk logo target. Koordinat ditentukan sebagai jarak ternormalisasi dari pojok kiri atas dalam format[xmin, ymin, width, height]. Maksimal dua kotak pembatas didukung. Contoh:"[[0, 0, 0.3, 0.3], [0.7, 0, 0.3, 0.3]]".
VideoDetext
LimitRegion: Daftar. Menentukan wilayah untuk deteksi subtitle. Koordinat ditentukan sebagai jarak ternormalisasi dari pojok kiri atas dalam format[xmin, ymin, width, height]. Beberapa wilayah didukung. Contoh:[[0, 0, 0.3, 0.3], [0.7, 0, 0.3, 0.3]]. Catatan: Jika parameter ini dihilangkan, layanan secara default akan memindai 30% bagian bawah video.Time: Daftar. Menentukan rentang waktu untuk penghapusan subtitle dalam satuan detik, dalam format[start_time, end_time]. Misalnya,[5, 20]menunjukkan bahwa subtitle hanya dihapus antara detik ke-5 hingga ke-20 dalam video.Array satu dimensi, seperti
[5, 20], untuk menentukan satu rentang waktu.Array dua dimensi, seperti
[[5, 20], [25, 43], [51, 80]], untuk menentukan beberapa rentang waktu. Format ini hanya didukung saatmodelIdbernilaialgo-video-detext-new.
CaptionExtraction
fps: Integer. (Opsional) Laju frame pengambilan sampel. Rentang valid:[2, 10]. Default:5.roi: Wilayah minat (ROI) untuk ekstraksi subtitle. Hanya subtitle dalam wilayah ini yang diekstraksi. Formatnya adalah[[top, bottom], [left, right]], menggunakan nilai ternormalisasi. Misalnya,[[0.5, 1], [0, 1]]menentukan separuh bagian bawah video. Jika parameter ini dihilangkan, layanan secara default akan mengekstraksi subtitle dari seperempat bagian bawah video.lang: String. Bahasa untuk pengenalan. Nilai yang valid:ch(Tiongkok),en(Inggris), danch_ml(campuran Tiongkok dan Inggris). Default:ch.track: String. Jika diatur kemain, hanya trek subtitle utama yang diekstraksi. Jika parameter ini dihilangkan, semua subtitle dalam wilayah yang ditentukan akan diekstraksi secara default.
VideoGreenScreenMatting
bgimage: String. URL gambar latar belakang yang akan ditumpangkan pada video setelah matting. Contoh:http://example-image-****.example-location.aliyuncs.com/example/example.jpg. Jika parameter ini dihilangkan, layanan akan menghasilkan video WebM dengan saluran alfa.
FaceBeauty
beauty_params: String. Parameter untuk fitur kecantikan wajah. Contoh:"whiten=20,smooth=50,face_thin=50". Untuk informasi lebih lanjut, lihat Deskripsi Bidang Parameter.
VideoH2V
Tidak ada
MusicSegmentDetect
Tidak ada
AudioBeatDetection
Tidak ada
AudioQualityAssessment
Tidak ada
SpeechDenoise
File audio input harus dalam format WAV dengan laju pengambilan sampel 16 kHz atau 48 kHz.
AudioMixing
inputs: Daftar yang berisi trek audio yang akan dicampur. Catatan: Saat ini, hanya satu file yang didukung. Contoh:{"file":"http://example-bucket-****.oss-cn-shanghai.aliyuncs.com/2.mp4"}
MusicDemix
Tidak ada
Elemen respons
|
Element |
Type |
Description |
Example |
|
object |
Data yang dikembalikan. |
||
| RequestId |
string |
ID permintaan. |
C1849434-FC47-5DC1-92B6-F7EAAFE3851E |
| JobId |
string |
ID pekerjaan. |
****20b48fb04483915d4f2cd8ac**** |
Contoh
Respons sukses
JSONformat
{
"RequestId": "C1849434-FC47-5DC1-92B6-F7EAAFE3851E",
"JobId": "****20b48fb04483915d4f2cd8ac****"
}
Kode kesalahan
Lihat Error Codes untuk daftar lengkap.
Catatan rilis
Lihat Release Notes untuk daftar lengkap.