API de Content Filter Image

Referencia completa de la API para el modelo de detección de contenido de imagen content-filter-image-standard.

Descripción general

Content Filter Image revisa una o más URL de imágenes en busca de categorías de seguridad de contenido compatibles y devuelve un resultado de detección síncrono. El tipo de detección actual es nsfw.

Punto de conexión

http
POST /api/v1/content/filter

Autenticación

http
Authorization: Bearer YOUR_API_KEY

Parámetros de solicitud

Obligatorios

Parámetro	Tipo	Descripción
`model_name`	string	Debe ser `"content-filter-image-standard"`
`type`	string	Tipo de detección. Actualmente solo se admite `"nsfw"`.
`images`	string[]	URL de imágenes que se deben revisar. Admite detección de una sola imagen y de varias imágenes. La API admite hasta 20 imágenes por solicitud.

No compatible

Parámetro	Descripción
`text`	Use `content-filter-text-standard` para detección de texto.

Ejemplo de solicitud

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);

Formato de respuesta

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"
        }
      ]
    }
  }
}

Datos de respuesta

Campo	Tipo	Descripción
`data.type`	string	Tipo de detección utilizado para la solicitud.
`data.flagged`	boolean	Indica si alguna imagen revisada correctamente fue marcada para el tipo de detección solicitado.
`data.credits`	number	Créditos cobrados por la solicitud.
`data.detail.text`	null	Siempre `null` para detección de imágenes.
`data.detail.images`	array	Resultados de detección para cada URL de imagen enviada.

Resultado de detección

Cada elemento de data.detail.images usa esta estructura:

Campo	Tipo	Descripción
`url`	string	URL de imagen revisada.
`checked`	boolean	Indica si el elemento se revisó correctamente.
`flagged`	boolean	Indica si el elemento revisado coincidió con el tipo de detección solicitado.
`level`	string	Nivel de riesgo: `"none"`, `"low"`, `"medium"` o `"high"`.
`score`	number	Puntuación de detección. Use `level` para mostrarla.

Notas de resultado

Si checked es false, la imagen no se revisó correctamente. En ese caso, score puede ser 0 y level puede ser "none", pero la imagen debe tratarse como un fallo de detección y no como un resultado sin riesgo.
flagged solo describe el resultado de detección después de que una imagen se haya revisado.
data.flagged es true cuando al menos una imagen revisada correctamente está marcada.
level es el nivel de riesgo apto para visualización derivado de la puntuación de detección.

Manejo de errores

Si la solicitud falla, la API devuelve un code distinto de cero o un estado HTTP que no es 2xx. Revise el campo message para obtener detalles.