Interroge les résultats d'une tâche de modération de contenu.
Notes d'utilisation
Les résultats de la modération vidéo sont triés par ordre chronologique croissant pour former une chronologie. Pour les vidéos longues, les résultats sont paginés et seule la première page est renvoyée par défaut. Appelez cette opération pour récupérer l'intégralité des résultats de modération.
Limite de QPS
Vous pouvez appeler cette opération d'API jusqu'à 100 fois par seconde par compte. Les requêtes dépassant cette limite sont rejetées, ce qui entraîne des interruptions de service. Tenez compte de cette limite lors de vos appels. Pour plus d'informations, consultez la rubrique Limite de QPS.
Débogage
Paramètres de requête
| Parameter | Type | Required | Example | Description |
| Action | String | Yes | QueryMediaCensorJobDetail | L'opération à exécuter. Définissez la valeur sur QueryMediaCensorJobDetail. |
| JobId | String | Yes | 2288c6ca184c0e47098a5b665e2a12**** | L'ID de la tâche de modération de contenu. Vous pouvez obtenir cet ID dans les paramètres de réponse de l'opération SubmitMediaCensorJob. |
| NextPageToken | String | No | ae0fd49c0840e14daf0d66a75b83**** | Le jeton permettant de récupérer la page suivante des résultats. Laissez ce paramètre vide lors du premier appel. Le jeton de la page suivante est renvoyé après le premier appel. |
| MaximumPageSize | Long | No | 30 | Le nombre maximal d'entrées à renvoyer par page.
|
Paramètres de réponse
| Parameter | Type | Example | Description |
| RequestId | String | B42299E6-F71F-465F-8FE9-4FC2E3D3C2CA | L'ID de la requête. |
| MediaCensorJobDetail | Object | Les résultats de la tâche de modération de contenu. |
|
| CreationTime | String | 2018-09-13T16:32:24Z | L'heure de création de la tâche. |
| FinishTime | String | 2018-09-21 | L'heure de fin de la tâche. |
| Suggestion | String | block | Le résultat global de la tâche. Valeurs valides :
Si le résultat de la modération d'un type de contenu est « review », le résultat global est « review ». Si le résultat de la modération d'un type de contenu est « block », le résultat global est « block ». |
| CoverImageCensorResults | Array of CoverImageCensorResult | Les résultats de la modération des vignettes. |
|
| CoverImageCensorResult | |||
| Object | String | test/ai/censor/v2/vme-****.jpg | L'objet Object Storage Service (OSS) utilisé comme vignette vidéo. |
| Location | String | oss-cn-shanghai | La région OSS où se trouve la vignette vidéo. |
| Bucket | String | bucket-out-test-**** | Le bucket OSS qui stocke la vignette vidéo. |
| Results | Array of Result | Les résultats de la modération. |
|
| Result | |||
| Suggestion | String | pass | L'action subséquente recommandée. Valeurs valides :
|
| Label | String | normal | Les libellés du résultat de la modération. Plusieurs libellés sont séparés par des virgules (,).
|
| Scene | String | porn | Le scénario de modération. Valeurs valides :
|
| Rate | String | 100 | Le score. Plage de valeurs valides : 0 à 100. |
| State | String | Success | L'état de la tâche. |
| TitleCensorResult | Object | Le résultat de la modération du titre. |
|
| Suggestion | String | block | L'action subséquente recommandée. Valeurs valides :
|
| Label | String | meaningless | Les libellés du résultat de la modération. Valeurs valides :
|
| Scene | String | antispam | Le scénario de modération. La valeur est antispam. |
| Rate | String | 99.91 | Le score. |
| Message | String | The resource operated cannot be found | Le message d'erreur renvoyé en cas d'échec de la tâche. Ce paramètre n'est pas renvoyé si la tâche aboutit. |
| Input | Object | Les informations relatives à l'entrée de la tâche. |
|
| Object | String | test/ai/censor/test-****.mp4 | L'objet OSS utilisé comme fichier d'entrée. |
| Location | String | oss-cn-shanghai | La région OSS où se trouve le fichier d'entrée. |
| Bucket | String | bucket-test-in-**** | Le bucket OSS qui stocke le fichier d'entrée. |
| BarrageCensorResult | Object | Le résultat de la modération des commentaires en direct. |
|
| Suggestion | String | pass | L'action subséquente recommandée. Valeurs valides :
|
| Label | String | normal | Les libellés du résultat de la modération. Plusieurs libellés sont séparés par des virgules (,). Valeurs valides :
|
| Scene | String | antispam | Le scénario de modération. La valeur est antispam. |
| Rate | String | 99.91 | Le score. |
| DescCensorResult | Object | Le résultat de la modération de la description. |
|
| Suggestion | String | review | L'action subséquente recommandée. Valeurs valides :
|
| Label | String | normal | Les libellés du résultat de la modération. Valeurs valides :
|
| Scene | String | antispam | Le scénario de modération. La valeur est antispam. |
| Rate | String | 100 | Le score. |
| VideoCensorConfig | Object | Les configurations de modération vidéo. |
|
| OutputFile | Object | Les informations relatives aux instantanés de sortie. |
|
| Object | String | output{Count}.jpg | Le ou les objets OSS générés en tant qu'instantanés de sortie. Remarque Dans cet exemple, {Count} est un espace réservé. Les objets OSS générés en tant qu'instantanés de sortie sont nommés output00001-****.jpg, output00002-****.jpg, etc. |
| Location | String | oss-cn-shanghai | La région OSS du bucket destiné au stockage de l'instantané de sortie. |
| Bucket | String | test-bucket-**** | Le bucket OSS qui stocke l'instantané de sortie. |
| VideoCensor | String | true | Indique si le contenu vidéo doit être modéré. Valeur par défaut : true. Valeurs valides :
|
| BizType | String | common | Le type d'activité personnalisé. Valeur par défaut : common. |
| JobId | String | f8f166eea7a44e9bb0a4aecf9543**** | L'ID de la tâche de modération de contenu. |
| UserData | String | example userdata **** | Les données personnalisées. |
| Code | String | InvalidParameter.ResourceNotFound | Le code d'erreur renvoyé en cas d'échec de la tâche. Ce paramètre n'est pas renvoyé si la tâche aboutit. |
| VensorCensorResult | Object | Les résultats de la révision vidéo. |
|
| VideoTimelines | Array of VideoTimeline | Les résultats de la modération triés par ordre chronologique croissant. |
|
| VideoTimeline | |||
| Timestamp | String | 00:02:59.999 | La position dans la vidéo. Format : |
| Object | String | output{Count}.jpg | Le ou les objets OSS générés en tant qu'instantanés de sortie. Remarque Dans cet exemple, {Count} est un espace réservé. Les objets OSS générés en tant qu'instantanés de sortie sont nommés output00001-****.jpg, output00002-****.jpg, etc. |
| CensorResults | Array of CensorResult | Les résultats de la modération incluant des informations telles que les libellés et les scores. |
|
| CensorResult | |||
| Suggestion | String | block | L'action subséquente recommandée. Valeurs valides :
|
| Label | String | porn,ad | Les libellés du résultat de la modération. Plusieurs libellés sont séparés par des virgules (,).
|
| Scene | String | porn | Le scénario de modération. Valeurs valides :
|
| Rate | String | 99.99 | Le score. |
| NextPageToken | String | ea04afcca7cd4e80b9ece8fbb251**** | Le jeton permettant de récupérer la page suivante des résultats. |
| CensorResults | Array of CensorResult | Une collection de résultats de modération. Les informations incluent un résumé concernant divers scénarios, tels que le contenu pornographique et le contenu terroriste. |
|
| CensorResult | |||
| Suggestion | String | review | L'action subséquente recommandée. Valeurs valides :
|
| Label | String | meaningless | Les libellés du résultat de la modération. Plusieurs libellés sont séparés par des virgules (,).
|
| Scene | String | terrorism | Le scénario de modération. Valeurs valides :
|
| Rate | String | 100 | Le score. |
| PipelineId | String | c5b30b7c0d0e4a0abde1d5f9e751**** | L'ID de la file d'attente ApsaraVideo Media Processing (MPS) utilisée pour exécuter la tâche. |
Exemples
Exemple de requête
http(s)://mts.cn-shanghai.aliyuncs.com/?Action=QueryMediaCensorJobDetail
&JobId=2288c6ca184c0e47098a5b665e2a12****
&NextPageToken=ae0fd49c0840e14daf0d66a75b83****
&MaximumPageSize=30
&<Common request parameters>Exemple de réponse réussie
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****"
}
}Description supplémentaire des exemples de réponses
// Sample {jobId}.video_timeline file
// After the moderation is complete, the system generates a JSON file named {jobId}.video_timeline and stores the file in the OSS bucket specified by the CensorConfig.OutputFile parameter of the SubmitMediaCensorJob operation. Sample content of the 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"
}
]Codes d'erreur
Pour obtenir la liste des codes d'erreur, consultez le Centre d'erreurs de l'API.