CaptchaAI Schnellstart: Ihre erste CAPTCHA-Lösung in 5 Minuten

Diese Anleitung verfolgt ein einziges Ziel: Sie so schnell wie möglich vom Nullpunkt zum ersten erfolgreichen API-Aufruf und einem gelösten Token zu führen. Keine Theorie, keine Umwege — nur die Mindestschritte und lauffähiger Code.

Alle von CaptchaAI unterstützten CAPTCHA-Typen folgen demselben vierstufigen Muster:

1. Senden — die CAPTCHA-Daten an in.php schicken
2. Task-ID speichern aus der Antwort
3. Pollen — alle 5 Sekunden res.php abfragen, bis das Ergebnis fertig ist
4. Token verwenden — auf der Zielseite oder im Request einfügen

Schritt 0: API-Schlüssel besorgen

1. Auf captchaai.com registrieren
2. Ihr Dashboard öffnen
3. Den 32-stelligen API-Schlüssel kopieren

Ihr Konto benötigt aktive Threads, um Tasks zu senden. Beim Evaluieren des Dienstes können Sie Test-Threads beim Support anfragen.

Schritt 1: ein CAPTCHA senden

Das Beispiel löst ein Cloudflare Turnstile — einen der häufigsten Typen. Sie benötigen zwei Werte von der Zielseite:

• sitekey — der öffentliche Schlüssel des Turnstile-Widgets (Attribut data-sitekey oder Turnstile-Skriptparameter, beginnt mit 0x)
• pageurl — die vollständige URL der Seite, auf der das Widget geladen wird

cURL

curl -X POST "https://ocr.captchaai.com/in.php" \
  -d "key=YOUR_API_KEY" \
  -d "method=turnstile" \
  -d "sitekey=0x4AAAAAAAC3DHQFLr1GavNl" \
  -d "pageurl=https://example.com/login" \
  -d "json=1"

Python

import requests

response = requests.post("https://ocr.captchaai.com/in.php", data={
    "key": "YOUR_API_KEY",
    "method": "turnstile",
    "sitekey": "0x4AAAAAAAC3DHQFLr1GavNl",
    "pageurl": "https://example.com/login",
    "json": 1,
})
print(response.json())

Node.js

const response = await fetch("https://ocr.captchaai.com/in.php", {
  method: "POST",
  headers: { "Content-Type": "application/x-www-form-urlencoded" },
  body: new URLSearchParams({
    key: "YOUR_API_KEY",
    method: "turnstile",
    sitekey: "0x4AAAAAAAC3DHQFLr1GavNl",
    pageurl: "https://example.com/login",
    json: "1",
  }),
});
console.log(await response.json());

PHP

<?php
$response = file_get_contents("https://ocr.captchaai.com/in.php?" . http_build_query([
    "key"       => "YOUR_API_KEY",
    "method"    => "turnstile",
    "sitekey"   => "0x4AAAAAAAC3DHQFLr1GavNl",
    "pageurl"   => "https://example.com/login",
    "json"      => 1,
]));
echo $response;

Schritt 2: Task-ID sichern

Erfolgsantwort:

{
  "status": 1,
  "request": "71823469"
}

Das Feld request ist Ihre Task-ID — Sie benötigen sie, um das Ergebnis abzurufen.

Wenn status 0 ist, ist etwas schiefgelaufen. Der Fehlercode steht in request:

Schritt 3: Ergebnis pollen

Erst 15 Sekunden warten, dann alle 5 Sekunden abfragen, bis ein Ergebnis vorliegt.

Python

import time

time.sleep(15)

while True:
    result = requests.get("https://ocr.captchaai.com/res.php", params={
        "key": "YOUR_API_KEY",
        "action": "get",
        "id": "71823469",
        "json": 1,
    }).json()

    if result.get("request") == "CAPCHA_NOT_READY":
        time.sleep(5)
        continue

    if result.get("status") == 1:
        token = result["request"]
        print(f"Solved! Token: {token[:60]}...")
        break

    raise RuntimeError(result)

Node.js

await new Promise((r) => setTimeout(r, 15000));

while (true) {
  const r = await fetch(
    `https://ocr.captchaai.com/res.php?key=YOUR_API_KEY&action=get&id=71823469&json=1`,
  );
  const data = await r.json();
  if (data.request === "CAPCHA_NOT_READY") {
    await new Promise((r) => setTimeout(r, 5000));
    continue;
  }
  if (data.status === 1) {
    console.log("Solved:", data.request.slice(0, 60));
    break;
  }
  throw new Error(JSON.stringify(data));
}

Schritt 4: Token verwenden

Die Injektionsweise hängt vom CAPTCHA-Typ ab:

• Turnstile / reCAPTCHA: in cf-turnstile-response bzw. g-recaptcha-response schreiben oder den Callback der Seite aufrufen.
• Bild-OCR: erkannten Text ins Antwort-Input setzen.
• GeeTest / FunCaptcha: die zurückgegebenen Felder gemäß Site-Vorgaben zusammensetzen.

Minimaler Browser-Aufruf:

document.querySelector('[name="cf-turnstile-response"]').value = token;
document.querySelector("form").submit();

Häufige Anfangsfehler

• Leerzeichen im API-Schlüssel — entfernen.
• Fehlendes Protokoll in pageurl — muss https://... sein.
• Zu früher erster Poll — 15 Sekunden warten.
• Zu häufiges Pollen — alle 5 s reichen aus.
• Threads ausgeschöpft — siehe API-Fehlercodes und Ihren Plan.

Nächste Schritte

Weiter geht es nach dem CAPTCHA-Typ, der Ihnen am häufigsten begegnet:

• reCAPTCHA v2 per API lösen
• Cloudflare Turnstile per API lösen
• GeeTest v3 per API lösen
• Bild-CAPTCHA per API lösen

Holen Sie Ihren API-Schlüssel auf captchaai.com/api.php und schließen Sie Ihre erste erfolgreiche Lösung in unter 5 Minuten ab.