QuerySmarttagJob - Intelligent Media Services - Alibaba Cloud Documentation Center

Mengkueri pekerjaan smart tagging.

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

*全部资源

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
JobId	string	Yes	ID pekerjaan smart tagging yang akan dikueri. Anda dapat memperolehnya dari parameter pengembalian SubmitSmarttagJob.	88c6ca184c0e47098a5b665e2****
Params	string	No	Parameter permintaan tambahan, direpresentasikan sebagai string JSON. Contoh: {"labelResultType":"auto"}. labelResultType bertipe String dan dapat diatur ke nilai berikut: auto: Hasil penandaan mesin hmi: Hasil kolaborasi manusia-mesin	{"labelResultType":"auto"}

Elemen respons

Element	Type	Description	Example
	object
JobStatus	string	Status pekerjaan. Nilai yang valid: Success: Pekerjaan berhasil diproses. Fail: Pekerjaan gagal diproses. Processing: Pekerjaan sedang diproses. Submitted: Pekerjaan telah dikirim dan menunggu untuk diproses.	Success
RequestId	string	ID permintaan.	****11-DB8D-4A9A-875B-275798****
UserData	string	Informasi yang diteruskan selama callback MNS. Untuk format pesan, lihat definisi format pesan callback di bawah.	{"userId":"123432412831"}
Results	object
Result	array<object>	Array objek hasil analisis.
	object
Type	string	The type of the analysis result. The type of the analysis result based on Smart tagging V1.0. Valid values: TextLabel: the text tag. VideoLabel: the video tag. ASR: the original result of automatic speech recognition (ASR). By default, this type of result is not returned. OCR: the original result of optical character recognition (OCR). By default, this type of result is not returned. NLP: the natural language processing (NLP)-based result. By default, this type of result is not returned. The type of the analysis result based on Smart tagging V2.0. Valid values: CPVLabel Meta: the information about the video file, such as the title of the video. By default, this type of information is not returned. The type of the analysis result based on Smart tagging V2.0-custom. Valid values: CPVLabel Meta: the information about the video file, such as the title of the video. By default, this type of information is not returned.	Meta
Data	string	The details of the analysis result. The value is a JSON string. For more information about the parameters of different result types, see the "Parameters of different result types" section of this topic.	{"title":"example-title-****"}
Usages	object
Usage	array<object>
	object
Type	string
Quota	integer

Definisi Format Pesan Callback Ketika status eksekusi pekerjaan smart tagging berubah, MPS mengirim pesan ke antrian yang ditentukan pengguna (untuk cara menentukan antrian callback, lihat API Update Pipeline MPS). Badan pesan adalah string JSON yang berisi bidang-bidang berikut:

Nama	Tipe	Deskripsi
Type	String	String tetap "smarttag", menunjukkan pekerjaan smart tagging
JobId	String	ID unik dari pekerjaan
State	String	Status pekerjaan saat ini, konsisten dengan JobStatus di QuerySmarttagJob
State	String	Status pekerjaan saat ini, konsisten dengan JobStatus di QuerySmarttagJob
UserData	String	UserData yang dimasukkan oleh pengguna di SubmitSmarttagJob
UserData	String	UserData yang dimasukkan oleh pengguna di SubmitSmarttagJob

Deskripsi Parameter Result

Struktur Data VideoLabel

Nama	Tipe	Deskripsi
persons	JSONArray	Hasil deteksi orang
persons.name	String	Nama orang yang dikenali
persons.category	String	Tipe orang. Nilai yang valid: `celebrity`; `politician`; `sensitive`; `unknown`; ID perpustakaan orang kustom (dikembalikan ketika orang yang dikenali adalah orang kustom)
persons.ratio	double	Tingkat kemunculan orang. Rentang nilai: 0 hingga 1
persons.occurrences	JSONArray	Informasi detail tentang kemunculan orang
persons.occurrences.score	double	Skor kepercayaan
persons.occurrences.from	double	Waktu mulai ketika orang terdeteksi. Satuan: detik
persons.occurrences.to	double	Waktu selesai ketika orang terdeteksi. Satuan: detik
persons.occurrences.position	JSONObject	Koordinat wajah
persons.occurrences.position.leftTop	int[]	Koordinat x, y sudut kiri atas
persons.occurrences.position.rightBottom	int[]	Koordinat x, y sudut kanan bawah
persons.occurrences.timestamp	double	Stempel waktu dari koordinat wajah. Satuan: detik
persons.occurrences.scene	String	Tipe pengambilan gambar orang. Nilai yang valid: `closeUp`; `medium-closeUp`; `medium`; `medium-long`
tags	JSONArray	Tag yang terdeteksi untuk objek, adegan, dll. Lihat tabel di bawah untuk contoh
tags.mainTagName	String	Tag utama
tags.subTagName	String	Sub tag
tags.ratio	double	Tingkat kemunculan. Rentang nilai: 0 hingga 1
tags.occurrences	JSONArray	Informasi kemunculan detail
tags.occurrences.score	double	Skor kepercayaan
tags.occurrences.from	double	Waktu mulai. Satuan: detik
tags.occurrences.to	double	Waktu selesai. Satuan: detik
classifications	JSONArray	Informasi klasifikasi video
classifications.score	double	Skor kepercayaan
classifications.category1	String	Kategori utama, seperti: Gaya Hidup, Animasi, Otomotif, dll.
classifications.category2	String	Kategori sekunder, seperti subkategori di bawah Gaya Hidup: Kesehatan, Rumah, dll.

