Image Filter API

Vollständige API-Referenz für das Bilderkennungsmodell content-filter-image-standard.

Überblick

Content Filter Image prüft eine oder mehrere Bild-URLs auf unterstützte Kategorien der Inhaltssicherheit und gibt ein synchrones Erkennungsergebnis zurück. Der aktuelle Erkennungstyp ist nsfw.

Endpunkt

httpKopieren
POST /api/v1/content/filter

Authentifizierung

httpKopieren
Authorization: Bearer YOUR_API_KEY

Anfrageparameter

Erforderlich

Nicht unterstützt

Beispielanfrage

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

Antwortformat

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

Antwortdaten

Erkennungsergebnis

Jedes Element in data.detail.images verwendet diese Struktur:

Ergebnishinweise

• Wenn checked false ist, wurde das Bild nicht erfolgreich geprüft. In diesem Fall können score 0 und level "none" sein, aber das Bild sollte als Erkennungsfehler und nicht als risikofreies Ergebnis behandelt werden.
• flagged beschreibt nur das Erkennungsergebnis, nachdem ein Bild geprüft wurde.
• data.flagged ist true, wenn mindestens ein erfolgreich geprüftes Bild markiert ist.
• level ist die anzeigefreundliche Risikostufe, die aus dem Erkennungswert abgeleitet wird.

Fehlerbehandlung

Wenn die Anfrage fehlschlägt, gibt die API einen code ungleich null oder einen HTTP-Status außerhalb von 2xx zurück. Prüfen Sie das Feld message für Details.