AI Guardrails:Perguntas frequentes sobre a API AI Guardrails

Cada chamada de operação assíncrona do AI Guardrails pode retornar vários resultados de moderação?

Não. Cada chamada assíncrona retorna apenas um resultado de moderação.

Como consultar as estatísticas de chamadas da API AI Guardrails?

O console Content Moderation exibe contagens agregadas de chamadas de API para moderação de imagens, vídeos, textos no último ano. Visualizar estatísticas.

Qual operação devo chamar para moderar texto?

Chame a operação /green/text/scan para moderar texto em busca de violações.

Como fornecer feedback sobre erros nos resultados de moderação de texto?

Se os resultados da moderação de texto forem imprecisos, chame /green/text/feedback para reportar o erro.

Como visualizar as descrições dos parâmetros retornados após chamar uma operação do AI Guardrails?

Os parâmetros de resposta comuns e os códigos de status HTTP estão documentados em Parâmetros comuns.

Posso incluir as informações de assinatura de uma solicitação de API no corpo da requisição?

Não. A assinatura deve estar no cabeçalho Authorization. Recomendamos o uso de um SDK do AI Guardrails (Java, Python, PHP, etc.) em vez de assinar manualmente. Consulte Parâmetros comuns e Visão geral do SDK.

A moderação de texto detecta URLs que direcionam para conteúdo indesejado?

Não. A moderação de texto detecta apenas violações baseadas em texto, não URLs que apontam para conteúdo indesejado.

Quanto tempo leva para moderar conteúdo ao chamar uma operação do AI Guardrails?

Posso usar o Composer para baixar o SDK do AI Guardrails para PHP?

Sim, desde que o seu Composer suporte PHP 5.3 ou posterior. Consulte Instalação.

Posso chamar a operação /green/text/scan para moderar texto em inglês no AI Guardrails?

Sim. Consulte /green/text/scan.

Posso chamar uma operação de moderação de vídeo para moderar um vídeo com tamanho superior a 2 GB no AI Guardrails?

O limite padrão de tamanho para um único vídeo é de 200 MB. Entre em contato com o suporte técnico para aumentá-lo até 2 GB. Para vídeos maiores que 2 GB, segmente-os antes da moderação. O limite padrão de captura de quadros é 200 (máximo de 3.600). Defina o parâmetro maxFrames para vídeos grandes. Consulte /green/video/asyncscan e /green/video/results.

Quais permissões são necessárias para chamar uma operação do AI Guardrails? Como conceder essas permissões?

Use o AccessKey ID e o AccessKey secret de um usuário RAM. O usuário RAM deve ter as permissões necessárias concedidas previamente. Consulte Autorizar um usuário RAM a chamar a API AI Guardrails.

Qual é o limite de tamanho de uma imagem a ser moderada no AI Guardrails?

Máximo: 20 MB de tamanho de arquivo, 30.000 pixels de altura ou largura e 0,25 bilhão de pixels no total. Consulte /green/image/scan.

O que é um limite de concorrência para chamar operações do AI Guardrails?

O limite de concorrência refere-se ao número total de imagens, vídeos ou entradas de texto que podem ser moderados simultaneamente. Isso se aplica tanto ao faturamento pagamento conforme o uso quanto à assinatura.

Posso enviar URLs internas de objetos para moderação?

Não. Apenas URLs publicamente acessíveis são suportadas. Para evitar vazamentos de dados, defina um curto período de validade (por exemplo, 10 minutos) para as URLs públicas.

Como moderar imagens que excedem o limite de tamanho?

Comprima as imagens antes do envio. Resoluções acima de 256 × 256 pixels têm impacto mínimo nos resultados da moderação.

Posso criar solicitações HTTP para chamar operações do AI Guardrails?

Sim, mas cada solicitação deve ser assinada. Recomendamos o uso dos SDKs oficiais.

Posso usar o par de AccessKey de um usuário RAM para chamar operações do AI Guardrails?

• Sim, para a versão da API V20160621 ou posterior. Consulte Visão geral do SDK.

• Não, versões anteriores a 20160621 não suportam isso. Usar o AccessKey de um usuário RAM com uma versão mais antiga da API retorna um erro AccessDenied.

A API AI Guardrails fornece exemplos de chamada?

Posso usar o SDK para .NET para chamar operações do AI Guardrails?

Não. Use SDKs para outras linguagens ou crie solicitações HTTP diretamente. Consulte Visão geral do SDK e Sintaxe da solicitação.

O AI Guardrails pode moderar imagens no formato GIF?

