Análisis de texto de Clean Songs

Una API determinista para comprobar el texto proporcionado por el cliente en portugués e inglés en busca de blasfemias, referencias a drogas, violencia y contenido sexual explícito.

Selecciona las categorías que deseas comprobar, añade términos personalizados y marca frases para revisión humana. Los resultados incluyen una clasificación, evidencia mínima coincidente, números de línea y un conjunto de reglas versionado.

Autenticación

Envía tu clave de suscripción de Oanor en el encabezado de la solicitud:

x-oanor-key: YOUR_OANOR_API_KEY

Usa la URL de la puerta de enlace que se muestra en la ficha de Oanor de esta API.

Endpoints

Analizar texto

Envía un cuerpo JSON con el encabezado Content-Type: application/json.

{
  "text": "What a peaceful day.",
  "language": "en",
  "rules": [
    "profanity",
    "drugs",
    "violence",
    "sexual_content"
  ],
  "custom_terms": [],
  "review_contexts": []
}

Campos de la solicitud

Cada lista opcional acepta hasta 20 términos, con un máximo de 80 caracteres por término. Los campos desconocidos se rechazan.

Ejemplo de respuesta

{
  "status": "approved",
  "rule_version": "text-1.0/rules-2026.2",
  "language": "en",
  "violations": [],
  "summary": "No matches found for the selected rules.",
  "truncated": false
}

Estados del resultado

• approved — No se encontraron coincidencias con las reglas seleccionadas.
• rejected — Se encontró una coincidencia de una categoría explícita o de un término personalizado.
• review_required — Los términos ambiguos o las frases de revisión requieren evaluación humana.

Los hallazgos incluyen rule, severity, evidence, line, reason y confidence. La evidencia se limita al token o la frase coincidente, hasta 160 caracteres. Los números de línea empiezan en 1.

Los valores de confianza son puntuaciones fijas del detector, no probabilidades calibradas.

Ejemplo con curl

Sustituye YOUR_API_SLUG por el slug que se muestra en esta ficha.

curl --request POST \
  "https://api.oanor.com/YOUR_API_SLUG/v1/analyze-text" \
  --header "x-oanor-key: ${OANOR_API_KEY}" \
  --header "Content-Type: application/json" \
  --data '{
    "text": "What a peaceful day.",
    "language": "en",
    "rules": ["profanity", "drugs", "violence", "sexual_content"],
    "custom_terms": [],
    "review_contexts": []
  }'

Límites y errores

• Longitud máxima del texto: 7.000 caracteres.
• Cuerpo completo máximo de la solicitud: 65.536 bytes.
• Máximo de hallazgos devueltos: 200. Los hallazgos adicionales establecen truncated en true; los resultados truncados nunca se aprueban.
• Los límites de frecuencia y las cuotas mensuales dependen de tu plan de suscripción.
• Las respuestas usan Cache-Control: no-store.

Cuando se proporcione, respeta el encabezado Retry-After antes de reintentar.

Privacidad y derechos sobre el contenido

El backend de análisis procesa el texto enviado sin almacenarlo en una base de datos, historial ni caché de resultados. Los registros de la aplicación excluyen el contenido enviado y las credenciales. Las políticas de metadatos de la puerta de enlace y del alojamiento son independientes.

Envía únicamente contenido sobre el que tengas los derechos y permisos necesarios para usarlo. Esta API no busca, recupera ni proporciona letras de canciones, y una suscripción no otorga derechos sobre contenido de terceros.

Limitaciones importantes

La clasificación usa reglas léxicas, incluida la normalización de mayúsculas y acentos y la derivación de palabras. No interpreta de forma fiable la intención, la ironía, la negación ni el significado más amplio.

Un resultado approved significa que no se detectaron señales con las reglas seleccionadas. No es una garantía de seguridad, idoneidad, legalidad ni de ausencia de derechos de autor. Usa la revisión humana para decisiones ambiguas o sensibles.