Contoh Tag Video

mainTagName	subTagName
Acara	Contoh: Where Are We Going, Dad?, Happy Comedian, dll.
Karakter	Contoh: Dokter, Perawat, Guru, dll.
Objek	Contoh: Piano, Gelas air, Meja, Telur orak-arik dengan tomat, Mobil, Kosmetik, dll.
Logo	Contoh: CCTV1, CCTV2, Youku, Dragon TV, dll.
Aksi/Peristiwa	Contoh: Menari, Berciuman, Berpelukan, Rapat, Bernyanyi, Menelepon, Berkuda, Berkelahi, dll.
Wilayah	Contoh: Tiananmen di Beijing, Patung Liberty, Buddha Raksasa Leshan, Tiongkok, Amerika Serikat, dll.
Adegan	Contoh: Kamar tidur, Stasiun kereta bawah tanah, Sawah terasering, Pantai, Gurun, dll.

Struktur Data ImageLabel

Nama	Tipe	Deskripsi
persons	JSONArray	Hasil deteksi orang
persons.name	String	Nama orang yang dikenali
persons.category	String	Tipe orang. Nilai yang valid: celebrity; politician; sensitive
persons.score	double	Skor kepercayaan orang
persons.position	JSONObject	Koordinat wajah
persons.position.leftTop	int[]	Koordinat x, y sudut kiri atas
persons.position.rightBottom	int[]	Koordinat x, y sudut kanan bawah
persons.scene	String	Tipe pengambilan gambar orang. Nilai yang valid: closeUp; medium-closeUp; medium; medium-long
tags	JSONArray	Tag yang terdeteksi untuk objek, adegan, dll. Lihat tabel di bawah untuk contoh
tags.mainTagName	String	Tag utama
tags.subTagName	String	Sub tag
tags.score	double	Skor kepercayaan

Contoh Tag Gambar

mainTagName	subTagName
Karakter	Contoh: Dokter, Perawat, Guru, dll.
Wilayah	Contoh: Tiananmen di Beijing, Patung Liberty, Buddha Raksasa Leshan, Tiongkok, Amerika Serikat, dll.
Aksi/Peristiwa	Contoh: Berbicara, dll.
Logo	Contoh: CCTV1, CCTV2, Youku, Dragon TV, dll.
Aksi/Peristiwa	Contoh: Menari, Berciuman, Berpelukan, Rapat, Bernyanyi, Menelepon, Berkuda, Berkelahi, dll.
Objek	Contoh: Piano, Gelas air, Meja, Telur orak-arik dengan tomat, Mobil, Kosmetik, dll.
Adegan	Contoh: Kamar tidur, Stasiun kereta bawah tanah, Sawah terasering, Pantai, Gurun, dll.

Struktur Data TextLabel (Diturunkan dari ASR dan OCR)

Nama	Tipe	Deskripsi
tags	JSONArray	Informasi tag teks. Lihat tabel di bawah untuk contoh
tags.name	String	Kategori tag
tags.value	String	Nilai tag. Beberapa nilai tag dapat ada, dipisahkan oleh koma (,)

Contoh Tag Teks

name	value
Wilayah	Contoh: Tiananmen di Beijing, Patung Liberty, Buddha Raksasa Leshan, Tiongkok, Amerika Serikat, dll.
Organisasi	Contoh: China Wildlife Conservation Association, China Media Group, dll.
Logo	Contoh: Nike, Li Ning
Kata Kunci	Contoh: Backbone

