API Content Filter Image

Полный справочник 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 для получения подробностей.