Kueri detail pekerjaan moderasi konten - Intelligent Media Services - Alibaba Cloud - Intelligent Media Services

Memanggil QueryMediaCensorJobDetail untuk mengkueri informasi detail tugas peninjauan media.

Deskripsi operasi

Dalam hasil peninjauan media, bagian video diurutkan berdasarkan titik waktu secara menaik untuk membentuk garis waktu. Jika durasi video sangat panjang, hanya halaman pertama informasi yang dikembalikan selama kueri dalam bentuk halaman. Jika Anda perlu mengkueri hasil lengkap bagian video secara detail, Anda dapat memanggil API ini secara terpisah.

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

get

*全部资源

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
JobId	string	Yes	ID tugas peninjauan media. Anda dapat memperolehnya dari parameter respons SubmitMediaCensorJob.	2288c6ca184c0e47098a5b665e2a12****
NextPageToken	string	No	Token halaman berikutnya. Biarkan kosong saat dikirimkan untuk pertama kalinya. Token halaman berikutnya akan dikembalikan setelah kueri pertama.	ae0fd49c0840e14daf0d66a75b83****
MaximumPageSize	integer	No	Jumlah maksimum entri yang dikembalikan per halaman. Nilai default: 30 Rentang nilai: 1 hingga 300	30

Elemen respons

Element	Type	Description	Example
	object	Parameter respons.
RequestId	string	ID permintaan.	B42299E6-F71F-465F-8FE9-4FC2E3D3C2CA
MediaCensorJobDetail	object	Daftar hasil tugas peninjauan media.
CreationTime	string	Waktu pembuatan.	2018-09-13T16:32:24Z
FinishTime	string	Waktu penyelesaian.	2018-09-13T16:38:24Z
Suggestion	string	Hasil peninjauan keseluruhan dari tugas. Nilai yang valid: pass: Lulus. review: Peninjauan manual diperlukan. block: Diblokir. Catatan Ketika hasil peninjauan dari jenis apa pun adalah review, hasil keseluruhan adalah review. Ketika hasil peninjauan dari jenis apa pun adalah block, hasil keseluruhan adalah block.	block
CoverImageCensorResults	object
CoverImageCensorResult	array<object>	The moderation results of thumbnails.
	array<object>	The detailed results.
Object	string	The Object Storage Service (OSS) object that is used as the thumbnail.	test/ai/censor/v2/vme-****.jpg
Location	string	The OSS region in which the thumbnail resides.	oss-cn-shanghai
Bucket	string	The OSS bucket in which the thumbnail is stored.	bucket-out-test-****
Results	object
Result	array<object>	The moderation results.
	object	The detailed moderation results.
