Menampilkan hasil pekerjaan moderasi konten.
Catatan penggunaan
Dalam hasil moderasi konten, hasil moderasi video diurutkan berdasarkan waktu secara menaik menjadi satu timeline. Jika video berdurasi panjang, hasil moderasi kontennya dipaginasi dan hanya halaman pertama yang dikembalikan. Anda dapat memanggil operasi ini untuk mengambil seluruh hasil moderasi video tersebut.
Batas QPS
Anda dapat memanggil operasi API ini hingga 100 kali per detik per akun. Permintaan yang melebihi batas ini akan dibuang dan dapat menyebabkan gangguan layanan. Pastikan Anda memperhatikan batas ini saat memanggil operasi ini. Untuk informasi selengkapnya, lihat Batas QPS.
Debugging
OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kenyamanan, kami menyarankan Anda memanggil operasi ini melalui OpenAPI Explorer, yang secara dinamis menghasilkan contoh kode untuk berbagai SDK.
Parameter permintaan
| Parameter | Tipe | Wajib | Contoh | Deskripsi |
| Action | String | Ya | QueryMediaCensorJobDetail | Operasi yang ingin Anda lakukan. Tetapkan nilainya ke QueryMediaCensorJobDetail. |
| JobId | String | Ya | 2288c6ca184c0e47098a5b665e2a12**** | ID pekerjaan moderasi konten. Anda dapat memperoleh ID pekerjaan dari parameter respons operasi SubmitMediaCensorJob. |
| NextPageToken | String | Tidak | ae0fd49c0840e14daf0d66a75b83**** | Token yang digunakan untuk mengambil halaman berikutnya dari hasil kueri. Anda dapat mengosongkan parameter ini saat pertama kali memanggil operasi ini untuk menanyakan hasil pekerjaan moderasi konten. Token halaman berikutnya akan dikembalikan setelah Anda memanggil operasi ini untuk menanyakan hasil pekerjaan moderasi konten untuk pertama kalinya. |
| MaximumPageSize | Long | Tidak | 30 | Jumlah maksimum entri yang dikembalikan pada setiap halaman.
|
Parameter respons
| Parameter | Tipe | Contoh | Deskripsi |
| RequestId | String | B42299E6-F71F-465F-8FE9-4FC2E3D3C2CA | ID permintaan. |
| MediaCensorJobDetail | Object | Hasil pekerjaan moderasi konten. |
|
| CreationTime | String | 2018-09-13T16:32:24Z | Waktu saat pekerjaan dibuat. |
| FinishTime | String | 2018-09-21 | Waktu saat pekerjaan selesai. |
| Suggestion | String | block | Hasil keseluruhan pekerjaan. Nilai valid:
Jika hasil moderasi salah satu jenis konten yang dimoderasi adalah review, maka hasil keseluruhan menjadi review. Jika hasil moderasi salah satu jenis konten yang dimoderasi adalah block, maka hasil keseluruhan menjadi block. |
| CoverImageCensorResults | Array of CoverImageCensorResult | Hasil moderasi Gambar mini. |
|
| CoverImageCensorResult | |||
| Object | String | test/ai/censor/v2/vme-****.jpg | Objek Object Storage Service (OSS) yang digunakan sebagai thumbnail video. |
| Location | String | oss-cn-shanghai | Wilayah OSS tempat thumbnail video berada. |
| Bucket | String | bucket-out-test-**** | Bucket OSS yang menyimpan thumbnail video. |
| Results | Array of Result | Hasil moderasi. |
|
| Result | |||
| Suggestion | String | pass | Operasi lanjutan yang direkomendasikan. Nilai valid:
|
| Label | String | normal | Label hasil moderasi. Beberapa label dipisahkan dengan koma (,).
|
| Scene | String | porn | Skenario moderasi. Nilai valid:
|
| Rate | String | 100 | Skor. Nilai valid: 0 hingga 100. |
| State | String | Success | Status pekerjaan. |
| TitleCensorResult | Object | Hasil moderasi judul. |
|
| Suggestion | String | block | Operasi lanjutan yang direkomendasikan. Nilai valid:
|
| Label | String | meaningless | Label hasil moderasi. Nilai valid:
|
| Scene | String | antispam | Skenario moderasi. Nilainya adalah antispam. |
| Rate | String | 99.91 | Skor. |
| Message | String | The resource operated cannot be found | Pesan kesalahan yang dikembalikan jika pekerjaan gagal. Parameter ini tidak dikembalikan jika pekerjaan berhasil. |
| Input | Object | Informasi tentang input pekerjaan. |
|
| Object | String | test/ai/censor/test-****.mp4 | Objek OSS yang digunakan sebagai file input. |
| Location | String | oss-cn-shanghai | Wilayah OSS tempat file input berada. |
| Bucket | String | bucket-test-in-**** | Bucket OSS yang menyimpan file input. |
| BarrageCensorResult | Object | Hasil moderasi komentar langsung. |
|
| Suggestion | String | pass | Operasi lanjutan yang direkomendasikan. Nilai valid:
|
| Label | String | normal | Label hasil moderasi. Beberapa label dipisahkan dengan koma (,). Nilai valid:
|
| Scene | String | antispam | Skenario moderasi. Nilainya adalah antispam. |
| Rate | String | 99.91 | Skor. |
| DescCensorResult | Object | Hasil moderasi deskripsi. |
|
| Suggestion | String | review | Operasi lanjutan yang direkomendasikan. Nilai valid:
|
| Label | String | normal | Label hasil moderasi. Nilai valid:
|
| Scene | String | antispam | Skenario moderasi. Nilainya adalah antispam. |
| Rate | String | 100 | Skor. |
| VideoCensorConfig | Object | Konfigurasi moderasi video. |
|
| OutputFile | Object | Informasi tentang Snapshot output. |
|
| Object | String | output{Count}.jpg | Satu atau beberapa objek OSS yang dihasilkan sebagai Snapshot output. Catatan Dalam contoh, {Count} adalah placeholder. Objek OSS yang dihasilkan sebagai Snapshot output diberi nama output00001-****.jpg, output00002-****.jpg, dan seterusnya. |
| Location | String | oss-cn-shanghai | Wilayah OSS tempat bucket OSS untuk menyimpan Snapshot output berada. |
| Bucket | String | test-bucket-**** | Bucket OSS yang menyimpan Snapshot output. |
| VideoCensor | String | true | Menunjukkan apakah konten video perlu dimoderasi. Nilai default: true. Nilai valid:
|
| BizType | String | common | Jenis bisnis kustom. Nilai default: common. |
| JobId | String | f8f166eea7a44e9bb0a4aecf9543**** | ID pekerjaan moderasi konten. |
| UserData | String | example userdata **** | Data kustom. |
| Code | String | InvalidParameter.ResourceNotFound | Kode kesalahan yang dikembalikan jika pekerjaan gagal. Parameter ini tidak dikembalikan jika pekerjaan berhasil. |
| VensorCensorResult | Object | Hasil tinjauan video. |
|
| VideoTimelines | Array of VideoTimeline | Hasil moderasi yang diurutkan berdasarkan waktu secara menaik. |
|
| VideoTimeline | |||
| Timestamp | String | 00:02:59.999 | Posisi dalam video. Format: |
| Object | String | output{Count}.jpg | Satu atau beberapa objek OSS yang dihasilkan sebagai Snapshot output. Catatan Dalam contoh, {Count} adalah placeholder. Objek OSS yang dihasilkan sebagai Snapshot output diberi nama output00001-****.jpg, output00002-****.jpg, dan seterusnya. |
| CensorResults | Array of CensorResult | Hasil moderasi yang mencakup informasi seperti label dan skor. |
|
| CensorResult | |||
| Suggestion | String | block | Operasi lanjutan yang direkomendasikan. Nilai valid:
|
| Label | String | porn,ad | Label hasil moderasi. Beberapa label dipisahkan dengan koma (,).
|
| Scene | String | porn | Skenario moderasi. Nilai valid:
|
| Rate | String | 99.99 | Skor. |
| NextPageToken | String | ea04afcca7cd4e80b9ece8fbb251**** | Token yang digunakan untuk mengambil halaman berikutnya dari hasil kueri. |
| CensorResults | Array of CensorResult | Kumpulan hasil moderasi. Informasi mencakup ringkasan berbagai skenario seperti konten pornografi dan konten teroris. |
|
| CensorResult | |||
| Suggestion | String | review | Operasi lanjutan yang direkomendasikan. Nilai valid:
|
| Label | String | meaningless | Label hasil moderasi. Beberapa label dipisahkan dengan koma (,).
|
| Scene | String | terrorism | Skenario moderasi. Nilai valid:
|
| Rate | String | 100 | Skor. |
| PipelineId | String | c5b30b7c0d0e4a0abde1d5f9e751**** | ID antrian ApsaraVideo Media Processing (MPS) yang digunakan untuk menjalankan pekerjaan. |
Contoh
Permintaan Contoh
http(s)://mts.cn-shanghai.aliyuncs.com/?Action=QueryMediaCensorJobDetail
&JobId=2288c6ca184c0e47098a5b665e2a12****
&NextPageToken=ae0fd49c0840e14daf0d66a75b83****
&MaximumPageSize=30
&<Common request parameters>
Respons Sukses Contoh
XML format
HTTP/1.1 200 OK
Content-Type:application/xml
<QueryMediaCensorJobDetailResponse>
<RequestId>B42299E6-F71F-465F-8FE9-4FC2E3D3C2CA</RequestId>
<MediaCensorJobDetail>
<CreationTime>2018-09-13T16:32:24Z</CreationTime>
<FinishTime>2018-09-21</FinishTime>
<Suggestion>block</Suggestion>
<CoverImageCensorResults>
<Object>test/ai/censor/v2/vme-****.jpg</Object>
<Location>oss-cn-shanghai</Location>
<Bucket>bucket-out-test-****</Bucket>
<Results>
<Suggestion>pass</Suggestion>
<Label>normal</Label>
<Scene>porn</Scene>
<Rate>100</Rate>
</Results>
</CoverImageCensorResults>
<State>Success</State>
<TitleCensorResult>
<Suggestion>block</Suggestion>
<Label>meaningless</Label>
<Scene>antispam</Scene>
<Rate>99.91</Rate>
</TitleCensorResult>
<Message>The resource operated cannot be found</Message>
<Input>
<Object>test/ai/censor/test-****.mp4</Object>
<Location>oss-cn-shanghai</Location>
<Bucket>bucket-test-in-****</Bucket>
</Input>
<BarrageCensorResult>
<Suggestion>pass</Suggestion>
<Label>normal</Label>
<Scene>antispam</Scene>
<Rate>99.91</Rate>
</BarrageCensorResult>
<DescCensorResult>
<Suggestion>review</Suggestion>
<Label>normal</Label>
<Scene>antispam</Scene>
<Rate>100</Rate>
</DescCensorResult>
<VideoCensorConfig>
<OutputFile>
<Object>output{Count}.jpg</Object>
<Location>oss-cn-shanghai</Location>
<Bucket>test-bucket-****</Bucket>
</OutputFile>
<VideoCensor>true</VideoCensor>
<BizType>common</BizType>
</VideoCensorConfig>
<JobId>f8f166eea7a44e9bb0a4aecf9543****</JobId>
<UserData>example userdata ****</UserData>
<Code>InvalidParameter.ResourceNotFound</Code>
<VensorCensorResult>
<VideoTimelines>
<Timestamp>00:02:59.999</Timestamp>
<Object>output{Count}.jpg</Object>
<CensorResults>
<Suggestion>block</Suggestion>
<Label>porn,ad</Label>
<Scene>porn</Scene>
<Rate>99.99</Rate>
</CensorResults>
</VideoTimelines>
<NextPageToken>ea04afcca7cd4e80b9ece8fbb251****</NextPageToken>
<CensorResults>
<Suggestion>review</Suggestion>
<Label>meaningless</Label>
<Scene>terrorism</Scene>
<Rate>100</Rate>
</CensorResults>
</VensorCensorResult>
<PipelineId>c5b30b7c0d0e4a0abde1d5f9e751****</PipelineId>
</MediaCensorJobDetail>
</QueryMediaCensorJobDetailResponse>
JSON format
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "B42299E6-F71F-465F-8FE9-4FC2E3D3C2CA",
"MediaCensorJobDetail" : {
"CreationTime" : "2018-09-13T16:32:24Z",
"FinishTime" : "2018-09-21",
"Suggestion" : "block",
"CoverImageCensorResults" : [ {
"Object" : "test/ai/censor/v2/vme-****.jpg",
"Location" : "oss-cn-shanghai",
"Bucket" : "bucket-out-test-****",
"Results" : [ {
"Suggestion" : "pass",
"Label" : "normal",
"Scene" : "porn",
"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" : "normal",
"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" : [ {
"Timestamp" : "00:02:59.999",
"Object" : "output{Count}.jpg",
"CensorResults" : [ {
"Suggestion" : "block",
"Label" : "porn,ad",
"Scene" : "porn",
"Rate" : "99.99"
} ]
} ],
"NextPageToken" : "ea04afcca7cd4e80b9ece8fbb251****",
"CensorResults" : [ {
"Suggestion" : "review",
"Label" : "meaningless",
"Scene" : "terrorism",
"Rate" : "100"
} ]
},
"PipelineId" : "c5b30b7c0d0e4a0abde1d5f9e751****"
}
}
Deskripsi Tambahan Respons Contoh
// Contoh file {jobId}.video_timeline
// Setelah moderasi selesai, sistem menghasilkan file JSON bernama {jobId}.video_timeline dan menyimpan file tersebut di bucket OSS yang ditentukan oleh parameter CensorConfig.OutputFile operasi SubmitMediaCensorJob. Contoh isi file:
[
{
"CensorResults":[
{
"Label":"ad",
"Rate":"99.9100000000",
"Scene":"ad"
}
],
"Object":"gaoshen/test8/example-00001.jpg",
"Timestamp":"00:00:00.005"
},
{
"CensorResults":[
{
"Label":"ad",
"Rate":"99.9100000000",
"Scene":"ad"
}
],
"Object":"gaoshen/test8/example-00002.jpg",
"Timestamp":"00:00:05.005"
},
{
"CensorResults":[
{
"Label":"ad",
"Rate":"99.9100000000",
"Scene":"ad"
}
],
"Object":"gaoshen/test8/example-00003.jpg",
"Timestamp":"00:00:10.005"
},
{
"CensorResults":[
{
"Label":"ad",
"Rate":"99.9100000000",
"Scene":"ad"
}
],
"Object":"gaoshen/test8/example-00004.jpg",
"Timestamp":"00:00:15.005"
},
{
"CensorResults":[
{
"Label":"politics",
"Rate":"82.6500000000",
"Scene":"terrorism",
"SfaceData":[
{
"faces":[
{
"id":"AliFace_0006942",
"name":"Name",
"rate":82.65
}
],
"h":51,
"w":40,
"x":744,
"y":121
}
]
}
],
"Object":"gaoshen/test8/example-00008.jpg",
"Timestamp":"00:00:35.005"
},
{
"CensorResults":[
{
"Label":"politics",
"Rate":"93.6800000000",
"Scene":"terrorism",
"SfaceData":[
{
"faces":[
{
"id":"AliFace_0006942",
"name":"Name",
"rate":93.68
}
],
"h":119,
"w":94,
"x":662,
"y":94
}
]
}
],
"Object":"gaoshen/test8/example-00011.jpg",
"Timestamp":"00:00:50.005"
},
{
"CensorResults":[
{
"Label":"ad",
"Rate":"99.9100000000",
"Scene":"ad"
}
],
"Object":"gaoshen/test8/example-00011.jpg",
"Timestamp":"00:00:50.005"
},
{
"CensorResults":[
{
"Label":"politics",
"Rate":"89.2900000000",
"Scene":"terrorism",
"SfaceData":[
{
"faces":[
{
"id":"AliFace_0006942",
"name":"Name",
"rate":89.29
}
],
"h":112,
"w":98,
"x":665,
"y":138
}
]
}
],
"Object":"gaoshen/test8/example-00012.jpg",
"Timestamp":"00:00:55.005"
},
{
"CensorResults":[
{
"Label":"ad",
"Rate":"99.9100000000",
"Scene":"ad"
}
],
"Object":"gaoshen/test8/example-00012.jpg",
"Timestamp":"00:00:55.005"
},
{
"CensorResults":[
{
"Label":"politics",
"Rate":"92.1400000000",
"Scene":"terrorism",
"SfaceData":[
{
"faces":[
{
"id":"AliFace_0007536",
"name":"Name",
"rate":92.14
}
],
"h":117,
"w":91,
"x":665,
"y":79
}
]
}
],
"Object":"gaoshen/test8/example-00013.jpg",
"Timestamp":"00:01:00.005"
},
{
"CensorResults":[
{
"Label":"ad",
"Rate":"99.9100000000",
"Scene":"ad"
}
],
"Object":"gaoshen/test8/example-00013.jpg",
"Timestamp":"00:01:00.005"
},
{
"CensorResults":[
{
"Label":"politics",
"Rate":"93.0400000000",
"Scene":"terrorism",
"SfaceData":[
{
"faces":[
{
"id":"AliFace_0002750",
"name":"Name",
"rate":93.04
}
],
"h":120,
"w":93,
"x":673,
"y":79
}
]
}
],
"Object":"gaoshen/test8/example-00014.jpg",
"Timestamp":"00:01:05.005"
}
]
Kode kesalahan
Untuk daftar kode kesalahan, kunjungi API Error Center.