Sim. Formatos suportados: PNG, JPG, JPEG, BMP, GIF e WEBP. Consulte /green/image/scan.

Posso estender a duração máxima de download de 3s para um período maior ao chamar uma operação do AI Guardrails?

Não. Se ocorrerem erros de download frequentemente, verifique se a URL da imagem está acessível e responde dentro de 3s. Use o endpoint mais próximo da região do seu servidor. Consulte Endpoints.

Quantas imagens podem ser moderadas no máximo em cada chamada da operação /green/image/scan no AI Guardrails?

Até 100 imagens por chamada síncrona. Seu limite de concorrência deve ser de pelo menos 100 para processar essa quantidade. Limites padrão: 50 imagens/s, 100 entradas de texto/s, 20 fluxos de vídeo e áudio. Consulte Moderação síncrona e Preços.

Posso chamar uma única operação do AI Guardrails para moderar simultaneamente conteúdo em vários cenários, como detecção de pornografia e conteúdo terrorista?

Sim. Especifique múltiplas cenas no parâmetro Scenes, por exemplo ["porn", "terrorism"]. A cobrança é feita por cena: custo total = (número de imagens) × (preço por cena). Consulte Moderação síncrona e Preços.

Quais nomes de domínio e portas estão disponíveis para chamar operações do AI Guardrails?

Permita o acesso a *.aliyuncs.com nas portas 80 e 443 em sua política de segurança de rede.

Como chamar uma operação de moderação de vídeo no AI Guardrails para moderar um vídeo no ApsaraVideo VOD?

A API de Moderação de Vídeo não aceita um VideoID do ApsaraVideo VOD diretamente. Em vez disso, capture quadros e envie a sequência de imagens ou forneça uma URL de vídeo acessível. Consulte Moderação assíncrona.

O AI Guardrails pode moderar arquivos de vídeo M3U8?

Não. Formatos de vídeo suportados: AVI, FLV, MP4, MPG, ASF, WMV, MOV, WMA, RMVB, RM, FLASH e TS. Consulte /green/video/asyncscan e /green/video/results.

Quanto tempo dura uma tarefa assíncrona de moderação de vídeo?

Posso chamar operações do AI Guardrails em uma região dos Estados Unidos para moderar vídeos?

Sim. Consulte Endpoints.

Quais são as diferenças entre as operações /green/video/syncscan e /green/video/asyncscan no AI Guardrails?

A operação /green/video/syncscan exige que você envie quadros pré-capturados. A operação /green/video/asyncscan aceita uma URL de vídeo diretamente.

A operação /green/video/asyncscan suporta tanto arquivos quanto fluxos de vídeo. Você pode enviar quadros capturados ou uma URL de vídeo. Os resultados não são retornados em tempo real — defina o parâmetro de callback ou faça polling com /green/video/results. Consulte /green/video/syncscan e /green/video/asyncscan e /green/video/results.

Posso definir o parâmetro de callback em uma solicitação de API para moderação assíncrona de imagens implementada com o SDK do AI Guardrails para Java?

Sim. Consulte Moderação de imagens.

O que o parâmetro bizType especifica no AI Guardrails?

O parâmetro bizType especifica um cenário de negócios, que mapeia para uma política de moderação. Crie cenários personalizados que atendam aos seus requisitos e especifique o cenário nas solicitações de API para aplicar a política correspondente. Consulte Personalizar políticas para moderação assistida por máquina.

Qual é a finalidade de associar uma biblioteca de texto a vários cenários de negócios no AI Guardrails?

Associe uma biblioteca personalizada de texto ou imagem a um cenário de negócios para que ela seja aplicada apenas quando esse cenário for especificado nas solicitações de API. Se nenhum cenário for especificado, todas as bibliotecas habilitadas serão utilizadas. Consulte Gerenciar bibliotecas de texto personalizadas.

Por que o valor do parâmetro checksum na notificação de callback difere do valor calculado após eu chamar a operação /green/video/asyncscan?

O checksum é um hash SHA-256 de <UID> + <Seed> + <Content>. UID é o ID da sua conta Alibaba Cloud (encontrado no console). Quando o servidor receber um callback, recalcule o hash e verifique-o comparando com o checksum recebido para detectar adulterações. Consulte Habilitar notificações de callback.

Por que nenhum dataId é retornado após eu chamar a operação /green/text/scan no AI Guardrails?

Se você incluir o parâmetro DataId na sua solicitação de moderação de texto, a resposta da API incluirá o DataId correspondente. Para mais informações, consulte Moderação síncrona de texto.

