All Products
Search

This Product

    Intelligent Media Services:QueryVideoCognitionJob

    Document Center

    Intelligent Media Services:QueryVideoCognitionJob

    Last Updated:Jun 12, 2026

    Mengkueri hasil tugas node pemahaman video.

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

    get

    *全部资源

    *

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    JobId

    string

    Yes

    ID Pekerjaan smart tagging yang akan dikueri. Anda dapat memperoleh ID ini dari tanggapan SubmitSmarttagJob.

    ****20b48fb04483915d4f2cd8ac****
    Params

    string

    No

    Parameter permintaan tambahan, direpresentasikan sebagai string JSON.

    {}
    IncludeResults

    object

    No

    Apakah akan menyertakan hasil algoritma lengkap dalam tanggapan kueri.

    NeedAsr

    boolean

    No

    Apakah akan mengembalikan hasil ASR.

    true
    NeedOcr

    boolean

    No

    Apakah akan mengembalikan hasil OCR.

    true
    NeedProcess

    boolean

    No

    Apakah akan mengembalikan tautan ke hasil operator mentah.

    true

    Elemen respons

    Element

    Type

    Description

    Example

    object

    JobStatus

    string

    Status pekerjaan. Nilai valid:

    • Success: Pekerjaan telah diproses.

    • Fail: Pekerjaan gagal.

    • Processing: Pekerjaan sedang diproses.

    • Submitted: Pekerjaan telah dikirim dan menunggu untuk diproses.

    Success
    RequestId

    string

    ID permintaan.

    ******11-DB8D-4A9A-875B-275798******

    UserData

    string

    Data pengguna kustom.

    {"userId":"123432412831"}

    Results

    object

    result

    array<object>

    Array objek hasil analisis.

    object

    Type

    string

    The type of analysis result. Valid values:

    1. TextLabel: Tags from text content.

    2. VideoLabel: Tags from video content.

    3. ASR: Raw speech recognition results. Not returned by default.

    4. OCR: Raw text recognition results. Not returned by default.

    5. NLP: Natural Language Processing results. Not returned by default.

    6. Process: URL to the raw algorithm output. Not returned by default.

    ASR
    Data

    string

    A JSON string containing the detailed analysis data. The structure of this data depends on the Type field. For details, see the Result parameters section below.

    {"title":"example-title-****"}

    TemplateId

    string

    Params

    string

    Input

    object

    Type

    string

    Media

    string

    Deskripsi parameter Result.

    Struktur data VideoLabel

    NamaTipeDeskripsi
    personsJSONArrayHasil deteksi orang
    persons.nameStringNama orang yang dikenali
    persons.categoryStringTipe orang. Nilai valid: celebrity; politician; sensitive; unknown; ID pustaka orang kustom (dikembalikan ketika orang yang dikenali berasal dari pustaka orang kustom)
    persons.ratiodoubleRasio kemunculan orang. Rentang nilai: 0 hingga 1
    persons.occurrencesJSONArrayInformasi detail mengenai kemunculan orang
    persons.occurrences.scoredoubleSkor kepercayaan
    persons.occurrences.fromdoubleWaktu mulai saat orang terdeteksi, dalam detik
    persons.occurrences.todoubleWaktu akhir saat orang terdeteksi, dalam detik
    persons.occurrences.positionJSONObjectKoordinat wajah
    persons.occurrences.position.leftTopint[]Koordinat X dan Y dari sudut kiri atas
    persons.occurrences.position.rightBottomint[]Koordinat X dan Y dari sudut kanan bawah
    persons.occurrences.timestampdoubleTimestamp koordinat wajah, dalam detik
    persons.occurrences.sceneStringTipe bidikan orang. Nilai valid: closeUp (close-up); medium-closeUp (medium close-up); medium (medium shot); medium-long (full shot)
    tagsJSONArrayTag yang terdeteksi seperti objek dan adegan. Untuk informasi lebih lanjut, lihat tabel contoh di bawah
    tags.mainTagNameStringTag utama
    tags.subTagNameStringSub-tag
    tags.ratiodoubleRasio kemunculan. Rentang nilai: 0 hingga 1
    tags.occurrencesJSONArrayInformasi kemunculan detail
    tags.occurrences.scoredoubleSkor kepercayaan
    tags.occurrences.fromdoubleWaktu mulai, dalam detik
    tags.occurrences.todoubleWaktu akhir, dalam detik
    classificationsJSONArrayInformasi klasifikasi video
    classifications.scoredoubleSkor kepercayaan
    classifications.category1StringKategori level-1, seperti gaya hidup, animasi, atau otomotif
    classifications.category2StringKategori level-2, seperti kesehatan atau rumah di bawah kategori gaya hidup

    Contoh tag video

    mainTagNamesubTagName
    ProgramContoh: Where Are We Going, Dad?, Comedy King
    Peran karakterContoh: dokter, perawat, guru
    ObjekContoh: piano, cangkir, meja, tumis tomat dan telur, mobil, kosmetik
    LogoContoh: CCTV1, CCTV2, Youku, Dragon TV
    Aksi/AcaraContoh: menari, berciuman, berpelukan, bertemu, bernyanyi, menelepon, menunggang kuda, berkelahi
    WilayahContoh: Lapangan Tiananmen di Beijing, Patung Liberty, Buddha Leshan, Tiongkok, Amerika Serikat
    AdeganContoh: kamar tidur, stasiun kereta bawah tanah, sawah terasering, pantai, gurun

    Struktur data ImageLabel

    NamaTipeDeskripsi
    personsJSONArrayHasil deteksi orang
    persons.nameStringNama orang yang dikenali
    persons.categoryStringTipe orang. Nilai valid: celebrity; politician; sensitive
    persons.scoredoubleSkor kepercayaan orang
    persons.positionJSONObjectKoordinat wajah
    persons.position.leftTopint[]Koordinat X dan Y dari sudut kiri atas
    persons.position.rightBottomint[]Koordinat X dan Y dari sudut kanan bawah
    persons.sceneStringTipe bidikan orang. Nilai valid: closeUp (close-up); medium-closeUp (medium close-up); medium (medium shot); medium-long (full shot)
    tagsJSONArrayTag yang terdeteksi seperti objek dan adegan. Untuk informasi lebih lanjut, lihat tabel contoh di bawah
    tags.mainTagNameStringTag utama
    tags.subTagNameStringSub-tag
    tags.scoredoubleSkor kepercayaan

    Contoh tag gambar

    mainTagNamesubTagName
    Peran karakterContoh: dokter, perawat, guru
    WilayahContoh: Lapangan Tiananmen di Beijing, Patung Liberty, Buddha Leshan, Tiongkok, Amerika Serikat
    Aksi/AcaraContoh: berbicara
    LogoContoh: CCTV1, CCTV2, Youku, Dragon TV
    Aksi/AcaraContoh: menari, berciuman, berpelukan, bertemu, bernyanyi, menelepon, menunggang kuda, berkelahi
    ObjekContoh: piano, cangkir, meja, tumis tomat dan telur, mobil, kosmetik
    AdeganContoh: kamar tidur, stasiun kereta bawah tanah, sawah terasering, pantai, gurun

    Struktur data TextLabel (berasal dari ASR dan OCR)

    NamaTipeDeskripsi
    tagsJSONArrayInformasi tag teks. Untuk informasi lebih lanjut, lihat tabel contoh di bawah
    tags.nameStringKategori tag
    tags.valueStringNilai tag. Dapat terdapat beberapa nilai tag, dipisahkan oleh koma (,)

    Contoh tag teks

    namevalue
    WilayahContoh: Lapangan Tiananmen di Beijing, Patung Liberty, Buddha Leshan, Tiongkok, Amerika Serikat
    OrganisasiContoh: Asosiasi Konservasi Satwa Liar Tiongkok, Grup Media Tiongkok
    LogoContoh: Nike, Li-Ning
    Kata KunciContoh: kekuatan tulang punggung

    Struktur data CPVLabel

    • cates: kategori (kategori level-1, kategori level-2, kategori level-3)

    • entities: atribut kategori (dengan informasi knowledge graph)

    • hotwords: kata populer (daftar tontonan yang diikuti pengguna)

    • freeTags: tag bebas (kata kunci).

    NamaTipeContohDeskripsi
    typeStringhmiTipe hasil. Nilai valid: hmi (hasil kolaborasi manusia-mesin), autp (hasil penandaan mesin)
    catesJSONArray-Hasil kategori klasifikasi
    cates.labelLevel1String旅游Label level-1
    cates.labelLevel2String旅游风光Label level-2
    cates.labelString""Nama label. Algoritma dapat mengembalikan nilai kosong
    cates.appearanceProbabilitydouble0.96Rasio kemunculan
    cates.detailInfoJSONArray--
    cates.detailInfo.scoredouble0.9Skor kepercayaan
    cates.detailInfo.startTimedouble0.021Waktu mulai
    cates.detailInfo.endTimedouble29.021Waktu akhir
    entitiesJSONArray--
    entities.labelLevel1String地域Label level-1
    entities.labelLevel2String地标Label level-2
    entities.labelString黄果树瀑布Nama label
    entities.appearanceProbabilitydouble0.067Rasio kemunculan
    entities.knowledgeInfoString{"name": "黄果树瀑布", "nameEn": "Huangguoshu Waterfall", "description": "亚洲四大瀑布之一"}Informasi knowledge graph. Untuk semua bidang, lihat tabel terlampir: Film/TV/Variety Show IP Graph, Music Graph, Person Graph, Landmark Graph, dan Object Graph.
    entities.detailInfoJSONArray--
    entities.detailInfo.scoredouble0.33292606472969055Skor kepercayaan
    entities.detailInfo.startTimedouble6.021Waktu mulai
    entities.detailInfo.endTimedouble8.021Waktu akhir
    entities.detailInfo.trackDataJSONArray-Informasi terstruktur dari label entitas
    entities.detailInfo.trackData.scoredouble0.32Skor kepercayaan
    entities.detailInfo.trackData.bboxinteger[]23，43，45，67Koordinat bounding box
    entities.detailInfo.trackData.timestampdouble7.9Timestamp
    hotwordsJSONArray--
    hotwords.labelLevel1String关键词Label level-1
    hotwords.labelLevel1String关键词Label level-2
    hotwords.labelLevel2String""Label level-2
    hotwords.labelString中国气象局Konten kata populer
    hotwords.appearanceProbabilitydouble0.96Rasio kemunculan
    hotwords.detailInfoJSONArray
    hotwords.detailInfo.scoredouble1.0Skor kepercayaan
    hotwords.detailInfo.startTimedouble0.021Waktu mulai
    hotwords.detailInfo.endTimedouble29.021Waktu akhir
    freeTagsJSONArray
    freeTags.labelLevel1String关键词Label level-1
    freeTags.labelLevel2String""Label level-2
    freeTags.labelString中央气象台Konten tag bebas
    freeTags.appearanceProbabilitydouble0.96Rasio kemunculan
    freeTags.detailInfoJSONArray
    freeTags.detailInfo.scoredouble0.9Skor kepercayaan
    freeTags.detailInfo.startTimedouble0.021Waktu mulai
    freeTags.detailInfo.endTimedouble29.021Waktu akhir

    Hasil pengenalan ucapan (ASR)

    NamaTipeDeskripsi
    detailsJSONArrayHasil tugas detail
    details.fromdoubleTimestamp mulai, dalam detik
    details.todoubleTimestamp akhir, dalam detik
    details.contentStringKonten teks yang dikenali

    Hasil pengenalan karakter optik (OCR)

    NamaTipeDeskripsi
    detailsJSONArrayHasil tugas detail
    details.timestampdoubleTimestamp, dalam detik
    details.infoJSONArrayInformasi spesifik yang dikenali pada titik waktu ini
    details.info.scoredoubleSkor kepercayaan
    details.info.positionJSONObjectKoordinat teks
    details.info.position.leftTopint[]Koordinat X dan Y dari sudut kiri atas
    details.info.position.rightBottomint[]Koordinat X dan Y dari sudut kanan bawah
    details.info.contentStringKonten teks yang dikenali

    Hasil anotasi meta

    Catatan

    Jika Anda tidak menggunakan anotasi manusia-mesin dan menentukan needMetaData saat mengirimkan tugas dengan memanggil SubmitSmarttagJob , QuerySmarttagJob mengembalikan judul asli yang diberikan oleh pengguna.

    NamaTipeDeskripsi
    titleStringJudul

    Hasil ekstraksi subtitle (Subtitle)

    NamaTipeDeskripsi
    detailsJSONArrayHasil tugas detail
    details.allResultUrlStringURL untuk semua hasil subtitle. URL berlaku selama enam bulan setelah tugas selesai
    details.chResultUrlStringURL untuk hasil subtitle bahasa Tionghoa. URL berlaku selama enam bulan setelah tugas selesai
    details.engResultUrlStringURL untuk hasil subtitle bahasa Inggris. URL berlaku selama enam bulan setelah tugas selesai
    Catatan

    Konten URL hasil subtitle: nomor urut + rentang waktu + konten subtitle (setiap baris subtitle berada pada baris terpisah).

    Hasil pemrosesan NLP

    ParameterTipeDeskripsi
    transcriptionobjectHasil transkripsi ucapan
    autoChaptersobjectHasil ikhtisar bab
    summarizationobjectHasil ringkasan model besar
    meetingAssistanceobjectHasil notulen rapat cerdas
    translationobjectHasil terjemahan teks

    transcription (transkripsi ucapan)

    ParameterTipeDeskripsi
    transcriptionobjectObjek hasil transkripsi ucapan.
    transcription.paragraphslist[]Kumpulan hasil transkripsi ucapan yang diorganisir berdasarkan paragraf.
    transcription.paragraphs[i].paragraphIdstringID tingkat paragraf.
    transcription.paragraphs[i].speakerIdstringID pembicara.
    transcription.paragraphs[i].wordslist[]Informasi kata yang terkandung dalam paragraf ini.
    transcription.paragraphs[i].words[i].idintNomor urut kata. Anda biasanya dapat mengabaikan bidang ini.
    transcription.paragraphs[i].words[i].sentenceIdintID kalimat. Kata dengan sentenceId yang sama dapat dirangkai menjadi satu kalimat.
    transcription.paragraphs[i].words[i].startlongWaktu mulai kata ini relatif terhadap waktu mulai audio. Ini adalah timestamp relatif dalam milidetik.
    transcription.paragraphs[i].words[i].endlongWaktu akhir kata ini relatif terhadap waktu mulai audio. Ini adalah timestamp relatif dalam milidetik.
    transcription.paragraphs[i].words[i].textstringTeks kata.

    summarization (ringkasan teks lengkap, ringkasan pembicara, ringkasan Tanya Jawab)

    ParameterTipeDeskripsi
    summarizationobjectObjek hasil ringkasan. Dapat berisi nol atau lebih hasil dari berbagai tipe ringkasan.
    summarization.paragraphSummarystringHasil ringkasan teks lengkap.
    summarization.conversationalSummarylist[]Daftar hasil ringkasan pembicara.
    summarization.conversationalSummary[i].speakerIdstringID pembicara.
    summarization.conversationalSummary[i].speakerNamestringNama pembicara.
    summarization.conversationalSummary[i].summarystringRingkasan untuk pembicara ini.
    summarization.questionsAnsweringSummarylist[]Daftar hasil ringkasan Tanya Jawab.
    summarization.questionsAnsweringSummary[i].questionstringPertanyaan.
    summarization.questionsAnsweringSummary[i].sentenceIdsOfQuestionlist[]Daftar ID kalimat dari transkripsi ucapan asli yang sesuai dengan pertanyaan ini.
    summarization.questionsAnsweringSummary[i].answerstringJawaban atas pertanyaan.
    summarization.questionsAnsweringSummary[i].sentenceIdsOfAnswerlist[]Daftar ID kalimat dari transkripsi ucapan asli yang sesuai dengan jawaban ini.
    summarization.mindMapSummarylist[object]Daftar hasil ringkasan peta pikiran. Dapat berisi ringkasan untuk setiap topik dan hubungan antar topik.
    summarization.mindMapSummary[i].titlestringJudul topik.
    summarization.mindMapSummary[i].topiclist[object]Array yang berisi setiap topik dan subtopiknya.
    summarization.mindMapSummary[i].topic[i].titlestringJudul topik.
    summarization.mindMapSummary[i].topic[i].topiclist[object]Array subtopik untuk topik ini. Dapat berupa array kosong.

    translation (terjemahan teks lengkap)

    ParameterTipeDeskripsi
    translationobjectObjek hasil terjemahan.
    translation.paragraphslist[]Kumpulan hasil terjemahan yang diorganisir berdasarkan paragraf, sesuai dengan hasil pengenalan ucapan.
    translation.paragraphs.paragraphIdstringID segmen paragraf, sesuai dengan ParagraphId dalam hasil pengenalan ucapan.
    translation.paragraphs.sentenceslist[]Kumpulan teks terjemahan.
    translation.paragraphs.sentences[i].sentenctIdlongID kalimat.
    translation.paragraphs.sentences[i].startlongWaktu mulai segmen ini relatif terhadap waktu mulai audio. Ini adalah timestamp relatif dalam milidetik.
    translation.paragraphs.sentences[i].endlongWaktu akhir segmen ini relatif terhadap waktu mulai audio. Ini adalah timestamp relatif dalam milidetik.
    translation.paragraphs.sentences[i].textstringTeks terjemahan, sesuai dengan hasil pengenalan ucapan.

    autoChapters (pengenalan bab)

    ParameterTipeDeskripsi
    autoChapterslist[]Kumpulan ikhtisar bab, berisi nol, satu, atau lebih entri ikhtisar bab.
    autoChapters[i].idintNomor urut bab.
    autoChapters[i].startlongWaktu mulai bab ini relatif terhadap waktu mulai audio. Ini adalah timestamp relatif dalam milidetik.
    autoChapters[i].endlongWaktu akhir bab ini relatif terhadap waktu mulai audio. Ini adalah timestamp relatif dalam milidetik.
    autoChapters[i].headlinestringJudul satu baris untuk bab ini.
    autoChapters[i].summarystringRingkasan bab.

    meetingAssistance (ekstraksi notulen rapat cerdas, termasuk kata kunci, kalimat kunci, dan item tindakan)

    ParameterTipeDeskripsi
    meetingAssistanceobjectObjek hasil notulen rapat cerdas. Dapat berisi nol atau lebih hasil dari berbagai tipe.
    meetingAssistance.keywordslist[]Hasil ekstraksi kata kunci.
    meetingAssistance.keySentenceslist[]Hasil ekstraksi kalimat kunci, juga dikenal sebagai sorotan.
    meetingAssistance.keySentences[i].idlongNomor urut kalimat kunci.
    meetingAssistance.keySentences[i].sentenceIdlongID kalimat yang sesuai dengan kalimat kunci ini dalam transkripsi ASR asli.
    meetingAssistance.keySentences[i].startlongWaktu mulai relatif terhadap waktu mulai audio. Ini adalah timestamp relatif dalam milidetik.
    meetingAssistance.keySentences[i].endlongWaktu akhir relatif terhadap waktu mulai audio. Ini adalah timestamp relatif dalam milidetik.
    meetingAssistance.keySentences[i].textstringKonten kalimat kunci.
    meetingAssistance.actionslist[]Kumpulan item tindakan dan ringkasan item tindakan.
    meetingAssistance.actions[i].idlongNomor urut item tindakan.
    meetingAssistance.actions[i].sentenceIdlongID kalimat yang sesuai dengan kalimat kunci ini dalam transkripsi ASR asli.
    meetingAssistance.actions[i].startlongWaktu mulai relatif terhadap waktu mulai audio. Ini adalah timestamp relatif dalam milidetik.
    meetingAssistance.actions[i].endlongWaktu akhir relatif terhadap waktu mulai audio. Ini adalah timestamp relatif dalam milidetik.
    meetingAssistance.actions[i].textstringKonten item tindakan.
    meetingAssistance.classificationsobjectKlasifikasi adegan. Saat ini hanya tiga klasifikasi adegan yang didukung.
    meetingAssistance.classifications.interviewfloatSkor kepercayaan untuk adegan wawancara.
    meetingAssistance.classifications.lecturefloatSkor kepercayaan untuk adegan kuliah.
    meetingAssistance.classifications.meetingfloatSkor kepercayaan untuk adegan rapat.

    Contoh

    Respons sukses

    JSONformat

    {
  "JobStatus": "Success",
  "RequestId": "******11-DB8D-4A9A-875B-275798******\n",
  "UserData": "{\"userId\":\"123432412831\"}\n",
  "Results": {
    "result": [
      {
        "Type": "ASR",
        "Data": "{\"title\":\"example-title-****\"}\t\n"
      }
    ]
  },
  "TemplateId": "",
  "Params": "",
  "Input": {
    "Type": "",
    "Media": ""
  }
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.