/green/video/feedback - AI Guardrails: Central de Documentação do Alibaba Cloud

Descrição

Operação: /green/video/feedback

Use esta operação para informar o resultado de moderação esperado de uma tarefa de vídeo. O AI Guardrails utiliza esse feedback para refinar os modelos de detecção.

Para obter detalhes sobre a construção da requisição, consulte Estrutura da requisição. Para informações sobre suporte a SDK, veja Visão geral do SDK.

Faturamento: Gratuito.

Limites de QPS

Esta operação permite até 20 chamadas por segundo por conta. Exceder esse limite aciona o throttling e pode interromper o serviço. Planeje a integração para permanecer dentro desse limite.

Parâmetros da requisição

Todas as requisições de API do AI Guardrails exigem parâmetros comuns. Consulte Parâmetros comuns para mais detalhes.

O corpo da requisição é um objeto JSON com os seguintes parâmetros:

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
taskId	String	Sim	taskId xxx	ID da tarefa de moderação retornado pelo servidor do AI Guardrails.
dataId	String	Não	dataId xxx	ID do vídeo moderado. Use o mesmo valor definido na requisição de moderação original.
url	String	Não	http://www.aliyundoc.com/d.mp4	URL do vídeo moderado. Mantenha o mesmo valor usado na requisição original. Omita este parâmetro se a requisição inicial não incluía uma URL de vídeo.
suggestion	String	Não	block	Resultado de moderação esperado. Valores válidos: `pass`: o vídeo é normal `block`: o vídeo contém violações
scenes	StringArray	Não	["ad","terrorism"]	Cenários de moderação para envio de feedback. Valores válidos: `porn`: detecção de pornografia `terrorism`: detecção de conteúdo terrorista `ad`: detecção de anúncios É possível especificar vários cenários.
frames	JSONArray	Sim	—	Frames considerados pertencentes à categoria detectada. Cada elemento é um objeto `frame`. Consulte a tabela a seguir para ver a estrutura de `frame`.

Objeto frame

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
url	String	Sim	http://www.aliyundoc.com/1.jpg	URL do frame.
offset	Integer	Sim	100	Deslocamento de tempo entre o início do vídeo e o frame. Unidade: segundos.
note	String	Não	blabla	Observações adicionais.

Parâmetros de resposta

Para parâmetros de resposta comuns, consulte Resposta.

O campo data no corpo da resposta fica vazio nesta operação.

Exemplos

Exemplo de requisição

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"
}

Exemplo de resposta

{
  "code": 200,
  "msg": "OK",
  "requestId": "EE5A1189-4D7B-4C24-AD78-4C1FAA3E7A0C"
}