API Content Filter Image

Riferimento API completo per il modello di rilevamento dei contenuti immagine content-filter-image-standard.

Panoramica

Content Filter Image controlla uno o più URL di immagini per le categorie di sicurezza dei contenuti supportate e restituisce un risultato di rilevamento sincrono. Il tipo di rilevamento attuale è nsfw.

Punto di accesso

httpCopia
POST /api/v1/content/filter

Autenticazione

httpCopia
Authorization: Bearer YOUR_API_KEY

Parametri della richiesta

Obbligatori

Non supportati

Esempio di richiesta

javascriptCopia
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 della risposta

jsonCopia
{
  "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"
        }
      ]
    }
  }
}

Dati della risposta

Risultato del rilevamento

Ogni elemento in data.detail.images usa questa struttura:

Note sui risultati

• Se checked è false, l'immagine non è stata controllata correttamente. In quel caso, score può essere 0 e level può essere "none", ma l'immagine deve essere trattata come un errore di rilevamento invece che come un risultato senza rischio.
• flagged descrive solo il risultato del rilevamento dopo che un'immagine è stata controllata.
• data.flagged è true quando almeno un'immagine controllata correttamente è contrassegnata.
• level è il livello di rischio adatto alla visualizzazione derivato dal punteggio di rilevamento.

Gestione degli errori

Se la richiesta non riesce, l'API restituisce un code diverso da zero o uno stato HTTP non-2xx. Controlla il campo message per i dettagli.