AI-Detection + Humanizer-Workflow

Suchmaschinen und Plattformen werden zunehmend empfindlich gegenüber KI-typischen Mustern: gleichförmige Satzlängen, „It's important to note", überstrukturierte Listen. Rankion gibt dir zwei Werkzeuge an die Hand — einen AI-Detector, der Text auf KI-Wahrscheinlichkeit scannt, und einen Humanizer, der ihn aktiv natürlicher macht.

Single-Shot Detection

Schnell-Check für ein einzelnes Textstück (z.B. einen frischen Absatz oder einen vom Kunden gelieferten Artikel):

curl -X POST https://rankion.ai/api/v1/ai-scanner/detect \
  -H "Authorization: Bearer DEIN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"text": "Es ist wichtig zu beachten, dass künstliche Intelligenz..."}'

Kosten: 2 Credits. Antwort liefert dir einen ai_probability (0–100) und eine sentenz-weise Heatmap, welche Sätze besonders KI-typisch wirken.

Ab ai_probability ≥ 70 solltest du humanisieren. Unter 40 ist meist okay.

Article-Humanizer

Wenn du einen kompletten Artikel (z.B. den frisch generierten aus dem AI Content Editor) durch den Humanizer schicken willst:

curl -X POST https://rankion.ai/api/v1/ai-scanner/humanize \
  -H "Authorization: Bearer DEIN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Dein kompletter Artikeltext hier...",
    "tone": "natural",
    "language": "de"
  }'

Kosten: 5 Credits. Synchron, antwortet direkt mit dem umgeschriebenen Text. Dauer: 5–15 Sekunden.

Der Humanizer variiert Satzlängen, baut Imperfektionen ein (kurze Sätze, Fragezeichen, Inversionen), tauscht typische LLM-Floskeln gegen alltagsnahe Formulierungen — und behält dabei semantische Treue.

Bulk-Humanizer (async + Batch-Polling)

Für größere Mengen (10+ Artikel, ganze Content-Pipelines) gibt es den asynchronen Bulk-Humanizer:

# Batch starten:
curl -X POST https://rankion.ai/api/v1/humanize \
  -H "Authorization: Bearer DEIN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "texts": [
      {"id": "art-1", "content": "..."},
      {"id": "art-2", "content": "..."},
      {"id": "art-3", "content": "..."}
    ],
    "tone": "natural"
  }'

Kosten: 8 Credits pro Text. Antwort: HTTP 202 mit batch_id.

Dann pollst du:

curl https://rankion.ai/api/v1/humanize/{batch_id} \
  -H "Authorization: Bearer DEIN_TOKEN"

Solange status: "processing", läuft es weiter. Bei status: "completed" ist results[] befüllt mit den humanisierten Versionen pro Input-ID. Typische Laufzeit: 30 Sekunden bis 5 Minuten je nach Batch-Größe.

Nicht unterstützte Sprache

AI-Detection und Humanizer verstehen Deutsch, Englisch, Spanisch und Französisch. Gibst du Text in einer anderen Sprache ein, zum Beispiel Polnisch, startet der Scanner in der Oberfläche gar nicht erst und zeigt dir stattdessen einen Hinweis — es fallen keine Credits an. Über die API antwortet POST /api/v1/ai-scanner/detect ohne gesetzten language-Parameter mit 422 und nennt die erkannte Sprache (detected_language) sowie die unterstützten Codes. Schickst du so einen Text an den Humanizer, bricht er das Dokument mit dem Status „fehlgeschlagen" ab: der Text bleibt unverändert, auch hier fallen keine Credits an.

Wann nutzen — wann lassen

Nutzen, wenn:

• Artikel direkt aus AI Content Editor kommt und auf Money-Pages publishing-ready werden soll
• Texte auf Plattformen mit AI-Detection (Universitäten, manche Marketplaces) eingereicht werden
• Du eine Content-Reihe mit konsistent natürlicher Stimme bauen willst

Nicht nutzen, wenn:

• Text bereits manuell überarbeitet wurde — Humanizer kann dann Stilbrüche einführen
• Es um stark technische / faktische Inhalte geht (Code, Zahlen, Definitionen) — der Humanizer kann lockern, was nicht gelockert gehört
• Tonalität auf „expert / formal" stehen soll — der Humanizer-Default geht Richtung umgangssprachlich

Quality-Gate vor Publish

Empfohlener Workflow für einen finalen Artikel:

1. Generieren (Erster Artikel mit dem AI Content Editor)
2. Score & Optimize (Content für Google + AI optimieren)
3. AI-Detection — ai_probability checken
4. Wenn ≥ 70 → Humanize
5. Re-Detection → muss < 40 sein
6. Manuelle Endredaktion (5 Min reichen meist)
7. Publish

Modul-Details und Limits in AI-Detector und Humanizer. API-Referenz: AI-Tools-API (Detector + Humanizer).