Struktur Data CPVLabel

cates: Kategori (kategori primer, sekunder, dan tersier)
entities: Properti kategori (dengan informasi grafik pengetahuan)
hotwords: Kata-kata tren (daftar pantau berfokus pengguna)
freeTags: Tag bebas (kata kunci)

Nama	Tipe	Nilai Contoh	Deskripsi
type	String	hmi	Tipe hasil. Nilai yang valid: hmi (hasil kolaborasi manusia-mesin), auto (hasil penandaan mesin)
cates	JSONArray	-	Hasil kategori klasifikasi
cates.labelLevel1	String	Travel	Tag primer
cates.labelLevel2	String	Travel Scenery	Tag sekunder
cates.label	String	""	Nama tag. Algoritma mungkin mengembalikan nilai kosong
cates.appearanceProbability	double	0.96	Tingkat kemunculan
cates.detailInfo	JSONArray	-	-
cates.detailInfo.score	double	0.9	Skor kepercayaan
cates.detailInfo.startTime	double	0.021	Waktu mulai
cates.detailInfo.endTime	double	29.021	Waktu selesai
entities	JSONArray	-	-
entities.labelLevel1	String	Region	Tag primer
entities.labelLevel2	String	Landmark	Tag sekunder
entities.label	String	Huangguoshu Waterfall	Nama tag
entities.appearanceProbability	double	0.067	Tingkat kemunculan
entities.knowledgeInfo	String	{"name": "Huangguoshu Waterfall", "nameEn": "Huangguoshu Waterfall", "description": "One of the four largest waterfalls in Asia"}	Informasi grafik pengetahuan. Untuk daftar bidang lengkap, lihat tabel terlampir: Grafik IP Film/TV/Variety, Grafik Musik, Grafik Orang, Grafik Landmark, dan Grafik Objek.
entities.detailInfo	JSONArray	-	-
entities.detailInfo.score	double	0.33292606472969055	Skor kepercayaan
entities.detailInfo.startTime	double	6.021	Waktu mulai
entities.detailInfo.endTime	double	8.021	Waktu selesai
entities.detailInfo.trackData	JSONArray	-	Informasi terstruktur tag entitas
entities.detailInfo.trackData.score	double	0.32	Skor kepercayaan
entities.detailInfo.trackData.bbox	integer[]	23, 43, 45, 67	Kotak pembatas
entities.detailInfo.trackData.timestamp	double	7.9	Stempel waktu
hotwords	JSONArray	-	-
hotwords.labelLevel1	String	Keyword	Tag primer
hotwords.labelLevel1	String	Keyword	Tag sekunder
hotwords.labelLevel2	String	""	Tag sekunder
hotwords.label	String	China Meteorological Administration	Konten kata tren
hotwords.appearanceProbability	double	0.96	Tingkat kemunculan
hotwords.detailInfo	JSONArray
hotwords.detailInfo.score	double	1.0	Skor kepercayaan
hotwords.detailInfo.startTime	double	0.021	Waktu mulai
hotwords.detailInfo.endTime	double	29.021	Waktu selesai
freeTags	JSONArray
freeTags.labelLevel1	String	Keyword	Tag primer
freeTags.labelLevel2	String	""	Tag sekunder
freeTags.label	String	National Meteorological Center	Konten kata tren
freeTags.appearanceProbability	double	0.96	Tingkat kemunculan
freeTags.detailInfo	JSONArray
freeTags.detailInfo.score	double	0.9	Skor kepercayaan
freeTags.detailInfo.startTime	double	0.021	Waktu mulai
freeTags.detailInfo.endTime	double	29.021	Waktu selesai

Hasil ASR (Pengenalan Suara)

Nama	Tipe	Deskripsi
details	JSONArray	Hasil pekerjaan detail
details.from	double	Stempel waktu mulai. Satuan: detik
details.to	double	Stempel waktu selesai. Satuan: detik
details.content	String	Konten teks yang dikenali

Hasil OCR (Pengenalan Teks)

Nama	Tipe	Deskripsi
details	JSONArray	Hasil pekerjaan detail
details.timestamp	double	Informasi stempel waktu. Satuan: detik
details.info	JSONArray	Informasi spesifik yang dikenali pada titik waktu ini
details.info.score	double	Skor kepercayaan
details.info.position	JSONObject	Koordinat teks
details.info.position.leftTop	int[]	Koordinat x, y sudut kiri atas
details.info.position.rightBottom	int[]	Koordinat x, y sudut kanan bawah
details.info.content	String	Konten teks yang dikenali

