Clean Songs Textanalyse

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

Wählen Sie die zu prüfenden Kategorien aus, fügen Sie benutzerdefinierte Begriffe hinzu und markieren Sie Phrasen für die manuelle Prüfung. Die Ergebnisse enthalten eine Klassifizierung, minimale übereinstimmende Belege, Zeilennummern und ein versioniertes Regelwerk.

Authentifizierung

Senden Sie Ihren Oanor-Abonnement-Schlüssel im Anfrage-Header:

x-oanor-key: YOUR_OANOR_API_KEY

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

Endpunkte

Text analysieren

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

Anfragefelder

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

Ersetzen Sie 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 Anfrage-Body: 65.536 Bytes.
• Maximal zurückgegebene Befunde: 200. Weitere Befunde setzen truncated auf true; gekürzte Ergebnisse werden niemals genehmigt.
• Ratenlimits und monatliche Kontingente hängen von Ihrem Abonnementplan ab.
• Antworten verwenden Cache-Control: no-store.

Beachten Sie, sofern angegeben, den Retry-After-Header, bevor Sie es erneut versuchen.

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.

Übermitteln Sie nur Inhalte, für deren Nutzung Sie die erforderlichen Rechte und Berechtigungen besitzen. 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 Normalisierung von Groß-/Kleinschreibung und Akzenten sowie Wortstammbildung. Sie interpretiert Absicht, Ironie, Verneinung oder eine 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 urheberrechtliche Freigabe. Nutzen Sie die manuelle Prüfung für mehrdeutige oder sensible Entscheidungen.