Suggestion	string	The recommended subsequent operation. Valid values: pass: The content passes the moderation. review: The content needs to be manually reviewed. block: The content needs to be blocked.	pass
Label	string	The label of the moderation result. Valid values in the pornographic content moderation scenario: normal: normal content. sexy: sexy content. porn: pornographic content. Valid values in the terrorist content moderation scenario: normal: normal content. bloody: bloody content. explosion: explosion and smoke. outfit: special costume. logo: special logo. weapon: weapon. politics: political content. violence: violence. crowd: crowd. parade: parade. carcrash: car accident. flag: flag. location: landmark. others: other content. Valid values in the ad moderation scenario: normal: normal content. ad: other ads. politics: political content in text. porn: pornographic content in text. abuse: abuse in text. terrorism: terrorist content in text. contraband: prohibited content in text. spam: spam in text. npx: illegal ad. qrcode: QR code. programCode: mini program code. Valid values in the undesirable scene moderation scenario: normal: normal content. meaningless: meaningless content, such as a black or white screen. PIP: picture-in-picture. smoking: smoking. drivelive: live broadcasting in a running vehicle. Valid values in the logo moderation scenario: normal: normal content. TV: controlled logo. trademark: trademark.	Normal
Scene	string	The moderation scenario. Valid values: porn: pornographic content moderation. terrorism: terrorist content moderation. ad: ad moderation. live: undesirable scene moderation. logo: logo moderation.	Antispam
Rate	string	The score. Valid values: 0 to 100.	100
State	string	Status tugas.	Success
TitleCensorResult	object	Hasil peninjauan judul.
Suggestion	string	The recommended subsequent operation. Valid values: pass: The content passes the moderation. review: The content needs to be manually reviewed. block: The content needs to be blocked.	block
Label	string	The label of the moderation result. Valid values: normal: normal content. spam: spam. ad: ads. abuse: abuse content. flood: excessive junk content. contraband: prohibited content. meaningless: meaningless content.	meaningless
Scene	string	The moderation scenario. The value is antispam.	antispam
Rate	string	The score.	99.91
Message	string	Pesan kesalahan yang dikembalikan ketika tugas gagal. Parameter ini tidak dikembalikan ketika tugas berhasil.	The resource operated cannot be found
Input	object	Input tugas.
Object	string	The name of the OSS object that is used as the input file.	test/ai/censor/test-****.mp4
Location	string	The OSS region in which the input file resides.	oss-cn-shanghai
Bucket	string	The name of the OSS bucket in which the input file is stored.	bucket-test-in-****
BarrageCensorResult	object	Hasil peninjauan komentar bullet.
Suggestion	string	The recommended subsequent operation. Valid values: pass: The content passes the moderation. review: The content needs to be manually reviewed. block: The content needs to be blocked.	pass
Label	string	The label of the moderation result. Valid values: normal: normal content. spam: spam. ad: ads. abuse: abuse content. flood: excessive junk content. contraband: prohibited content. meaningless: meaningless content.	normal
Scene	string	The moderation scenario. The value is antispam.	antispam
Rate	string	The score.	99.91
DescCensorResult	object	Hasil peninjauan deskripsi.
Suggestion	string	The recommended subsequent operation. Valid values: pass: The content passes the moderation. review: The content needs to be manually reviewed. block: The content needs to be blocked.	review
Label	string	The label of the moderation result. Valid values: normal: normal content. spam: spam. ad: ads. abuse: abuse content. flood: excessive junk content. contraband: prohibited content. meaningless: meaningless content.	terrorism
Scene	string	The moderation scenario. The value is antispam.	antispam
Rate	string	The score.	100
VideoCensorConfig	object	Konfigurasi peninjauan video.
OutputFile	object	The information about output snapshots.
Object	string	The OSS object that is generated as the output snapshot. Catatan In the example, {Count} is a placeholder. The OSS objects that are generated as output snapshots are named `output00001-**.jpg`, `output00002-**.jpg`, and so on.	output{Count}.jpg
Location	string	The OSS region in which the output snapshot resides.	oss-cn-shanghai
Bucket	string	The OSS bucket in which the output snapshot is stored.	test-bucket-****
VideoCensor	string	Indicates whether the video content needs to be moderated. Default value: true. Valid values: true: The video content needs to be moderated. false: The video content does not need to be moderated.	true
BizType	string	The custom business type. Default value: common.	common
JobId	string	ID tugas peninjauan media.	f8f166eea7a44e9bb0a4aecf9543****
UserData	string	Data yang ditentukan pengguna.	example userdata ****
Code	string	Kode kesalahan yang dikembalikan ketika tugas gagal. Parameter ini tidak dikembalikan ketika tugas berhasil.	InvalidParameter.ResourceNotFound
VensorCensorResult	object	Hasil peninjauan video.
VideoTimelines	object
VideoTimeline	array<object>	The moderation results that are sorted in ascending order by time.
	array<object>	The response parameters.
Timestamp	string	The position in the video. Format: `hh:mm:ss[.SSS]`.	00:02:59.999
Object	string	The OSS object that is generated as the output snapshot. Catatan In the example, {Count} is a placeholder. The OSS objects that are generated as output snapshots are named `output00001-**.jpg`, `output00002-**.jpg`, and so on.	output{Count}.jpg
CensorResults	object
CensorResult	array<object>	The moderation results that include information such as labels and scores.
	object	The response parameters.
Suggestion	string	The recommended subsequent operation. Valid values: pass: The content passes the moderation. review: The content needs to be manually reviewed. block: The content needs to be blocked.	block
Label	string	The label of the moderation result. Valid values in the pornographic content moderation scenario: normal: normal content. sexy: sexy content. porn: pornographic content. Valid values in the terrorist content moderation scenario: normal: normal content. bloody: bloody content. explosion: explosion and smoke. outfit: special costume. logo: special logo. weapon: weapon. politics: political content. violence: violence. crowd: crowd. parade: parade. carcrash: car accident. flag: flag. location: landmark. others: other content. Valid values in the ad moderation scenario: normal: normal content. ad: other ads. politics: political content in text. porn: pornographic content in text. abuse: abuse in text. terrorism: terrorist content in text. contraband: prohibited content in text. spam: spam in text. npx: illegal ad. qrcode: QR code. programCode: mini program code. Valid values in the undesirable scene moderation scenario: normal: normal content. meaningless: meaningless content, such as a black or white screen. PIP: picture-in-picture. smoking: smoking. drivelive: live broadcasting in a running vehicle. Valid values in the logo moderation scenario: normal: normal content. TV: controlled logo. trademark: trademark.	flood
Scene	string	The moderation scenario. Valid values: porn: pornographic content moderation. terrorism: terrorist content moderation. ad: ad moderation. live: undesirable scene moderation. logo: logo moderation.	porn
Rate	string	The score.	99.99
NextPageToken	string	A pagination token. It can be used in the next request to retrieve a new page of results.	ea04afcca7cd4e80b9ece8fbb251****
CensorResults	object
CensorResult	array<object>	A collection of moderation results. The information includes the summary about various scenarios such as pornographic content moderation and terrorist content moderation.
	object	The detailed moderation results.
