All Products
Search
Document Center

Intelligent Media Services:QueryIProductionJob

Last Updated:Mar 21, 2026

Panggil QueryIProductionJob untuk mengambil status dan hasil pekerjaan produksi cerdas.

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

get

*全部资源

*

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

ClientToken

string

No

Token yang Anda berikan untuk memastikan idempotensi permintaan.

JobId

string

Yes

ID dari pekerjaan produksi cerdas.

****20b48fb04483915d4f2cd8ac****

Elemen respons

Element

Type

Description

Example

object

Objek respons.

RequestId

string

ID dari permintaan.

JobId

string

ID pekerjaan.

****20b48fb04483915d4f2cd8ac****

Name

string

Nama pekerjaan.

测试任务

FunctionName

string

Nama fitur AI. Nilai yang valid:

  • Cover: gambar mini pintar

  • VideoClip: ringkasan video

  • VideoDelogo: penghapusan logo

  • VideoDetext: penghapusan teks

  • CaptionExtraction: ekstraksi subtitle

  • VideoGreenScreenMatting: keying layar hijau

  • FaceBeauty: kecantikan wajah

  • VideoH2V: konversi video horizontal ke vertikal

  • MusicSegmentDetect: deteksi chorus

  • AudioBeatDetection: deteksi ketukan

  • AudioQualityAssessment: penilaian kualitas audio

  • SpeechDenoise: penghilangan derau suara

  • AudioMixing: pencampuran audio

  • MusicDemix: pemisahan sumber musik

Cover

Input

object

Objek media input.

Type

string

Jenis media input. Nilai yang valid:

  1. OSS: file Object Storage Service (OSS).

  2. Media: ID aset media.

OSS

Media

string

Sumber media input. Jika nilai Type adalah OSS, atur parameter ini ke URL OSS. Jika nilai Type adalah Media, atur parameter ini ke ID aset media. URL OSS harus dalam salah satu format berikut:

  1. oss://bucket/object

  2. http(s)://bucket.oss-[RegionId].aliyuncs.com/object Pada format di atas, bucket menunjukkan nama bucket OSS yang berada di wilayah yang sama dengan proyek, dan object menunjukkan path file.

oss://bucket/object

Output

object

Objek media output.

Type

string

Jenis media output. Nilai yang valid:

  • OSS: path OSS.

  • Media: ID aset media.

OSS

Biz

string

Bisnis dari aset media.

Valid values:

  • VOD :

    ApsaraVideo VOD

  • IMS :

    Intelligent Media Services (IMS)

IMS

Media

string

Tujuan media output. Jika nilai Type adalah OSS, parameter ini berupa URL OSS. Jika nilai Type adalah Media, parameter ini berupa ID aset media yang ditentukan atau baru.

URL OSS harus dalam salah satu format berikut:

  1. oss://bucket/object

  2. http(s)://bucket.oss-[RegionId].aliyuncs.com/object Pada format di atas, bucket menunjukkan nama bucket OSS yang berada di wilayah yang sama dengan proyek, dan object menunjukkan path file.

oss://bucket/object

OutputUrl

string

Jika nilai Type adalah Media, parameter ini adalah URL OSS dari file output yang ditentukan.

http(s)://bucket.oss-[RegionId].aliyuncs.com/object

TemplateId

string

ID templat.

****96e8864746a0b6f3****

JobParams

string

Parameter pekerjaan AI. Nilainya berupa objek JSON. Konten objek JSON bervariasi tergantung pada fitur AI.

{"Model":"gif"}

ScheduleConfig

object

Konfigurasi pekerjaan.

PipelineId

string

ID pipeline.

a54fdc9c9aab413caef0d1150f565e86

Priority

integer

Prioritas pekerjaan dalam pipeline-nya.

  • Nilai yang lebih besar menunjukkan prioritas yang lebih tinggi. Nilai maksimum: 10.

  • Nilai default: 6.

6

UserData

string

Data yang ditentukan pengguna, yang dikembalikan dalam respons.

{"test":1}

Result

string

Hasil pekerjaan AI. Hasilnya dalam format JSON. Konten objek JSON bervariasi tergantung pada parameter FunctionName. Untuk informasi selengkapnya, lihat bagian "Informasi tambahan" pada topik ini.

{}

CreateTime

string

Waktu saat pekerjaan dibuat. Waktu dalam UTC.

2022-07-07T07:16:11Z

FinishTime

string

Waktu saat pekerjaan selesai. Waktu dalam UTC.

2021-11-26T14:50:25Z

Status

string

Status pekerjaan. Nilai yang valid:

  • Queuing: Pekerjaan sedang dalam antrean.

  • Analysing: Pekerjaan sedang dianalisis.

  • Fail: Pekerjaan gagal.

  • Success: Pekerjaan berhasil.

Success

OutputFiles

array

Array file output.

string

Path dan nama file yang dihasilkan.

output/xxx.mp4

OutputMediaIds

array

Array ID aset media dari file output.

string

ID aset media dari file output.

OutputUrls

array

Array URL file output.

string

URL yang dapat digunakan untuk mengakses file yang dihasilkan.

http://xxx

Contoh hasil

