API Content Filter Image

Tài liệu tham chiếu API đầy đủ cho mô hình phát hiện nội dung hình ảnh content-filter-image-standard.

Tổng quan

Content Filter Image kiểm tra một hoặc nhiều URL hình ảnh theo các danh mục an toàn nội dung được hỗ trợ và trả về kết quả phát hiện đồng bộ. Loại phát hiện hiện tại là nsfw.

Điểm cuối

httpSao chép
POST /api/v1/content/filter

Xác thực

httpSao chép
Authorization: Bearer YOUR_API_KEY

Tham số yêu cầu

Bắt buộc

Không hỗ trợ

Ví dụ yêu cầu

javascriptSao chép
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);

Định dạng phản hồi

jsonSao chép
{
  "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"
        }
      ]
    }
  }
}

Dữ liệu phản hồi

Kết quả phát hiện

Mỗi item trong data.detail.images dùng cấu trúc này:

Ghi chú kết quả

• Nếu checked là false, hình ảnh không được kiểm tra thành công. Trong trường hợp đó, score có thể là 0 và level có thể là "none", nhưng hình ảnh nên được xem là lỗi phát hiện thay vì kết quả không có rủi ro.
• flagged chỉ mô tả kết quả phát hiện sau khi hình ảnh đã được kiểm tra.
• data.flagged là true khi ít nhất một hình ảnh được kiểm tra thành công bị gắn cờ.
• level là mức rủi ro thân thiện với hiển thị được suy ra từ điểm phát hiện.

Xử lý lỗi

Nếu yêu cầu thất bại, API trả về code khác 0 hoặc trạng thái HTTP không phải 2xx. Kiểm tra trường message để biết chi tiết.