Suggestion	string	The recommended subsequent operation. Valid values: pass: The content passes the moderation. review: The content needs to be manually reviewed. block: The content needs to be blocked.	review
Label	string	The label of the moderation result. Valid values in the pornographic content moderation scenario: normal: normal content. sexy: sexy content. porn: pornographic content. Valid values in the terrorist content moderation scenario: normal: normal content. bloody: bloody content. explosion: explosion and smoke. outfit: special costume. logo: special logo. weapon: weapon. politics: political content. violence: violence. crowd: crowd. parade: parade. carcrash: car accident. flag: flag. location: landmark. others: other content. Valid values in the ad moderation scenario: normal: normal content. ad: other ads. politics: political content in text. porn: pornographic content in text. abuse: abuse in text. terrorism: terrorist content in text. contraband: prohibited content in text. spam: spam in text. npx: illegal ad. qrcode: QR code. programCode: mini program code. Valid values in the undesirable scene moderation scenario: normal: normal content. meaningless: meaningless content, such as a black or white screen. PIP: picture-in-picture. smoking: smoking. drivelive: live broadcasting in a running vehicle. Valid values in the logo moderation scenario: normal: normal content. TV: controlled logo. trademark: trademark.	meaningless
Scene	string	The moderation scenario. Valid values: porn: pornographic content moderation. terrorism: terrorist content moderation. ad: ad moderation. live: undesirable scene moderation. logo: logo moderation.	terrorism
Rate	string	The score.	100
PipelineId	string	ID pipeline.	c5b30b7c0d0e4a0abde1d5f9e751****

Contoh

Respons sukses

JSONformat

{
  "RequestId": "B42299E6-F71F-465F-8FE9-4FC2E3D3C2CA",
  "MediaCensorJobDetail": {
    "CreationTime": "2018-09-13T16:32:24Z",
    "FinishTime": "2018-09-13T16:38:24Z",
    "Suggestion": "block",
    "CoverImageCensorResults": {
      "CoverImageCensorResult": [
        {
          "Object": "test/ai/censor/v2/vme-****.jpg",
          "Location": "oss-cn-shanghai",
          "Bucket": "bucket-out-test-****",
          "Results": {
            "Result": [
              {
                "Suggestion": "pass",
                "Label": "Normal",
                "Scene": "Antispam",
                "Rate": "100"
              }
            ]
          }
        }
      ]
    },
    "State": "Success",
    "TitleCensorResult": {
      "Suggestion": "block",
      "Label": "meaningless",
      "Scene": "antispam",
      "Rate": "99.91"
    },
    "Message": "The resource operated cannot be found",
    "Input": {
      "Object": "test/ai/censor/test-****.mp4",
      "Location": "oss-cn-shanghai",
      "Bucket": "bucket-test-in-****"
    },
    "BarrageCensorResult": {
      "Suggestion": "pass",
      "Label": "normal",
      "Scene": "antispam",
      "Rate": "99.91"
    },
    "DescCensorResult": {
      "Suggestion": "review",
      "Label": "terrorism",
      "Scene": "antispam",
      "Rate": "100"
    },
    "VideoCensorConfig": {
      "OutputFile": {
        "Object": "output{Count}.jpg",
        "Location": "oss-cn-shanghai",
        "Bucket": "test-bucket-****"
      },
      "VideoCensor": "true",
      "BizType": "common"
    },
    "JobId": "f8f166eea7a44e9bb0a4aecf9543****",
    "UserData": "example userdata ****",
    "Code": "InvalidParameter.ResourceNotFound",
    "VensorCensorResult": {
      "VideoTimelines": {
        "VideoTimeline": [
          {
            "Timestamp": "00:02:59.999",
            "Object": "output{Count}.jpg",
            "CensorResults": {
              "CensorResult": [
                {
                  "Suggestion": "block",
                  "Label": "flood",
                  "Scene": "porn",
                  "Rate": "99.99"
                }
              ]
            }
          }
        ]
      },
      "NextPageToken": "ea04afcca7cd4e80b9ece8fbb251****",
      "CensorResults": {
        "CensorResult": [
          {
            "Suggestion": "review",
            "Label": "meaningless",
            "Scene": "terrorism",
            "Rate": "100"
          }
        ]
      }
    },
    "PipelineId": "c5b30b7c0d0e4a0abde1d5f9e751****"
  }
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.