Hasil Anotasi Meta

Catatan

Jika pengguna tidak menggunakan anotasi manusia-mesin, ketika mengirimkan pekerjaan menggunakan SubmitSmarttagJob dengan needMetaData yang ditentukan, QuerySmarttagJob akan mengembalikan judul asli yang dimasukkan oleh pengguna.

Nama	Tipe	Deskripsi
title	String	Judul

Hasil Ekstraksi Subtitle

Nama	Tipe	Deskripsi
details	JSONArray	Hasil pekerjaan detail
details.allResultUrl	String	URL untuk semua hasil subtitle. URL berlaku selama enam bulan setelah pekerjaan selesai
details.chResultUrl	String	URL untuk hasil bahasa Mandarin. URL berlaku selama enam bulan setelah pekerjaan selesai
details.engResultUrl	String	URL untuk hasil bahasa Inggris. URL berlaku selama enam bulan setelah pekerjaan selesai

Catatan

Konten URL hasil subtitle: nomor urut + rentang waktu + konten subtitle (satu subtitle per baris).

Hasil Pemrosesan NLP

Parameter	Tipe	Deskripsi
transcription	object	Hasil transkripsi suara
autoChapters	object	Hasil ikhtisar bab
summarization	object	Hasil ringkasan model besar
meetingAssistance	object	Hasil notulen rapat cerdas
translation	object	Hasil terjemahan teks

transcription (Transkripsi Suara)

Parameter	Tipe	Deskripsi
transcription	object	Objek hasil transkripsi suara.
transcription.paragraphs	list[]	Kumpulan hasil transkripsi suara yang diatur berdasarkan paragraf.
transcription.paragraphs[i].paragraphId	string	ID tingkat paragraf.
transcription.paragraphs[i].speakerId	string	ID pembicara.
transcription.paragraphs[i].words	list[]	Informasi kata yang terkandung dalam paragraf.
transcription.paragraphs[i].words[i].id	int	Nomor urut kata, biasanya dapat diabaikan.
transcription.paragraphs[i].words[i].sentenceId	int	ID kalimat. Kata-kata dengan SentenceId yang sama dapat dirangkai menjadi satu kalimat.
transcription.paragraphs[i].words[i].start	long	Waktu mulai kata relatif terhadap waktu mulai audio. Stempel waktu relatif dalam milidetik.
transcription.paragraphs[i].words[i].end	long	Waktu selesai kata relatif terhadap waktu mulai audio. Stempel waktu relatif dalam milidetik.
transcription.paragraphs[i].words[i].text	string	Teks kata.

summarization (Ringkasan Teks Lengkap, Ringkasan Pembicara, Ringkasan Tanya Jawab)

Parameter	Tipe	Deskripsi
summarization	object	Objek hasil ringkasan. Dapat berisi nol atau lebih hasil dari berbagai tipe ringkasan.
summarization.paragraphSummary	string	Hasil ringkasan teks lengkap.
summarization.conversationalSummary	list[]	Daftar hasil ringkasan pembicara.
summarization.conversationalSummary[i].speakerId	string	ID pembicara.
summarization.conversationalSummary[i].speakerName	string	Nama pembicara.
summarization.conversationalSummary[i].summary	string	Ringkasan yang sesuai dengan pembicara.
summarization.questionsAnsweringSummary	list[]	Daftar hasil ringkasan Tanya Jawab.
summarization.questionsAnsweringSummary[i].question	string	Pertanyaan
summarization.questionsAnsweringSummary[i].sentenceIdsOfQuestion	list[]	Daftar SentenceId dari transkripsi suara asli yang sesuai dengan pertanyaan.
summarization.questionsAnsweringSummary[i].answer	string	Jawaban yang sesuai dengan pertanyaan.
summarization.questionsAnsweringSummary[i].sentenceIdsOfAnswer	list[]	Daftar SentenceId dari transkripsi suara asli yang sesuai dengan jawaban.
summarization.mindMapSummary	list[object]	Daftar hasil ringkasan peta pikiran. Dapat berisi ringkasan setiap topik, hubungan antar topik, dll.
summarization.mindMapSummary[i].title	string	Judul topik.
summarization.mindMapSummary[i].topic	list[object]	Array yang berisi setiap topik dan subtopiknya
summarization.mindMapSummary[i].topic[i].title	string	Judul topik.
summarization.mindMapSummary[i].topic[i].topic	list[object]	Array subtopik untuk topik. Dapat berupa array kosong.