Por que rótulos diferentes são retornados para a mesma imagem na moderação de cenário único e na moderação de múltiplos cenários?

Isso geralmente ocorre porque as configurações de cenário único e de múltiplos cenários diferem. Entre em contato com os engenheiros de algoritmo para verificar conflitos de configuração ou modere a imagem em cada cenário separadamente. Consulte /green/image/scan e Moderação de imagens.

Por que o parâmetro context não é retornado nos resultados da moderação de texto?

O parâmetro context retorna os termos de risco que acionaram a correspondência. Se o texto foi sinalizado por outras políticas, como modelos de algoritmo ou padrões de texto, esse parâmetro não é retornado. Consulte /green/text/scan.

Por que o parâmetro filteredContent é retornado, mas o parâmetro context não é retornado nos resultados da moderação de texto?

O campo FilteredContent mostra o texto moderado com quaisquer termos detectados substituídos por asteriscos (*). Esse campo é retornado se o texto corresponder a palavras-chave personalizadas ou a um algoritmo baseado em similaridade. O campo Context, que contém os termos de risco específicos, é retornado apenas quando há correspondência com uma palavra-chave. Ele não é retornado se o conteúdo for sinalizado por um modelo de algoritmo ou uma política de similaridade. Para mais informações, consulte Moderação síncrona de texto.

Por que os resultados da moderação de texto não contêm emojis?

O AI Guardrails não reconhece emojis. Os caracteres de emoji são filtrados nos resultados de moderação retornados.

A precisão e a taxa de recall da moderação síncrona de imagens diferem das da moderação assíncrona de imagens no AI Guardrails?

Não. Ambas possuem os mesmos efeitos de moderação — diferem apenas no método de chamada (síncrono vs. assíncrono).

Por que não consigo baixar a classe utilitária ClientUploader usada para moderar arquivos locais e binários no SDK do AI Guardrails para Java?

Baixe a classe utilitária ClientUploader e importe-a para o seu projeto. Consulte Instalação.

Por que a instalação da biblioteca aliyunsdkcore falha no SDK do AI Guardrails para Python 3.5.4 e 3.8.8?

Use uma versão principal do Python 3.x. Se a instalação ainda falhar, baixe a biblioteca aliyunsdkcore manualmente e importe-a para o seu projeto. Consulte Instalação.

Como instalar a classe utilitária aliyunsdkgreenextension do SDK do AI Guardrails para Python?

Baixe a classe utilitária aliyunsdkgreenextension e importe-a para o seu projeto. Consulte Instalação.

from aliyunsdkgreenextension.request.extension import HttpContentHelper

Uma biblioteca de termos personalizados no AI Guardrails pode conter termos em idiomas diferentes do inglês?

Não. Bibliotecas de termos personalizados suportam apenas letras do alfabeto inglês e dígitos.

Qual é o período de validade de uma URL do OSS para uma imagem ou vídeo carregado de uma máquina local para o OSS visando moderação de conteúdo?

A URL do OSS é válida por 1 hora.

Como sou cobrado pela moderação de um fluxo de vídeo ao vivo no AI Guardrails?

O faturamento baseia-se no número de quadros capturados. Divida a duração do fluxo pelo intervalo de captura para calcular a contagem de quadros.

Exemplo: um fluxo de 1 hora com intervalo de captura de 5 segundos produz 3.600 ÷ 5 = 720 quadros. Você será cobrado por 720 quadros.

Como os resultados da moderação de uma transmissão ao vivo são retornados para a URL de callback no AI Guardrails?

Os resultados são retornados individualmente sempre que uma violação é detectada. Após a conclusão da moderação, os resultados gerais são retornados.

Por que minha URL de callback ainda recebe dados depois que o AI Guardrails para de moderar uma transmissão ao vivo?

Após a interrupção da tarefa de moderação, sua URL de callback pode continuar recebendo dados brevemente devido à latência.

Uma tarefa de moderação de transmissão ao vivo é interrompida se o fluxo for interrompido ou ficar indisponível após o envio da tarefa?

Se o fluxo for interrompido ou ficar indisponível, o AI Guardrails tentará novamente três vezes com intervalos mínimos de 10 segundos. Se o fluxo ainda estiver indisponível após 30 segundos, a tarefa será interrompida.

Quando o código de status 200 é retornado na moderação de transmissões ao vivo?

O status 200 é retornado quando a moderação é bem-sucedida ou quando o fluxo termina/é interrompido. O status 280 indica que o fluxo ainda está sendo moderado.