Submits feedback on a video moderation result to help Alibaba Cloud AI Guardrails improve its algorithm model.
Description
Operation: /green/video/feedback
Use this operation to report the moderation result you expected for a video task. AI Guardrails uses your feedback to refine its detection models.
For request construction details, see Request structure. For SDK support, see SDK overview.
Billing: Free of charge.
QPS limits
This operation supports up to 20 calls per second per account. Exceeding this limit triggers throttling and may disrupt your service. Design your integration to stay within this limit.
Request parameters
All AI Guardrails API requests require common parameters. See Common parameters for details.
The request body is a JSON object with the following parameters:
| Parameter | Type | Required | Example | Description |
|---|---|---|---|---|
| taskId | String | Yes | taskId xxx | The ID of the moderation task, as returned by the AI Guardrails server. |
| dataId | String | No | dataId xxx | The ID of the moderated video. Use the same value you set in the original moderation request. |
| url | String | No | http://www.aliyundoc.com/d.mp4 | The URL of the moderated video. Use the same value you set in the original moderation request. Omit this parameter if the original request did not include a video URL. |
| suggestion | String | No | block | The moderation result you expected. Valid values:
|
| scenes | StringArray | No | ["ad","terrorism"] | The moderation scenarios to provide feedback for. Valid values:
|
| frames | JSONArray | Yes | — | The frames you consider to belong to the detected category. Each element is a frame object. See the following table for the frame structure. |
frame object
| Parameter | Type | Required | Example | Description |
|---|---|---|---|---|
| url | String | Yes | http://www.aliyundoc.com/1.jpg | The URL of the frame. |
| offset | Integer | Yes | 100 | The time offset from the start of the video to the frame. Unit: seconds. |
| note | String | No | blabla | Additional remarks. |
Response parameters
For common response parameters, see Response.
The data field in the response body is empty for this operation.
Examples
Request example
http(s)://[Endpoint]/green/video/feedback
&<Common request parameters>
{
"taskId":"taskId xxx",
"dataId":"dataId xxx",
"url":"http://www.aliyundoc.com/d.mp4",
"frames":[
{
"url":"http://www.aliyundoc.com/1.jpg",
"offset":100
},
{
"url":"http://www.aliyundoc.com/2.jpg",
"offset":200
}
],
"suggestion": "block",
"scenes":[
"ad",
"terrorism"
],
"note": "blabla"
}Response example
{
"code": 200,
"msg": "OK",
"requestId": "EE5A1189-4D7B-4C24-AD78-4C1FAA3E7A0C"
}