API-Referenz

HumanizerAI API

Integrieren Sie KI-Erkennung und Humanisierung in Ihre Anwendungen mit unserer einfachen REST API.

Schnellstart

API-Schlüssel erhalten

Klicken Sie auf Ihr Profilbild → Einstellungen → API-Schlüssel. Erfordert Pro- oder Business-Plan.

Autorisierung hinzufügen

Fügen Sie Ihren API-Schlüssel als Bearer token im Authorization-Header ein.

Anfragen senden

Rufen Sie die Detect- oder Humanize-Endpunkte mit Ihrem Textinhalt auf.

Authentifizierung

Alle API-Anfragen erfordern eine Authentifizierung mit einem API-Schlüssel. Fügen Sie Ihren Schlüssel als Bearer token im Authorization-Header ein:

Authorization: Bearer hum_your_api_key_here

Halten Sie Ihren API-Schlüssel sicher

Geben Sie Ihren API-Schlüssel niemals in clientseitigem Code oder öffentlichen Repositories preis. Verwenden Sie Umgebungsvariablen.

Basis-URL

https://humanizerai.com/api/v1

POST

/detect

Analysieren Sie Text, um zu erkennen, ob er von KI geschrieben wurde. Gibt einen Score von 0-100 zurück (höher = wahrscheinlicher KI) zusammen mit detaillierten Metriken.

Anfragekörper

Parameter	Typ	Erforderlich	Beschreibung
text	string		Der zu analysierende Text (max. 10.000 Wörter)

Beispielanfrage

curl -X POST https://humanizerai.com/api/v1/detect \
  -H "Authorization: Bearer hum_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Your text to analyze for AI detection..."
  }'

Antwort

{
  "score": 85,
  "metrics": {
    "perplexity": 42.5,
    "burstiness": 0.35,
    "readability": 65.2,
    "satPercent": 12.5,
    "simplicity": 78.3,
    "ngramScore": 0.15,
    "averageSentenceLength": 18.4
  },
  "verdict": "likely_ai",
  "wordsProcessed": 250
}

POST

/humanize

Verwandeln Sie KI-generierten Text in natürlichen, menschenähnlichen Inhalt, der KI-Detektoren umgeht. Verbraucht Credits basierend auf der Wortzahl.

Anfragekörper

Parameter	Typ	Erforderlich	Beschreibung
text	string		Der zu humanisierende Text (max. 10.000 Wörter)
intensity	string	Optional	`light`, `medium` ((Standard)), `aggressive` (bypass)

Intensitätsstufen

Leicht

light

Subtile Änderungen, bewahrt Ihren Stil. Am besten für Text mit niedrigen KI-Scores.

Mittel

medium(Standard)

Ausgewogene Umschreibungen mit menschlichen Akzenten. Am besten für die meisten Anwendungsfälle.

Umgehung

aggressive

Maximale Detektor-Umgehung. Text wird kürzer und einfacher.

Beispielanfrage

curl -X POST https://humanizerai.com/api/v1/humanize \
  -H "Authorization: Bearer hum_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Your AI-generated text to humanize...",
    "intensity": "medium"
  }'

Antwort

{
  "humanizedText": "The rewritten text that sounds human...",
  "score": {
    "before": 85,
    "after": 15
  },
  "wordsProcessed": 250,
  "credits": {
    "subscriptionRemaining": 49750,
    "topUpRemaining": 0,
    "totalRemaining": 49750
  }
}

GET

/credits

Prüfen Sie Ihr aktuelles Guthaben. Gibt Abonnement-Credits, Auflade-Credits und verfügbares Gesamtguthaben zurück.

Beispielanfrage

curl https://humanizerai.com/api/v1/credits \
  -H "Authorization: Bearer hum_your_api_key"

Antwort

{
  "credits": {
    "subscription": 45000,
    "topUp": 5000,
    "total": 50000
  },
  "plan": "pro",
  "billingCycleEnd": "2025-02-15T00:00:00.000Z"
}

