API รูปภาพ Content Filter

เอกสารอ้างอิง 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 เพื่อดูรายละเอียด