O SDK do AI Guardrails permite chamar a API de Moderação de Conteúdo para detectar e moderar imagens, vídeos, áudio e texto. Esta página explica qual modo de chamada de API usar para cada tipo de conteúdo e como obter o SDK.
Como funciona
Os quatro tipos de conteúdo (imagens, vídeos, áudio e texto) compartilham um padrão comum:
Detecção síncrona: envie o conteúdo e receba os resultados na mesma resposta. Ideal para itens únicos que exigem resposta imediata.
Detecção assíncrona: envie o conteúdo e receba um
taskId. Consulte os resultados com otaskIdou configure uma URL de callback para recebê-los automaticamente. Mais indicado para cargas de trabalho em lote ou arquivos grandes.
A tabela a seguir mostra o modo disponível e o recomendado para cada tipo de conteúdo.
|
Tipo de conteúdo |
Síncrono |
Assíncrono |
Modo recomendado |
|
Imagem |
Disponível |
Disponível |
Assíncrono para lotes; síncrono (recomenda-se uma imagem por solicitação) |
|
Vídeo |
Apenas sequências de quadros |
Detecção de vídeo completo |
Assíncrono |
|
Áudio |
Indisponível |
Disponível |
Assíncrono (única opção) |
|
Texto |
Disponível |
Indisponível |
Síncrono (única opção) |
Ao usar uma única API para múltiplos cenários de detecção, a taxa total é calculada da seguinte forma: preço por cenário × quantidade de conteúdo detectado.
Capacidades da API por tipo de conteúdo
Detecção de imagens
Os recursos de detecção de imagens (incluindo pornografia, conteúdo terrorista, reconhecimento óptico de caracteres [OCR] e logotipos) estão disponíveis em uma única API.
API de detecção síncrona de imagens
Envie uma ou mais imagens e receba todos os resultados na resposta. Para maior precisão, envie apenas uma imagem por solicitação.
API de detecção assíncrona de imagens
Envie imagens em lotes. A API retorna um taskId para cada imagem. Após o envio, use o taskId para recuperar os resultados. Utilize este modo para detecção de imagens em lote.
Detecção de vídeos
Os recursos de detecção de vídeos (incluindo pornografia, conteúdo terrorista e logotipos) estão disponíveis em uma única API.
API de detecção síncrona de vídeos
Suporta apenas a detecção de sequências de quadros extraídos de um vídeo. Não recomendamos este método. Use a API assíncrona para detectar o vídeo completo.
API de detecção assíncrona de vídeos
Envie uma tarefa de detecção de vídeo e recupere os resultados com o taskId ou defina uma URL de callback para receber os resultados ao concluir a detecção. Recomendamos este modo para conteúdo de vídeo.
Moderação de áudio
A API de moderação de áudio suporta a detecção de fluxos e arquivos de áudio. Apenas a versão assíncrona está disponível. Após enviar a tarefa, recupere os resultados com o taskId ou defina uma URL de callback para receber notificações.
Moderação de texto
Apenas a API síncrona está disponível para moderação de texto. Envie uma ou mais entradas de texto por solicitação e receba os resultados na resposta.
Pré-requisitos
Antes de começar, conclua as etapas a seguir.
Etapa 1: Instale o SDK para sua linguagem
O SDK do AI Guardrails está disponível nas seguintes linguagens:
Etapa 2: Baixe os exemplos de código
Baixe o green-sdk-sample_doc para obter exemplos completos de código em Java, PHP e Python.
As versões da API anteriores a 2018-05-09 foram descontinuadas. Se você receber um erro HTTP status code 400 com o código InvalidAction.NotFound, migre para a versão 2018-05-09.
Etapa 3: (Opcional) Use um SDK de terceiros para outras linguagens
Caso sua linguagem não esteja listada acima (como C#, C++, Node.js ou Python 3.5), chame a API do AI Guardrails diretamente via HTTP ou utilize um SDK de terceiros.
A Alibaba Cloud não fornece manutenção para SDKs de terceiros. Eles são listados apenas para referência.
Próximos passos
Consulte a Visão geral da API para entender todo o escopo da API antes da primeira chamada.
Siga o guia de instalação da sua linguagem para configurar as credenciais e fazer a primeira solicitação de detecção.