واجهة API لتصفية محتوى الصور

مرجع API كامل لنموذج اكتشاف محتوى الصور content-filter-image-standard.

نظرة عامة

يفحص Content Filter Image عنوان URL واحدًا أو أكثر للصور بحثًا عن فئات أمان المحتوى المدعومة ويعيد نتيجة اكتشاف متزامنة. نوع الاكتشاف الحالي هو nsfw.

نقطة النهاية

httpنسخ
POST /api/v1/content/filter

المصادقة {#}

httpنسخ
Authorization: Bearer YOUR_API_KEY

معلمات الطلب

مطلوبة

غير مدعوم

مثال طلب

javascriptنسخ
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);

تنسيق الاستجابة

jsonنسخ
{
  "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"
        }
      ]
    }
  }
}

بيانات الاستجابة

نتيجة الاكتشاف

يستخدم كل عنصر في data.detail.images هذه البنية:

ملاحظات النتيجة

• إذا كانت checked تساوي false، فلم يتم فحص الصورة بنجاح. في هذه الحالة، قد تكون score هي 0 وقد تكون level هي "none"، ولكن يجب التعامل مع الصورة كفشل في الاكتشاف بدلًا من نتيجة بلا مخاطر.
• يصف flagged نتيجة الاكتشاف فقط بعد فحص الصورة.
• تكون data.flagged هي true عندما تكون هناك صورة واحدة على الأقل تم فحصها بنجاح وعليها علم.
• level هو مستوى المخاطر المناسب للعرض والمشتق من درجة الاكتشاف.

معالجة الأخطاء

إذا فشل الطلب، يعيد API قيمة code غير صفرية أو حالة HTTP غير 2xx. تحقق من حقل message للاطلاع على التفاصيل.