API Content Filter Image

Référence API complète pour le modèle de détection de contenu image content-filter-image-standard.

Présentation

Content Filter Image vérifie une ou plusieurs URL d'image pour les catégories de sécurité du contenu prises en charge et renvoie un résultat de détection synchrone. Le type de détection actuel est nsfw.

Point de terminaison

httpCopier
POST /api/v1/content/filter

Authentification

httpCopier
Authorization: Bearer YOUR_API_KEY

Paramètres de requête

Obligatoires

Non pris en charge

Exemple de requête

javascriptCopier
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);

Format de réponse

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

Données de réponse

Résultat de détection

Chaque élément dans data.detail.images utilise cette structure :

Notes sur les résultats

• Si checked vaut false, l'image n'a pas été vérifiée avec succès. Dans ce cas, score peut être 0 et level peut être "none", mais l'image doit être traitée comme un échec de détection plutôt que comme un résultat sans risque.
• flagged décrit uniquement le résultat de détection après qu'une image a été vérifiée.
• data.flagged vaut true lorsqu'au moins une image vérifiée avec succès est signalée.
• level est le niveau de risque adapté à l'affichage, dérivé du score de détection.

Gestion des erreurs

Si la requête échoue, l'API renvoie un code différent de zéro ou un statut HTTP non-2xx. Consultez le champ message pour plus de détails.