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

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

نظرة عامة

يفحص Content Filter Text إدخالًا نصيًا بحثًا عن فئات أمان المحتوى المدعومة ويعيد نتيجة اكتشاف متزامنة. نوع الاكتشاف الحالي هو 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-text-standard',
    type: 'nsfw',
    text: 'Sample text to check'
  })
});

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

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

jsonنسخ
{
  "code": 0,
  "message": "success",
  "data": {
    "type": "nsfw",
    "flagged": false,
    "credits": 200,
    "detail": {
      "text": {
        "checked": true,
        "flagged": false,
        "score": 0,
        "level": "none"
      },
      "images": []
    }
  }
}

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

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

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

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

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

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