translation (Terjemahan Teks Lengkap)

Parameter	Tipe	Deskripsi
translation	object	Objek hasil terjemahan.
translation.paragraphs	list[]	Kumpulan hasil terjemahan yang diatur berdasarkan paragraf, sesuai dengan pesan hasil pengenalan suara.
translation.paragraphs.paragraphId	string	ID segmen paragraf, sesuai dengan ParagraphId dalam hasil pengenalan suara.
translation.paragraphs.sentences	list[]	Kumpulan teks terjemahan.
translation.paragraphs.sentences[i].sentenctId	long	ID kalimat.
translation.paragraphs.sentences[i].start	long	Waktu mulai segmen relatif terhadap waktu mulai audio. Stempel waktu relatif dalam milidetik.
translation.paragraphs.sentences[i].end	long	Waktu selesai segmen relatif terhadap waktu mulai audio. Stempel waktu relatif dalam milidetik.
translation.paragraphs.sentences[i].text	string	Teks terjemahan, sesuai dengan pesan hasil pengenalan suara.

autoChapters (Pengenalan Bab)

Parameter	Tipe	Deskripsi
autoChapters	list[]	Kumpulan ikhtisar bab. Berisi nol, satu, atau lebih entri ikhtisar bab.
autoChapters[i].id	int	Nomor urut bab.
autoChapters[i].start	long	Waktu mulai bab relatif terhadap waktu mulai audio. Stempel waktu relatif dalam milidetik.
autoChapters[i].end	long	Waktu selesai bab relatif terhadap waktu mulai audio. Stempel waktu relatif dalam milidetik.
autoChapters[i].headline	string	Judul satu kalimat dari bab.
autoChapters[i].summary	string	Ringkasan bab.

meetingAssistance (Ekstraksi Notulen Rapat Cerdas, Termasuk Kata Kunci, Kalimat Kunci, dan Item Tindakan)

Parameter	Tipe	Deskripsi
meetingAssistance	object	Objek hasil notulen rapat cerdas. Dapat berisi nol atau lebih hasil dari berbagai tipe.
meetingAssistance.keywords	list[]	Hasil ekstraksi kata kunci.
meetingAssistance.keySentences	list[]	Hasil ekstraksi kalimat kunci, juga dikenal sebagai konten kunci.
meetingAssistance.keySentences[i].id	long	Nomor urut kalimat kunci.
meetingAssistance.keySentences[i].sentenceId	long	ID kalimat yang sesuai dengan kalimat kunci dalam transkripsi ASR asli.
meetingAssistance.keySentences[i].start	long	Waktu mulai relatif terhadap waktu mulai audio. Stempel waktu relatif dalam milidetik.
meetingAssistance.keySentences[i].end	long	Waktu selesai relatif terhadap waktu mulai audio. Stempel waktu relatif dalam milidetik.
meetingAssistance.keySentences[i].text	string	Informasi kalimat kunci.
meetingAssistance.actions	list[]	Kumpulan item tindakan dan ringkasan item tindakan.
meetingAssistance.actions[i].id	long	Nomor urut item tindakan.
meetingAssistance.actions[i].sentenceId	long	ID kalimat yang sesuai dengan item tindakan dalam transkripsi ASR asli.
meetingAssistance.actions[i].start	long	Waktu mulai relatif terhadap waktu mulai audio. Stempel waktu relatif dalam milidetik.
meetingAssistance.actions[i].end	long	Waktu selesai relatif terhadap waktu mulai audio. Stempel waktu relatif dalam milidetik.
meetingAssistance.actions[i].text	string	Konten item tindakan.
meetingAssistance.classifications	object	Klasifikasi adegan. Saat ini hanya 3 klasifikasi adegan yang didukung.
meetingAssistance.classifications.interview	float	Skor kepercayaan untuk adegan wawancara.
meetingAssistance.classifications.lecture	float	Skor kepercayaan untuk adegan ceramah.
meetingAssistance.classifications.meeting	float	Skor kepercayaan untuk adegan rapat.

Contoh

Respons sukses

JSONformat

{
  "JobStatus": "Success",
  "RequestId": "******11-DB8D-4A9A-875B-275798******",
  "UserData": "{\"userId\":\"123432412831\"}",
  "Results": {
    "Result": [
      {
        "Type": "Meta",
        "Data": "{\"title\":\"example-title-****\"}\t\n"
      }
    ]
  },
  "Usages": {
    "Usage": [
      {
        "Type": "",
        "Quota": 0
      }
    ]
  }
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.