Analyse de texte Clean Songs

Une API déterministe pour vérifier le texte fourni par le client en portugais et en anglais afin de détecter les grossièretés, les références aux drogues, la violence et le contenu sexuel explicite.

Sélectionnez les catégories à vérifier, ajoutez des termes personnalisés et signalez des phrases pour une revue humaine. Les résultats incluent une classification, des preuves minimales correspondantes, des numéros de ligne et un ensemble de règles versionné.

Authentification

Envoyez votre clé d'abonnement Oanor dans l'en-tête de la requête :

x-oanor-key: YOUR_OANOR_API_KEY

Utilisez l'URL de passerelle indiquée sur la fiche Oanor de cette API.

Points de terminaison

Analyser le texte

Envoyez un corps JSON avec l'en-tête Content-Type: application/json.

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

Champs de la requête

Chaque liste facultative accepte jusqu'à 20 termes, avec un maximum de 80 caractères par terme. Les champs inconnus sont rejetés.

Exemple de réponse

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

Statuts des résultats

• approved — Aucune correspondance n'a été trouvée selon les règles sélectionnées.
• rejected — Une correspondance avec une catégorie explicite ou un terme personnalisé a été trouvée.
• review_required — Des termes ambigus ou des phrases de revue nécessitent une évaluation humaine.

Les constats incluent rule, severity, evidence, line, reason et confidence. Les preuves sont limitées au jeton ou à la phrase correspondante, jusqu'à 160 caractères. Les numéros de ligne commencent à 1.

Les valeurs de confiance sont des scores de détection fixes, et non des probabilités calibrées.

Exemple curl

Remplacez YOUR_API_SLUG par le slug indiqué sur cette fiche.

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": []
  }'

Limites et erreurs

• Longueur maximale du texte : 7 000 caractères.
• Corps de requête complet maximal : 65 536 octets.
• Nombre maximal de constats renvoyés : 200. Des constats supplémentaires définissent truncated à true ; les résultats tronqués ne sont jamais approuvés.
• Les limites de débit et les quotas mensuels dépendent de votre plan d'abonnement.
• Les réponses utilisent Cache-Control: no-store.

Lorsqu'il est fourni, respectez l'en-tête Retry-After avant de réessayer.

Confidentialité et droits sur le contenu

Le backend d'analyse traite le texte soumis sans le stocker dans une base de données, un historique ou un cache de résultats. Les journaux applicatifs excluent le contenu soumis et les identifiants. Les politiques de métadonnées de la passerelle et de l'hébergement sont distinctes.

Ne soumettez que du contenu pour lequel vous disposez des droits et autorisations nécessaires. Cette API ne recherche, ne récupère ni ne fournit de paroles de chansons, et un abonnement ne confère aucun droit sur du contenu tiers.

Limitations importantes

La classification utilise des règles lexicales, notamment la normalisation de la casse et des accents ainsi que le racinisation des mots. Elle n'interprète pas de manière fiable l'intention, l'ironie, la négation ou le sens plus large.

Un résultat approved signifie qu'aucun signal n'a été détecté selon les règles sélectionnées. Ce n'est pas une garantie de sécurité, d'adéquation, de légalité ou de clairance des droits d'auteur. Utilisez une revue humaine pour les décisions ambiguës ou sensibles.