# YesCaptcha Docs

> YesCaptcha ist eine Captcha-Erkennungs-API. Über eine JSON-Schnittstelle lösen Sie reCAPTCHA, hCaptcha, Cloudflare Turnstile, FunCaptcha, AWS WAF und Bild-Captchas. Abgerechnet wird per Punkteabzug pro Aufgabe, bei Fehlschlägen und Zeitüberschreitungen erfolgt automatisch eine Punkteerstattung.

These pages are machine-translated from Chinese; the Chinese version prevails.

- Home: https://docs.yescaptcha.com/de/index.md
- OpenAPI 3.1: https://docs.yescaptcha.com/openapi.json
- Data (JSON): https://docs.yescaptcha.com/data/task-types.json, https://docs.yescaptcha.com/data/error-codes.json, https://docs.yescaptcha.com/data/vip-levels.json
- Full text: https://docs.yescaptcha.com/de/llms-full.txt

## Erste Schritte

- [Einführung](https://docs.yescaptcha.com/de/getting-started/introduction.md): Was YesCaptcha ist: reCAPTCHA, hCaptcha, Turnstile, FunCaptcha und Bild-Captchas per API oder Browser-Erweiterung lösen, Abrechnung pro Aufgabe, bei Fehlschlag automatische Punkteerstattung.
- [Schnellstart](https://docs.yescaptcha.com/de/getting-started/quickstart.md): Senden Sie in 5 Minuten Ihre erste YesCaptcha-Anfrage: registrieren, ClientKey kopieren, Guthaben aufladen und dann mit curl, Python oder Node.js ein Bild-Captcha erkennen (ImageToTextTaskOcrBase, synchrone Antwort, 2 Punkte pro Aufgabe).
- [Endpoints](https://docs.yescaptcha.com/de/getting-started/endpoints.md): Die zwei Endpoints der YesCaptcha API, der globale api.yescaptcha.com und der China-Endpoint cn.yescaptcha.com. Nur HTTPS POST mit JSON; Aufgaben werden auf demselben Endpoint erstellt und abgefragt.
- [Abrechnung und Punkteerstattung](https://docs.yescaptcha.com/de/getting-started/billing.md): So rechnet YesCaptcha ab. 1,000 Punkte = ¥1, pro Aufgabentyp wird ein fester Preis abgezogen; bei fehlgeschlagener Erkennung und Timeout erfolgt automatisch eine Punkteerstattung, Anfragen mit Fehlerantwort kosten nichts; das Guthaben muss über 10 Punkten liegen; bei gemeldeten Fehlern der Bilderkennung erfolgt die Erstattung nach etwa 24 Stunden.

## API-Referenz

- [Anfragen und Antworten](https://docs.yescaptcha.com/de/api/overview.md): Allgemeine Konventionen der YesCaptcha API: POST mit JSON, Authentifizierung per clientKey, Antwortformat mit errorId, synchrone und asynchrone Aufgaben, Abfrage alle 5 Sekunden, Timeout nach 110 Sekunden, Ergebnisse etwa 10 Minuten gespeichert, Sprache der Hinweise nach Accept-Language.
- [createTask – Aufgabe erstellen](https://docs.yescaptcha.com/de/api/create-task.md): POST /createTask erstellt eine Captcha-Aufgabe: Anfragefelder (clientKey, task, softID), Reihenfolge der Prüfungen, asynchrone Typen liefern eine taskId, synchrone Typen direkt die solution; das Guthaben muss über 10 Punkten liegen.
- [getTaskResult – Ergebnis abrufen](https://docs.yescaptcha.com/de/api/get-task-result.md): POST /getTaskResult liefert das Ergebnis einer asynchronen Aufgabe. Fragen Sie alle 5 Sekunden ab, warten Sie bei processing weiter, lesen Sie bei ready die solution und beenden Sie die Abfrage bei Fehlern; Aufgaben laufen bis zu etwa 110 Sekunden, Ergebnisse bleiben etwa 10 Minuten erhalten, Abfragen kosten keine Punkte.
- [getBalance – Guthaben abfragen](https://docs.yescaptcha.com/de/api/get-balance.md): POST /getBalance liefert das Guthaben des Kontos in Punkten (1,000 Punkte = ¥1) sowie das Guthaben aus Entwicklerbeteiligung und Empfehlungsprämien. Kein Punkteabzug; geeignet, um den ClientKey zu prüfen.
- [getSoftID – Entwickler-ID abfragen](https://docs.yescaptcha.com/de/api/get-soft-id.md): POST /getSoftID gibt Ihre Entwickler-ID (softID) und die aufgelaufene Entwicklerbeteiligung zurück. Tragen Sie die softID in die createTask-Anfragen ein, die Ihre Software für andere Nutzer sendet, um eine Beteiligung zu erhalten.
- [report – Ergebnisse melden](https://docs.yescaptcha.com/de/api/report.md): POST /report meldet, ob die Ergebnisse von Aufgaben korrekt waren; bitte melden Sie Erfolge und Fehler wahrheitsgemäß. Bei Bilderkennungstypen müssen Fehler innerhalb von 1 Stunde nach Erstellung der Aufgabe gemeldet werden, die Erstattung wird nach etwa 24 Stunden abgerechnet.
- [useragent – User-Agent abrufen](https://docs.yescaptcha.com/de/api/useragent.md): GET https://api.yescaptcha.com/useragent gibt den aktuell empfohlenen Browser-User-Agent zurück (reiner Text). Das Feld userAgent bei hCaptcha-Aufgaben akzeptiert nur diesen Wert.
- [Fehlercodes](https://docs.yescaptcha.com/de/api/errors.md): Alle Fehlercodes der YesCaptcha API mit Bedeutung und Vorgehen: Anfrageformat, Konto und Guthaben, gleichzeitige Aufgaben und Pausierung, Aufgabenergebnis, Website-Parameter, Bilder, Proxy, Server. Anfragen, die einen Fehler zurückgeben, werden nicht berechnet.
- [Limit gleichzeitiger Aufgaben und automatische Pausierung](https://docs.yescaptcha.com/de/api/rate-limits.md): Das Limit gleichzeitiger Aufgaben bei YesCaptcha (ERROR_THREADS_MAXIMUM, kein Punkteabzug, keine Pausierung), die automatische Pausierung bei zu vielen Fehlern (100 pro Minute führen zu 5 Minuten Pause, ERROR_IP_BLOCKED_5MIN) und der Cache für ungültige Parameter (cached).

## Aufgabentypen

- [Aufgabentypen und Preise](https://docs.yescaptcha.com/de/tasks.md): Preise (Punkte, 1,000 Punkte = ¥1) und Rückgabeart aller öffentlichen YesCaptcha-Aufgabentypen: Token für reCAPTCHA, hCaptcha und Turnstile, Cookies für die Cloudflare-Prüfseite sowie Erkennungsergebnisse für Bild-zu-Text und Bilderkennung.
- [reCAPTCHA v2](https://docs.yescaptcha.com/de/tasks/recaptcha-v2.md): Mit YesCaptcha ein reCAPTCHA-v2-Token (Standard, unsichtbar, Enterprise) erhalten: Aufgabentypen und Preise, Anfrageparameter, Beispiele in curl/Python/Node.js und Ergebnisformat.
- [reCAPTCHA v3](https://docs.yescaptcha.com/de/tasks/recaptcha-v3.md): Mit YesCaptcha reCAPTCHA-v3-Tokens (auch Enterprise) abrufen: wie Sie pageAction ausfüllen, die Typen mit festem Score 0.7 und 0.9, Aufgabentypen und Preise, Parameter, Beispiele und Ergebnisformat.
- [hCaptcha](https://docs.yescaptcha.com/de/tasks/hcaptcha.md): hCaptcha-Token mit YesCaptcha abrufen: HCaptchaTaskProxyless, HCaptchaTaskProxylessM1 und HCaptchaTask mit eigenem Proxy, wie Sie userAgent und rqdata füllen und wie Sie den zurückgegebenen respKey verwenden.
- [Cloudflare Turnstile](https://docs.yescaptcha.com/de/tasks/turnstile.md): Cloudflare-Turnstile-Tokens mit YesCaptcha abrufen: TurnstileTaskProxyless, TurnstileTaskProxylessM1 und TurnstileTask mit eigenem Proxy, Parameter, Beispiele und Ergebnisformat sowie der Unterschied zur Cloudflare-Prüfseite.
- [Cloudflare-Prüfseite](https://docs.yescaptcha.com/de/tasks/cloudflare-challenge.md): Mit YesCaptcha die "Just a moment..."-Prüfseite von Cloudflare passieren und cf_clearance sowie weitere Cookies, den User-Agent und den Seiteninhalt erhalten: Parameter von CloudFlareTaskS2 und CloudFlareTaskS3, Proxy-Anforderungen, Ergebnis, Verwendung des Ergebnisses und häufige Fehler.
- [Bilder mit Buchstaben und Ziffern erkennen](https://docs.yescaptcha.com/de/tasks/image-to-text.md): Erkennen Sie Buchstaben und Ziffern in Bildern mit YesCaptcha. ImageToTextTaskOcrBase und ImageToTextTaskMuggle liefern synchron; ImageToTextTask und ImageToTextTaskM1 arbeiten asynchron und unterstützen Groß-/Kleinschreibung, reine Ziffern, Rechenaufgaben und Längenvorgaben. Eigene Modelle sind möglich.
- [reCAPTCHA v2 Bilderkennung](https://docs.yescaptcha.com/de/tasks/recaptcha-classification.md): Erkennen Sie reCAPTCHA-v2-Bildaufgaben mit YesCaptcha (ReCaptchaV2Classification): Laden Sie ein 3x3-, 4x4- oder 1x1-Bild mit der Fragen-ID hoch und erhalten Sie die anzuklickenden Felder synchron zurück; Abrechnung nach Bildgröße, Tabelle der Fragen-IDs.
- [hCaptcha-Bilderkennung](https://docs.yescaptcha.com/de/tasks/hcaptcha-classification.md): hCaptcha-Bildaufgaben mit YesCaptcha erkennen (HCaptchaClassification): Auswahl im 3×3-Raster, Klick auf eine bestimmte Position, Ziehen an eine bestimmte Position, animierte Fragen; synchrone Antwort, kein Punkteabzug, wenn kein Ziel erkannt wird.
- [FunCaptcha-Bilderkennung](https://docs.yescaptcha.com/de/tasks/funcaptcha-classification.md): FunCaptcha-Bildaufgaben (Arkose Labs) mit YesCaptcha lösen (FunCaptchaClassification): Laden Sie das Aufgabenbild (3×2-Raster mit 6 Feldern oder ein links und rechts zusammengesetztes Pfeil-Rätsel) und die englische Frage hoch und erhalten Sie synchron, welches Bild zu wählen ist; alle Aufgabenarten werden unterstützt.
- [AWS WAF / bCaptcha Bilderkennung](https://docs.yescaptcha.com/de/tasks/aws-bcaptcha-classification.md): AWS WAF CAPTCHA und bCaptcha 3×3-Raster-Bildaufgaben mit YesCaptcha erkennen (AwsClassification, bCaptchaClassification): Laden Sie das ganze Bild und die Frage hoch und erhalten Sie synchron die Felder, die angeklickt werden müssen.

## Browser-Erweiterung

- [YesCaptcha Assistant](https://docs.yescaptcha.com/de/extension.md): YesCaptcha Assistant (Browser-Erweiterung) erkennt und klickt reCAPTCHA, hCaptcha, FunCaptcha, AWS WAF und weitere Captchas in Chrome und Firefox automatisch. Die Erweiterung ist kostenlos; abgerechnet werden die dabei genutzten API-Aufrufe per Punkteabzug. Store-Links, Installationspakete und Installationsvideos für Chrome, BitBrowser und Kiwi Browser.

## Anleitungen

- [Den Captcha-Typ bestimmen](https://docs.yescaptcha.com/de/guides/identify-captcha.md): So erkennen Sie, welches Captcha eine Seite verwendet (reCAPTCHA v2, unsichtbares v2, v3, Enterprise, hCaptcha, Cloudflare Turnstile im Unterschied zur Cloudflare-Prüfseite) und welchen YesCaptcha-Aufgabentyp Sie dafür nutzen.
- [reCAPTCHA-Parameter finden](https://docs.yescaptcha.com/de/guides/find-recaptcha-parameters.md): So finden Sie websiteKey (sitekey), websiteURL, den pageAction von v3 und die Callback-Funktion von reCAPTCHA in den Bereichen Network, Sources und Console der Entwicklertools, mit einem Skript für die automatische Suche.
- [hCaptcha-Parameter finden](https://docs.yescaptcha.com/de/guides/find-hcaptcha-parameters.md): So finden Sie den websiteKey (sitekey), die websiteURL und bei der Enterprise-Variante den rqdata von hCaptcha: Suchen Sie im Seitenquelltext nach data-sitekey oder im Network-Tab nach den Requests checksiteconfig und getcaptcha.
- [Turnstile-Parameter finden](https://docs.yescaptcha.com/de/guides/find-turnstile-parameters.md): So finden Sie den websiteKey (sitekey, beginnt mit 0x) und die websiteURL von Cloudflare Turnstile: Suchen Sie im Seitenquelltext nach data-sitekey oder turnstile.render, oder prüfen Sie im Network-Panel die Requests an challenges.cloudflare.com.
- [reCAPTCHA mit einem Token abschließen](https://docs.yescaptcha.com/de/guides/submit-recaptcha-token.md): Was Sie mit einem reCAPTCHA-Token (gRecaptchaResponse) tun: Funktionsweise, direktes Senden per Request (Feld g-recaptcha-response), Eintragen im Browser und Aufruf der Callback-Funktion, mit vollständigem Python-Beispiel auf der Google-Demoseite.
- [reCAPTCHA-v2-Bilderkennung: Klicks simulieren mit Selenium](https://docs.yescaptcha.com/de/guides/recaptcha-click-selenium.md): Mit Python, Selenium 4 und ReCaptchaV2Classification reCAPTCHA-v2-Bildaufgaben im Browser automatisch anklicken: Captcha auslösen, Frage und Bild auslesen, Erkennungs-API aufrufen, Felder anklicken, absenden; vollständiger Beispielcode.
- [hCaptcha-Bilderkennung per Klick-Simulation (Selenium)](https://docs.yescaptcha.com/de/guides/hcaptcha-click-selenium.md): Mit Python, Selenium 4 und HCaptchaClassification hCaptcha-Aufgaben mit 3×3-Raster im Browser automatisch lösen: Kontrollkästchen anklicken, Frage und 9 Bilder auslesen, die Erkennungs-API aufrufen, klicken und absenden – mit vollständigem Beispielcode.

## Codebeispiele

- [Codebeispiele und SDKs](https://docs.yescaptcha.com/de/samples.md): Lauffähige YesCaptcha-Codebeispiele (Python, Node.js, curl, C#, Easy Language) und inoffizielle Community-SDKs (Python, Node.js, Go).
- [Python](https://docs.yescaptcha.com/de/samples/python.md): YesCaptcha Python-Beispiele: Guthaben abfragen, Bild-Captcha lösen, wiederverwendbare Client-Klasse (Aufgabe erstellen, alle 5 Sekunden abfragen), Steuerung gleichzeitiger Aufgaben mit asyncio sowie reCAPTCHA-Übermittlung mit requests und Selenium.
- [Node.js](https://docs.yescaptcha.com/de/samples/nodejs.md): YesCaptcha-Beispiele für Node.js (Node.js 18+ mit dem integrierten fetch, ohne Abhängigkeiten): Guthaben abfragen, ein Bild-Captcha erkennen und eine wiederverwendbare Client-Klasse (Aufgabe erstellen, alle 5 Sekunden abfragen).
- [C#](https://docs.yescaptcha.com/de/samples/csharp.md): YesCaptcha C#-Beispiel (.NET 6+, HttpClient und System.Text.Json). Fragt das Guthaben ab, erstellt eine reCAPTCHA-v2-Aufgabe und fragt das Ergebnis alle 5 Sekunden ab.
- [Easy Language (易语言)](https://docs.yescaptcha.com/de/samples/easy-language.md): Von Nutzern bereitgestellte YesCaptcha-Beispiele in Easy Language (易语言): Klicksimulation für reCAPTCHA und hCaptcha, Bilderkennung für FunCaptcha, Übermittlung von reCAPTCHA-Tokens; Downloads und wichtige Hinweise zum Aufruf der API.

## Konto

- [Mehrere ClientKeys: Limit, IP-Whitelist und Ablaufdatum](https://docs.yescaptcha.com/de/account/client-keys.md): Ein YesCaptcha-Konto kann bis zu 20 ClientKeys haben, die alle vom selben Konto-Guthaben abbuchen. Jeder kann ein eigenes Ausgabenlimit (pro Tag, Woche oder Monat oder einmalig, Zurücksetzung nach Pekinger Zeit), eine IP-Whitelist und ein Ablaufdatum haben, wirksam innerhalb weniger Sekunden.
- [Aufladung und VIP](https://docs.yescaptcha.com/de/account/recharge.md): So laden Sie Ihr YesCaptcha-Guthaben auf (WeChat Pay, Alipay, PayPal, Kryptowährung); 1,000 Punkte = ¥1. Mit Ihrer kumulierten Aufladung steigen Sie automatisch von VIP 1 bis VIP 10 auf, danach erhält jede Aufladung anteilig Bonuspunkte.
- [Empfehlungsprämie](https://docs.yescaptcha.com/de/account/referral.md): YesCaptcha-Empfehlungsprämie: Eingeladene Nutzer erhalten bei der Registrierung eine VIP-Stufe (Ihre Stufe minus 1, von VIP 1 bis VIP 6), und Sie erhalten 20 % der Ausgaben der eingeladenen Person (bei gleichzeitiger Entwicklerbeteiligung je 10 %). Die Prämie können Sie in Guthaben umwandeln oder ab ¥100 im Dashboard auszahlen lassen.
- [Entwicklerbeteiligung](https://docs.yescaptcha.com/de/account/developer.md): YesCaptcha Entwicklerbeteiligung: Senden Sie in den Anfragen Ihrer Software oder Erweiterung Ihre softID mit und erhalten Sie 20 % der Ausgaben der Nutzer (10 % für Sie und 10 % für den Einladenden, falls es einen gibt). Sie können den Betrag in Guthaben umwandeln oder ab ¥100 im Dashboard auszahlen lassen.

## Hilfe

- [Häufige Fragen](https://docs.yescaptcha.com/de/help/faq.md): Häufige Fragen zu YesCaptcha: Kosten bei fehlgeschlagener Erkennung, Gültigkeit von Tokens, Erfolgsquote, menschliche oder maschinelle Erkennung, Kontosperrung, ein ClientKey an mehreren Stellen, Wahl des Endpoints, Erweiterung und API im Vergleich.
- [Verbindungsprobleme](https://docs.yescaptcha.com/de/help/troubleshooting.md): Was tun, wenn die YesCaptcha API nicht erreichbar ist: Schritte zur Fehlersuche bei Failed to establish a new connection, DNS-Fehlern, Störungen durch Proxy-Software und SSL-Zertifikatsfehlern (Certificate has expired, SSLEOFError).
- [Kontakt](https://docs.yescaptcha.com/de/help/contact.md): Kontaktieren Sie den YesCaptcha-Support per WeChat, QQ, WhatsApp, LINE, Telegram @yescaptcha_official oder E-Mail yescaptcha@gmail.com, erreichbar 9:00–21:00 Uhr UTC+8.
- [Service-Änderungsprotokoll](https://docs.yescaptcha.com/de/changelog.md): Änderungen, die YesCaptcha-Nutzer betreffen, nach Datum: neue und eingestellte Aufgabentypen, Abrechnungs- und Erstattungsregeln, Limit gleichzeitiger Aufgaben, Umzug der Dokumentation. Erfasst ab Oktober 2026.

## Other languages

- [简体中文](https://docs.yescaptcha.com/zh/llms.txt)
- [English](https://docs.yescaptcha.com/en/llms.txt)
- [日本語](https://docs.yescaptcha.com/ja/llms.txt)
- [한국어](https://docs.yescaptcha.com/ko/llms.txt)
- [Русский](https://docs.yescaptcha.com/ru/llms.txt)
- [Español](https://docs.yescaptcha.com/es/llms.txt)
- [Português](https://docs.yescaptcha.com/pt/llms.txt)
- [Tiếng Việt](https://docs.yescaptcha.com/vi/llms.txt)
- [Français](https://docs.yescaptcha.com/fr/llms.txt)
- [Türkçe](https://docs.yescaptcha.com/tr/llms.txt)
- [Bahasa Indonesia](https://docs.yescaptcha.com/id/llms.txt)
- [ไทย](https://docs.yescaptcha.com/th/llms.txt)