Cover

Contoh: [{"Score":8.270855992569906,"Time":"28278.25","Url":"cover/test-00001.jpg"},{"Score":7.474117489692728,"Time":"25942.583333333332","Url":"cover/test-00002.jpg"}]

Score adalah tingkat kepercayaan gambar sampul, Time adalah timestamp frame gambar sampul, dan Url adalah path file gambar.

VideoClip

Contoh: {"VideoSummaryList":[{"EndTime":"5.28","StartTime":"0.28"}]}

VideoSummaryList adalah array segmen waktu dari video asli, dalam satuan detik.

VideoDelogo

Contoh: {}

Mengembalikan objek kosong jika berhasil.

VideoDetext

Contoh: {}

Mengembalikan objek kosong jika berhasil.

CaptionExtraction

Contoh: {}

Mengembalikan objek kosong jika berhasil.

VideoGreenScreenMatting

Contoh: {}

Mengembalikan objek kosong jika berhasil.

FaceBeauty

Contoh: {}

Mengembalikan objek kosong jika berhasil.

VideoH2V

Contoh: {}

Mengembalikan objek kosong jika berhasil.

MusicSegmentDetect

Contoh: [{"start":39.32,"end":63.85,"title":"Chorus"},{"start":86.69,"end":114.45,"title":"Chorus"},{"start":135.75,"end":160.27,"title":"Chorus"}]

AudioBeatDetection

Contoh: {}

Mengembalikan objek kosong jika berhasil.

AudioQualityAssessment

Contoh: [{ "Discontinuity":"Good", "Loudness":"Excellent", "Worst MOS(0-5)":"0.38", "Discontinuity(0-5)":"3.52", "Speech Ratio":"48.55", "Loudness(0-5)":"4.91", "Worst Discontinuity(0-5)":"0.88", "Worst Coloration(0-5)":"0.42", "Channel":"1", "Coloration(0-5)":"0.99", "Bad Mute Ratio(%)":"0.0", "Time":"2022-12-02 16:14:06", "Noisiness(0-5)":"3.28", "MOS":"Poor", "Worst Noisiness(0-5)":"0.91", "Double Talk Ratio(%)":"19.23", "Input":"/home/admin/algo/quality****/example.wav", "Total Duration":"42.78", "Noisiness":"Good", "Tag":"Valid", "MOS(0-5)":"1.01", "Loudness(-90dB-0dB)":"-0.59", "Coloration":"Bad", "Saturated Ratio(%)":"37.55" }, { "Discontinuity":"Fair", "Loudness":"Excellent", "Worst MOS(0-5)":"0.65", "Discontinuity(0-5)":"2.45", "Speech Ratio":"41.68", "Loudness(0-5)":"4.52", "Worst Discontinuity(0-5)":"0.66", "Worst Coloration(0-5)":"0.72", "Channel":"2", "Coloration(0-5)":"2.34", "Bad Mute Ratio(%)":"0.0", "Time":"2022-12-02 16:14:06", "Noisiness(0-5)":"2.53", "MOS":"Poor", "Worst Noisiness(0-5)":"0.67", "Double Talk Ratio(%)":"25.93", "Input":"/home/admin/algo/quality****/example.wav", "Total Duration":"42.78", "Noisiness":"Fair", "Tag":"Valid", "MOS(0-5)":"1.69", "Loudness(-90dB-0dB)":"-4.82", "Coloration":"Fair", "Saturated Ratio(%)":"0.0" }]

Deskripsi parameter

SpeechDenoise

Contoh: {}

Mengembalikan objek kosong jika berhasil.

AudioMixing

Contoh: {}

Mengembalikan objek kosong jika berhasil.

MusicDemix

Contoh: {}

Mengembalikan objek kosong jika berhasil.

Contoh

Respons sukses

JSONformat

{
  "RequestId": "",
  "JobId": "****20b48fb04483915d4f2cd8ac****",
  "Name": "测试任务",
  "FunctionName": "Cover",
  "Input": {
    "Type": "OSS",
    "Media": "oss://bucket/object"
  },
  "Output": {
    "Type": "OSS",
    "Biz": "IMS",
    "Media": "oss://bucket/object",
    "OutputUrl": "http(s)://bucket.oss-[RegionId].aliyuncs.com/object "
  },
  "TemplateId": "****96e8864746a0b6f3****",
  "JobParams": "{\"Model\":\"gif\"}",
  "ScheduleConfig": {
    "PipelineId": "a54fdc9c9aab413caef0d1150f565e86",
    "Priority": 6
  },
  "UserData": "{\"test\":1}",
  "Result": "{}",
  "CreateTime": "2022-07-07T07:16:11Z",
  "FinishTime": "2021-11-26T14:50:25Z",
  "Status": "Success",
  "OutputFiles": [
    "output/xxx.mp4"
  ],
  "OutputMediaIds": [
    ""
  ],
  "OutputUrls": [
    "http://xxx"
  ]
}

Kode kesalahan

HTTP status code

Error code

Error message

Description

400 IdempotentParameterMismatch The request uses the same client token as a previous, but non-identical request. Do not reuse a client token with different requests, unless the requests are identical.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.