Fehlercodes

Status	Nachricht	Beschreibung
400	Text ist erforderlich	Fehlender oder leerer Textparameter
400	Text überschreitet Maximum	Text überschreitet das Limit von 10.000 Wörtern
401	API-Schlüssel erforderlich	Fehlender Authorization-Header
401	Ungültiger oder widerrufener API-Schlüssel	API-Schlüssel nicht gefunden oder wurde widerrufen
403	API-Zugang erfordert Pro/Business	Der Plan des Benutzers beinhaltet keinen API-Zugang
403	insufficient_credits	Nicht genügend Credits für die Humanisierung
500	Serverfehler	Interner Serverfehler

Ratenlimits

Plan	API-Schlüssel	Ratenlimit	Max. Wörter/Anfrage
Pro	Bis zu 3	60 Anfragen/Minute	10,000
Business	Bis zu 10	300 Anfragen/Minute	10,000

MCP Server

Der MCP-Server (Model Context Protocol) gibt Claude Desktop direkten Zugriff auf KI-Erkennung und Humanisierung. Bitten Sie Claude, Text zu prüfen oder zu humanisieren, ohne Ihr Gespräch zu verlassen.

MCP-Server installieren

npm install -g @humanizerai/mcp-server

Claude Desktop-Konfiguration öffnen

Öffnen Sie die Konfigurationsdatei unter:

# macOS
~/Library/Application Support/Claude/claude_desktop_config.json

# Windows
%APPDATA%\Claude\claude_desktop_config.json

HumanizerAI zur Konfiguration hinzufügen

Fügen Sie dies zu Ihrer claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "humanizerai": {
      "command": "humanizerai-mcp",
      "env": {
        "HUMANIZERAI_API_KEY": "hum_your_api_key"
      }
    }
  }
}

Claude Desktop neu starten

Beenden und öffnen Sie Claude Desktop erneut. Sie können Claude jetzt bitten, Text zu erkennen oder zu humanisieren!

Verfügbare Tools

detect_ai

Prüfen, ob Text KI-generiert ist

humanize

KI-Text in menschenähnlichen Text umwandeln

check_credits

Verbleibendes Guthaben anzeigen

Agent Skills

Auf GitHub ansehen

Agent Skills ermöglichen es Ihnen, KI-Text direkt von Ihrem Terminal aus mit einfachen Slash-Befehlen zu erkennen und zu humanisieren. Funktioniert mit Claude Code, Cursor, Windsurf und jedem Agenten, der das Agent Skills-Format unterstützt.

Skill installieren

Option 1: /learn-Befehl (empfohlen)

/learn @humanizerai/humanize

Option 2: Claude Code Plugin-Marktplatz

# In Claude Code, run:
/plugin marketplace add humanizerai/agent-skills
/plugin install detect-ai@humanizerai
/plugin install humanize@humanizerai

Option 3: Von GitHub klonen

git clone https://github.com/humanizerai/agent-skills.git .claude/skills/humanizerai

API-Schlüssel festlegen

export HUMANIZERAI_API_KEY="hum_your_api_key"

Skills verwenden

Führen Sie diese Befehle in Ihrer Agenten-Sitzung aus:

Verfügbare Befehle

/detect-ai [text]

Text analysieren und KI-Erkennungsscore mit detaillierten Metriken erhalten

/humanize [text]

KI-Text umwandeln, um Detektoren zu umgehen (verwendet mittlere Intensität)

/humanize --intensity aggressive [text]

Maximaler Bypass-Modus für hartnäckigen KI-Inhalt

Kompatible Agenten

AMP

Und jeder Agent, der das offene Agent Skills-Format unterstützt.

Bereit loszulegen?

Registrieren Sie sich, um Ihren API-Schlüssel zu erstellen und KI-Erkennung und Humanisierung zu integrieren.