Entwicklerdokumentation

Verfügbarkeit

Die Produktion API ist geöffnet. Erforderlich sind ein verifiziertes Konto, ein API-Schlüssel, verfügbares Guthaben und Verarbeitungskapazität. Temporäre Kapazitätsgrenzen geben vor der Verarbeitung 503 zurück; Versuchen Sie es später erneut mit derselben Anforderungskennung.

Kontakt Unterstützung bei Ihrer Integration. Aus dieser Dokumentation wird weder ein API-Kauf noch eine Anfrage getätigt.

Authentifizierung

Verwende einen Check AI-Schlüssel im Autorisierung Header von Ihrem Server. Platzieren Sie es niemals in einem Browser-Bundle, einem öffentlichen Repository oder einer Support-Nachricht. Basis-URL: https://checkai-app.com.

Authorization: Bearer YOUR_CHECKAI_API_KEY

Sobald der Zugriff aktiviert ist, können verifizierte Konten bis zu fünf aktive Schlüssel im erstellen Entwicklerkonsole. Schlüssel werden einmalig angezeigt, als Hashes gespeichert und verfallen nach einem Jahr. Rotieren Sie, indem Sie einen Ersatz erstellen und den alten Schlüssel widerrufen. Testschlüssel haben keinen Zugriff auf die Produktion. Website-Sitzungstoken sind keine Entwicklerschlüssel.

Endpunkte

Senden Sie JSON mit einem Single Text Zeichenfolge. Die Erkennung akzeptiert 30–2.000 Wörter; Die Humanisierung akzeptiert 10–2.000. Beide sind auf 20.000 Zeichen begrenzt. Wörter werden gezählt, indem zugeschnittener Text in Leerzeichen aufgeteilt wird. Uploads, Streaming und benutzerdefinierte Umschreibungseinstellungen werden nicht unterstützt.

Fordern Sie Beispiele an

Diese Beispiele erfordern eine aktivierte API und einen echten Schlüssel. Die Schaltfläche „Kopieren“ kopiert nur Text.

# Server-side request; requires a valid key and credits.
curl https://checkai-app.com/api/v1/humanize \
  -H "Authorization: Bearer YOUR_CHECKAI_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: YOUR_UNIQUE_REQUEST_ID" \
  -d '{"text":"Clear writing starts with one useful idea and a careful review."}'

Beispiel für eine Humanisierungsreaktion

{
  "request_id": "example-request-id",
  "status": "succeeded",
  "usage": {
    "input_words": 12,
    "credits": 48
  },
  "result": {
    "text": "Good writing begins with a useful idea, followed by careful editing."
  }
}

Illustrative Antwort. Die Erkennung kehrt zurück result.ai_percentage (0–100), Ergebnis.Highlights (Textpassagen) und result.explanation.

Credits und Wiederholungsversuche

Gutschriften werden vor der Bearbeitung reserviert, bei bestätigtem Erfolg verrechnet und nach bestätigter Ablehnung zurückerstattet. Bei einer mehrdeutigen Zeitüberschreitung bleibt die Reservierung zur Überprüfung erhalten. Bei Einkäufen wird dieser separate Saldo erst nach einer verifizierten Stripe-Benachrichtigung gutgeschrieben; Beim Zurücksenden vom Bezahlvorgang erfolgt keine Gutschrift auf dem Konto.

Jeder POST erfordert eine Idempotenz-Schlüssel: 16–128 Buchstaben, Ziffern, Unterstriche oder Bindestriche. Verwenden Sie eine Kennung pro logischer Anfrage. Eine identische Wiederholung gibt ohne einen zweiten Provider-Aufruf ihren gespeicherten Status zurück. Die Wiederverwendung mit anderem Text oder einem anderen Tool gibt 409 zurück.

Eine 202-Antwort enthält eine Anforderungs-ID. Überprüfen Sie es mit GET; nicht erneut unter einem neuen Schlüssel einreichen. Wenden Sie sich an den Support, wenn das Problem weiterhin aussteht. Die Ergebnisse sind sieben Tage lang verfügbar; Danach gibt eine erfolgreiche Anfrage 410 zurück und wird nie automatisch erneut übermittelt.

Nicht genutztes Guthaben verfällt nicht planmäßig und kann nicht zwischen Konten übertragen werden. Die anfallenden Steuern werden an der Kasse angezeigt. Sehen Sie sich unsere Bedingungen für Widerrufsrechte, Rückerstattungen und Serviceleistungen an.

Fehler und Grenzen

Höchstens zwei ungelöste Verarbeitungsanfragen und 30 neue Verarbeitungsanfragen pro Minute und Konto. Es gelten zusätzliche Konto-, Schlüssel- und IP-Limits. Der Anbieter fordert eine Zeitüberschreitung nach 30 Sekunden; Planen Sie in Ihrem Client mindestens 45 Sekunden ein.

202

Ausstehend oder unbestätigt – überprüfen Sie die Anfrage-ID

400 / 415

Ungültiger Text, Idempotenzschlüssel oder JSON-Inhaltstyp

401 / 403

Ungültiger Schlüssel, nicht bestätigtes oder nicht verfügbares Konto

402

Nicht genügend API Credits

409

Idempotenzkonflikt oder zwei ungelöste Anfragen

410

Gespeichertes Ergebnis abgelaufen; keine erneute Bearbeitung

429

Ratenbegrenzung – warten Sie, bevor Sie es erneut versuchen

502

Bestätigte Ablehnung; Credits zurückgegeben

503

API geschlossen, Speicher nicht verfügbar oder Verarbeitungskapazität erschöpft

Text und Privatsphäre

Für die Verarbeitung ist das Senden des übermittelten Textes an die Server von Check AI und einen externen KI-Prozessor erforderlich. Reichen Sie nur Inhalte ein, zu deren Verarbeitung Sie berechtigt sind. Geben Sie keine Geheimnisse oder unnötigen persönlichen Daten an.

Bei API-Anfragen speichert Check AI den übermittelten Eingabetext nicht. Die Ergebnisse sind sieben Tage lang verfügbar und werden durch tägliche Bereinigung entfernt. Anforderungskennungen, Fingerabdrücke, Nutzungs- und Abrechnungsdatensätze werden zur Deduplizierung und Abrechnung aufbewahrt. API Schlüssel werden als Hashes gespeichert. Durch die Kontolöschung werden Entwicklerschlüssel und -ergebnisse entfernt, vorbehaltlich der Buchhaltung und der gesetzlichen Aufbewahrung. Es wird kein Zero-Retention-Versprechen oder Service-Level-Agreement zur Betriebszeit angeboten. Siehe die Aktuelle Informationen zum Datenschutz auf der Website für den bestehenden Check AI-Dienst.

Die KI-Erkennung kann die Urheberschaft nicht mit Sicherheit feststellen. Das Umschreiben garantiert keine sachliche Richtigkeit, Originalität oder eine menschliche Klassifizierung durch einen Detektor.