Ανάλυση Κειμένου Clean Songs

Ένα ντετερμινιστικό API για τον έλεγχο κειμένου που παρέχει ο πελάτης στα πορτογαλικά και τα αγγλικά για υβριστικό περιεχόμενο, αναφορές σε ναρκωτικά, βία και ρητό σεξουαλικό περιεχόμενο.

Επιλέξτε τις κατηγορίες προς έλεγχο, προσθέστε προσαρμοσμένους όρους και επισημάνετε φράσεις για ανθρώπινη εξέταση. Τα αποτελέσματα περιλαμβάνουν ταξινόμηση, ελάχιστα αποδεικτικά στοιχεία αντιστοίχισης, αριθμούς γραμμών και ένα σύνολο κανόνων με έκδοση.

Έλεγχος ταυτότητας

Στείλτε το κλειδί συνδρομής Oanor στην κεφαλίδα του αιτήματος:

x-oanor-key: YOUR_OANOR_API_KEY

Χρησιμοποιήστε τη διεύθυνση URL της πύλης που εμφανίζεται στην καταχώριση Oanor αυτού του API.

Τερματικά σημεία

Ανάλυση Κειμένου

Στείλτε ένα σώμα JSON με την κεφαλίδα Content-Type: application/json.

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

Πεδία αιτήματος

Κάθε προαιρετική λίστα δέχεται έως 20 όρους, με μέγιστο 80 χαρακτήρες ανά όρο. Τα άγνωστα πεδία απορρίπτονται.

Παράδειγμα απόκρισης

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

Καταστάσεις αποτελέσματος

• approved — Δεν βρέθηκαν αντιστοιχίσεις βάσει των επιλεγμένων κανόνων.
• rejected — Βρέθηκε αντιστοίχιση ρητής κατηγορίας ή προσαρμοσμένου όρου.
• review_required — Αμφίσημοι όροι ή φράσεις εξέτασης απαιτούν ανθρώπινη αξιολόγηση.

Τα ευρήματα περιλαμβάνουν rule, severity, evidence, line, reason και confidence. Τα αποδεικτικά στοιχεία περιορίζονται στο διακριτικό ή τη φράση αντιστοίχισης, έως 160 χαρακτήρες. Οι αριθμοί γραμμών ξεκινούν από το 1.

Οι τιμές confidence είναι σταθερές βαθμολογίες ανιχνευτή, όχι βαθμονομημένες πιθανότητες.

Παράδειγμα curl

Αντικαταστήστε το YOUR_API_SLUG με το slug που εμφανίζεται σε αυτή την καταχώριση.

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

Όρια και Σφάλματα

• Μέγιστο μήκος κειμένου: 7.000 χαρακτήρες.
• Μέγιστο πλήρες σώμα αιτήματος: 65.536 bytes.
• Μέγιστα ευρήματα που επιστρέφονται: 200. Επιπλέον ευρήματα θέτουν το truncated σε true· τα περικομμένα αποτελέσματα δεν εγκρίνονται ποτέ.
• Τα όρια ρυθμού και οι μηνιαίες ποσοστώσεις εξαρτώνται από το πρόγραμμα συνδρομής σας.
• Οι αποκρίσεις χρησιμοποιούν Cache-Control: no-store.

Όταν παρέχεται, σεβαστείτε την κεφαλίδα Retry-After πριν από την επανάληψη.

Απόρρητο και Δικαιώματα Περιεχομένου

Το backend ανάλυσης επεξεργάζεται το υποβαλλόμενο κείμενο χωρίς να το αποθηκεύει σε βάση δεδομένων, ιστορικό ή cache αποτελεσμάτων. Τα αρχεία καταγραφής της εφαρμογής εξαιρούν το υποβαλλόμενο περιεχόμενο και τα διαπιστευτήρια. Οι πολιτικές μεταδεδομένων της πύλης και της φιλοξενίας είναι ξεχωριστές.

Υποβάλετε μόνο περιεχόμενο για το οποίο έχετε τα απαραίτητα δικαιώματα και άδειες χρήσης. Αυτό το API δεν αναζητά, δεν ανακτά και δεν παρέχει στίχους τραγουδιών, και μια συνδρομή δεν παρέχει δικαιώματα σε περιεχόμενο τρίτων.

Σημαντικοί Περιορισμοί

Η ταξινόμηση χρησιμοποιεί λεξικούς κανόνες, συμπεριλαμβανομένης της κανονικοποίησης πεζών/τόνων και της αποστέλεσης λέξεων. Δεν ερμηνεύει αξιόπιστα την πρόθεση, την ειρωνεία, την άρνηση ή την ευρύτερη σημασία.

Ένα αποτέλεσμα approved σημαίνει ότι δεν ανιχνεύθηκαν σήματα βάσει των επιλεγμένων κανόνων. Δεν αποτελεί εγγύηση ασφάλειας, καταλληλότητας, νομιμότητας ή εκκαθάρισης πνευματικών δικαιωμάτων. Χρησιμοποιήστε ανθρώπινη εξέταση για αμφίσημες ή ευαίσθητες αποφάσεις.