Mengirimkan pekerjaan produksi cerdas.
Deskripsi operasi
Operasi ini merupakan operasi asinkron. Setelah pekerjaan dikirimkan, ID pekerjaan akan dikembalikan. Pekerjaan belum selesai dan akan dimasukkan ke dalam antrean untuk dieksekusi secara asinkron di latar belakang. Hasil akhir dikirimkan melalui notifikasi callback. Anda juga dapat memanggil Query an intelligent production job untuk mengkueri status pekerjaan.
Coba sekarang
Test
RAM authorization
|
Action |
Access level |
Resource type |
Condition key |
Dependent action |
|
ice:SubmitIProductionJob |
create |
*Semua Sumber daya.
|
None | None |
Parameter permintaan
|
Parameter |
Type |
Required |
Description |
Example |
| Name |
string |
No |
Nama pekerjaan. Nama dapat memiliki panjang hingga 100 karakter. |
Test job |
| FunctionName |
string |
Yes |
Nama fitur algoritma yang akan digunakan. Nilai valid:
|
Cover |
| Input |
object |
Yes |
Media input. Jalur OSS dan ID aset media didukung. Persyaratan file untuk media input bervariasi berdasarkan fitur algoritma. Untuk informasi lebih lanjut, lihat instruksi tambahan di bawah. |
|
| Type |
string |
Yes |
Tipe media. Nilai valid:
|
OSS |
| Media |
string |
Yes |
Media input. URL OSS dan ID aset media didukung. URL OSS harus dalam salah satu format berikut:
|
oss://bucket/object |
| Output |
object |
Yes |
Media output. Jalur OSS dan ID aset media didukung. File output bervariasi berdasarkan fitur algoritma. Untuk informasi lebih lanjut, lihat instruksi tambahan di bawah. |
|
| Type |
string |
Yes |
Tipe media. Nilai valid:
|
OSS |
| Biz |
string |
No |
Bisnis tempat aset media berada. Valid values:
|
IMS |
| Media |
string |
Yes |
Media output. Jika Type diatur ke OSS, masukkan URL OSS. Jika Type diatur ke Media, masukkan ID aset media. URL OSS harus dalam salah satu format berikut:
ID aset media:
Catatan
Jalur URL OSS mendukung placeholder. Contoh: oss://example-****/iproduction/{source}-{timestamp}-{sequenceId}.png. Placeholder berikut didukung:
|
oss://bucket/object |
| OutputUrl |
string |
No |
URL OSS dari file output saat Type diatur ke Media. Bucket harus terdaftar di IMS atau VOD. |
http(s)://bucket.oss-[RegionId].aliyuncs.com/object |
| TemplateId |
string |
No |
ID templat. |
****20b48fb04483915d4f2cd8ac**** |
| JobParams |
string |
No |
Parameter pekerjaan algoritma. Nilai berupa objek JSON. Parameter bervariasi berdasarkan algoritma. Untuk informasi lebih lanjut, lihat instruksi tambahan. |
{"Model":"gif"} |
| ScheduleConfig |
object |
No |
Konfigurasi penjadwalan pekerjaan. |
|
| PipelineId |
string |
No |
ID pipeline. |
5246b8d12a62433ab77845074039c3dc |
| Priority |
integer |
No |
Prioritas pekerjaan. Nilai valid: 1 hingga 10. Nilai yang lebih kecil menunjukkan prioritas yang lebih tinggi. |
6 |
| UserData |
string |
No |
Data pengguna kustom. Data dikembalikan apa adanya saat hasil diperoleh. Nilai dapat memiliki panjang hingga 256 karakter. |
{"test":1} |
| ModelId |
string |
No |
ID model algoritma. Jika parameter ini dibiarkan kosong, model default untuk fitur yang sesuai akan digunakan. Anda dapat membiarkan parameter ini kosong dan menggunakan model default dalam sebagian besar kasus. Fitur algoritma berikut mendukung model non-default:
|
Deskripsi bidang input dan output.
Cover
Mengambil file video sebagai input dan menghasilkan beberapa gambar (tiga secara default, yang harus dibedakan dengan placeholder) dalam format PNG atau GIF. Gambar statis atau animasi dihasilkan berdasarkan parameter di JobParams.
VideoDelogo
Mengambil file video sebagai input dan menghasilkan video dengan logo yang dihapus dalam format MP4.
VideoDetext
Mengambil file video sebagai input dan menghasilkan video dengan subtitle yang dihapus dalam format MP4.
CaptionExtraction
Mengambil file video sebagai input dan menghasilkan file subtitle dalam format SRT.
VideoGreenScreenMatting
Mengambil file video sebagai input dan menghasilkan video setelah matting gambar dalam format MP4 atau WebM, tergantung pada parameter JobParams.
FaceBeauty
Mengambil file video sebagai input dan menghasilkan video dengan wajah yang dipercantik dalam format MP4.
VideoH2V
Mengambil file video sebagai input dan menghasilkan video yang dikonversi dari lanskap ke potret dalam format MP4.
MusicSegmentDetect
Mengambil file audio sebagai input dan menghasilkan file hasil setelah deteksi chorus dalam format JSON.
AudioBeatDetection
Mengambil file audio sebagai input dan menghasilkan file hasil setelah deteksi beat dalam format JSON.
AudioQualityAssessment
Mengambil file audio sebagai input dan tidak menghasilkan file output. Hasil penilaian kualitas audio dikembalikan langsung dalam tanggapan QueryIProductionJob.
SpeechDenoise
Mengambil file audio sebagai input dan menghasilkan file audio dengan kebisingan yang dikurangi dalam format WAV.
AudioMixing
Mengambil file audio yang akan dicampur sebagai input dan menghasilkan audio yang telah dicampur dalam format WAV. Untuk informasi lebih lanjut tentang cara memasukkan file audio yang akan dicampur, lihat parameter JobParams di bawah.
MusicDemix
Mengambil file audio (lagu) sebagai input dan menghasilkan dua file audio setelah pemisahan vokal dan iringan. Anda harus menyertakan placeholder {resultType} di jalur output untuk mewakili audio vokal dan latar belakang masing-masing.
Deskripsi bidang JSON dari JobParams.
Cover
Model: model sampul cerdas. Nilai bertipe String. Jika parameter ini dibiarkan kosong, sampul gambar akan dihasilkan. Jika parameter ini diatur ke gif, sampul animasi akan dihasilkan.
VideoDelogo
LogoModel: tipe logo yang akan dihapus. Nilai bertipe String. Nilai valid: tv (logo umum - stasiun TV) dan internet (logo umum - media online). Anda dapat menentukan beberapa nilai yang dipisahkan oleh koma (,).
Boxes: posisi kotak logo target. Nilai bertipe String. Posisi direpresentasikan oleh jarak ternormalisasi dari sudut kiri atas sebagai titik asal, dalam format [xmin, ymin, width, height]. Hingga dua kotak logo target didukung. Contoh: "[[0, 0, 0.3, 0.3], [0.7, 0, 0.3, 0.3]]".
VideoDetext
LimitRegion: area deteksi subtitle. Nilai bertipe List. Area direpresentasikan oleh jarak ternormalisasi dari sudut kiri atas sebagai titik asal, dalam format [xmin, ymin, width, height]. Beberapa area deteksi didukung. Contoh: [[0, 0, 0.3, 0.3], [0.7, 0, 0.3, 0.3]]. Catatan: Jika parameter ini tidak ditentukan, area deteksi default adalah 30% bagian bawah video.
- Time: rentang waktu penghapusan subtitle global, dalam detik. Nilai bertipe List dan mencakup waktu mulai dan waktu akhir dalam format [start_time, end_time]. Contoh: [5, 20], yang menunjukkan bahwa hanya subtitle antara detik ke-5 dan ke-20 video yang dihapus.
Parameter Time dapat berupa array satu dimensi, seperti [5, 20], untuk menentukan satu periode waktu.
Parameter Time juga dapat berupa array dua dimensi, seperti [[5, 20], [25, 43], [51, 80]], untuk menentukan beberapa periode waktu. Ini hanya didukung saat modelId diatur ke algo-video-detext-new.
CaptionExtraction
fps: laju bingkai pengambilan sampel. Parameter ini bersifat opsional. Nilai berupa bilangan bulat. Nilai valid: [2, 10]. Nilai default: 5.
roi: area pemilihan subtitle. Hanya subtitle dalam area ini yang diekstrak. Formatnya adalah [[top, bottom], [left, right]], dan nilai dinormalisasi (misalnya, [[0.5, 1], [0, 1]] untuk bagian bawah). Jika parameter ini tidak ditentukan, 1/4 bagian bawah video dikenali secara default.
lang: bahasa pengenalan. Nilai valid: ch (Mandarin), en (Inggris), dan ch_ml (campuran Mandarin dan Inggris). Nilai default: ch.
track: Jika parameter ini diatur ke "main", hanya trek subtitle utama yang diekstrak. Jika parameter ini tidak ditentukan, semua subtitle yang muncul di area diekstrak secara default.
VideoGreenScreenMatting
bgimage: gambar latar belakang yang akan ditumpangkan setelah matting. Contoh: http://example-image-****.example-location.aliyuncs.com/example/example.jpg. Jika parameter ini tidak ditentukan, video WebM dengan saluran alpha akan dihasilkan.
FaceBeauty
beauty_params: parameter pemercantik 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
Persyaratan audio input: Format harus WAV, dan laju pengambilan sampel harus 16 kHz atau 48 kHz.
AudioMixing
inputs: daftar URL file trek audio yang akan dicampur. Saat ini, hanya satu URL yang didukung. Contoh: {"file":"http://example-bucket-****.oss-cn-shanghai.aliyuncs.com/2.mp4"}.
MusicDemix
Tidak ada.
Elemen respons
|
Element |
Type |
Description |
Example |
|
object |
Skema Respons. |
||
| RequestId |
string |
ID permintaan. |
C1849434-FC47-5DC1-92B6-F7EAAFE3851E |
| JobId |
string |
ID pekerjaan cerdas. |
****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.