API Content Filter Image

Referência completa da API para o modelo de detecção de conteúdo de imagem content-filter-image-standard.

Visão geral

Content Filter Image verifica uma ou mais URLs de imagem em categorias de segurança de conteúdo compatíveis e retorna um resultado de detecção síncrono. O tipo de detecção atual é nsfw.

Ponto de extremidade

httpCopiar
POST /api/v1/content/filter

Autenticação

httpCopiar
Authorization: Bearer YOUR_API_KEY

Parâmetros da solicitação

Obrigatórios

Não compatível

Exemplo de solicitação

javascriptCopiar
const response = await fetch('https://api.flaq.ai/api/v1/content/filter', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'content-filter-image-standard',
    type: 'nsfw',
    images: [
      'https://example.com/image-1.jpg',
      'https://example.com/image-2.jpg'
    ]
  })
});

const result = await response.json();
console.log(result.data);

Formato da resposta

jsonCopiar
{
  "code": 0,
  "message": "success",
  "data": {
    "type": "nsfw",
    "flagged": true,
    "credits": 400,
    "detail": {
      "text": null,
      "images": [
        {
          "url": "https://example.com/image-1.jpg",
          "checked": true,
          "flagged": true,
          "score": 96,
          "level": "high"
        },
        {
          "url": "https://example.com/image-2.jpg",
          "checked": true,
          "flagged": false,
          "score": 0,
          "level": "none"
        }
      ]
    }
  }
}

Dados da resposta

Resultado da detecção

Cada item em data.detail.images usa esta estrutura:

Observações do resultado

• Se checked for false, a imagem não foi verificada com sucesso. Nesse caso, score pode ser 0 e level pode ser "none", mas a imagem deve ser tratada como uma falha de detecção, não como um resultado sem risco.
• flagged descreve apenas o resultado da detecção depois que uma imagem foi verificada.
• data.flagged é true quando pelo menos uma imagem verificada com sucesso é sinalizada.
• level é o nível de risco adequado para exibição derivado da pontuação de detecção.

Tratamento de erros

Se a solicitação falhar, a API retornará um code diferente de zero ou um status HTTP não 2xx. Verifique o campo message para obter detalhes.