Clean Songs Textanalyse

Eine deterministische API zum Prüfen von vom Kunden bereitgestelltem Text in Portugiesisch und Englisch auf Obszönitäten, Drogenbezüge, Gewalt und explizite sexuelle Inhalte.

Wähle die zu prüfenden Kategorien aus, füge benutzerdefinierte Begriffe hinzu und markiere Phrasen für die manuelle Prüfung. Die Ergebnisse enthalten eine Klassifizierung, minimale übereinstimmende Belege, Zeilennummern und ein versioniertes Regelset.

Authentifizierung

Sende deinen Oanor-Abonnement-Key im Request-Header:

x-oanor-key: YOUR_OANOR_API_KEY

Verwende die Gateway-URL, die im Oanor-Eintrag dieser API angezeigt wird.

Endpunkte

Text analysieren

Sende einen JSON-Body mit dem Header Content-Type: application/json.

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

Request-Felder

Jede optionale Liste akzeptiert bis zu 20 Begriffe, mit maximal 80 Zeichen pro Begriff. Unbekannte Felder werden abgelehnt.

Beispielantwort

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

Ergebnisstatus

• approved — Unter den ausgewählten Regeln wurden keine Übereinstimmungen gefunden.
• rejected — Es wurde eine Übereinstimmung mit einer expliziten Kategorie oder einem benutzerdefinierten Begriff gefunden.
• review_required — Mehrdeutige Begriffe oder Prüfphrasen erfordern eine manuelle Bewertung.

Befunde enthalten rule, severity, evidence, line, reason und confidence. Belege sind auf das übereinstimmende Token oder die übereinstimmende Phrase beschränkt, bis zu 160 Zeichen. Zeilennummern beginnen bei 1.

Konfidenzwerte sind feste Detektor-Scores, keine kalibrierten Wahrscheinlichkeiten.

curl-Beispiel

Ersetze YOUR_API_SLUG durch den Slug, der in diesem Eintrag angezeigt wird.

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

Limits und Fehler

• Maximale Textlänge: 7.000 Zeichen.
• Maximaler vollständiger Request-Body: 65.536 Bytes.
• Maximale Anzahl zurückgegebener Befunde: 200. Weitere Befunde setzen truncated auf true; abgeschnittene Ergebnisse werden niemals genehmigt.
• Rate-Limits und monatliche Kontingente hängen von deinem Abonnementplan ab.
• Antworten verwenden Cache-Control: no-store.

Wenn vorhanden, beachte den Retry-After-Header, bevor du es erneut versuchst.

Datenschutz und Inhaltsrechte

Das Analyse-Backend verarbeitet übermittelten Text, ohne ihn in einer Datenbank, einem Verlauf oder einem Ergebnis-Cache zu speichern. Anwendungsprotokolle schließen übermittelte Inhalte und Anmeldedaten aus. Richtlinien für Gateway- und Hosting-Metadaten gelten separat.

Übermittle nur Inhalte, für deren Nutzung du die erforderlichen Rechte und Berechtigungen besitzt. Diese API sucht nicht nach Songtexten, ruft sie nicht ab und stellt sie nicht bereit, und ein Abonnement gewährt keine Rechte an Inhalten Dritter.

Wichtige Einschränkungen

Die Klassifizierung verwendet lexikalische Regeln, einschließlich Groß-/Kleinschreibungs- und Akzentnormalisierung sowie Wortstammbildung. Sie interpretiert Absicht, Ironie, Verneinung oder weitergehende Bedeutung nicht zuverlässig.

Ein approved-Ergebnis bedeutet, dass unter den ausgewählten Regeln keine Signale erkannt wurden. Es ist keine Garantie für Sicherheit, Eignung, Rechtmäßigkeit oder Urheberrechtsfreiheit. Nutze die manuelle Prüfung für mehrdeutige oder sensible Entscheidungen.