이미지 콘텐츠 필터 API

content-filter-image-standard 이미지 콘텐츠 감지 모델을 위한 전체 API 레퍼런스입니다.

개요 {#}

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는 0이 아닌 code 또는 2xx가 아닌 HTTP 상태를 반환합니다. 자세한 내용은 message 필드를 확인하세요.