# Schnellstart

> 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).

Source: https://docs.yescaptcha.com/de/getting-started/quickstart/ · Last verified: 2026-10-15

> This page was machine-translated from the Chinese version. If anything differs, the Chinese version prevails: https://docs.yescaptcha.com/zh/getting-started/quickstart/

Diese Seite sendet die erste Anfrage mit dem einfachsten Aufgabentyp `ImageToTextTaskOcrBase` (erkennt Buchstaben und Ziffern in einem Bild). Er arbeitet synchron: Eine einzige `createTask`\-Anfrage liefert das Ergebnis. Eine Aufgabe kostet 2 Punkte (≈ $0.30 / 1k), es wird keine Seite eines Drittanbieters benötigt. So prüfen Sie am einfachsten, ob Ihr Konto und Ihr Code funktionieren.

1.  **Konto registrieren**
    
    Öffnen Sie [yescaptcha.com](https://yescaptcha.com/), registrieren Sie sich und melden Sie sich an.
    
2.  **ClientKey kopieren**
    
    Suchen Sie nach der Anmeldung im Dashboard ([yescaptcha.com/dashboard.html](https://yescaptcha.com/dashboard.html)) den Eintrag „Ihr ClientKey” und klicken Sie auf Kopieren. Kopieren Sie den vollständigen Wert.
    
    > **Achtung:** Alle API-Anfragen werden mit dem ClientKey authentifiziert. Wer ihn kennt, kann Ihr Guthaben verbrauchen. Geben Sie ihn nicht weiter und schreiben Sie ihn nicht in öffentlichen Code. Ist er bekannt geworden, können Sie ihn an derselben Stelle zurücksetzen.
    
3.  **Guthaben aufladen**
    
    Das Guthaben muss über 10 Punkten liegen, damit Sie Aufgaben erstellen können. Zahlungsmethoden und VIP-Bonus finden Sie unter [Aufladung und VIP](https://docs.yescaptcha.com/de/account/recharge.md).
    
4.  **Prüfen, ob der ClientKey funktioniert**
    
    `getBalance` fragt das Guthaben ab und zieht keine Punkte ab:
    
    ```bash
    curl -s https://api.yescaptcha.com/getBalance \
      -H 'Content-Type: application/json' \
      -d '{"clientKey": "YOUR_CLIENT_KEY"}'
    ```
    
    Erhalten Sie `{"errorId": 0, "balance": 12345, ...}`, ist alles bereit; `balance` sind die verbleibenden Punkte. Bei `ERROR_KEY_DOES_NOT_EXIST` wurde der ClientKey falsch kopiert.
    
5.  **Ein Bild erkennen**
    
    Laden Sie das Beispielbild [captcha.jpg](https://docs.yescaptcha.com/samples/captcha.jpg) herunter (Sie können auch Ihr eigenes Captcha-Bild verwenden), legen Sie Ihren ClientKey in eine Umgebungsvariable und führen Sie das Skript aus:
    
    ```bash
    export YESCAPTCHA_CLIENT_KEY=your_client_key
    ```
    
    **curl**
    
    quickstart.sh
    
    ```bash
    #!/usr/bin/env bash
    # First request: read an alphanumeric image captcha with ImageToTextTaskOcrBase (synchronous, 2 points per image)
    # Usage: YESCAPTCHA_CLIENT_KEY=your_client_key bash quickstart.sh captcha.png
    set -euo pipefail
    IMAGE="${1:-captcha.png}"
    BODY=$(base64 < "$IMAGE" | tr -d '\n')   # no "data:" prefix, no line breaks
    curl -s https://api.yescaptcha.com/createTask \
      -H 'Content-Type: application/json' \
      -d "{\"clientKey\": \"${YESCAPTCHA_CLIENT_KEY}\", \"task\": {\"type\": \"ImageToTextTaskOcrBase\", \"body\": \"${BODY}\"}}"
    echo
    ```
    
    
    
    **Python**
    
    quickstart.py
    
    ```python
    """First request: read an alphanumeric image captcha with ImageToTextTaskOcrBase
    (synchronous, 2 points per image).
    
    Usage:
        export YESCAPTCHA_CLIENT_KEY=your_client_key
        python quickstart.py captcha.png
    """
    import base64
    import os
    import sys
    
    import requests
    
    CLIENT_KEY = os.environ["YESCAPTCHA_CLIENT_KEY"]
    image_path = sys.argv[1] if len(sys.argv) > 1 else "captcha.png"
    
    with open(image_path, "rb") as f:
        body = base64.b64encode(f.read()).decode()  # no "data:" prefix
    
    r = requests.post(
        "https://api.yescaptcha.com/createTask",
        json={
            "clientKey": CLIENT_KEY,
            "task": {"type": "ImageToTextTaskOcrBase", "body": body},
        },
        timeout=30,
    )
    data = r.json()
    if data.get("errorId"):
        raise SystemExit(f"{data.get('errorCode')}: {data.get('errorDescription')}")
    print("text:", data["solution"]["text"])
    ```
    
    
    
    **Node.js**
    
    quickstart.mjs
    
    ```js
    // First request: read an alphanumeric image captcha with ImageToTextTaskOcrBase (synchronous, 2 points per image).
    // Usage: YESCAPTCHA_CLIENT_KEY=your_client_key node quickstart.mjs captcha.png
    import { readFileSync } from 'node:fs';
    
    const CLIENT_KEY = process.env.YESCAPTCHA_CLIENT_KEY;
    const body = readFileSync(process.argv[2] ?? 'captcha.png').toString('base64'); // no "data:" prefix
    
    const res = await fetch('https://api.yescaptcha.com/createTask', {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({ clientKey: CLIENT_KEY, task: { type: 'ImageToTextTaskOcrBase', body } }),
    });
    const data = await res.json();
    if (data.errorId) throw new Error(`${data.errorCode}: ${data.errorDescription}`);
    console.log('text:', data.solution.text);
    ```
    
    Führen Sie `bash quickstart.sh captcha.jpg`, `python quickstart.py captcha.jpg` oder `node quickstart.mjs captcha.jpg` aus. Für Python benötigen Sie zuvor `pip install requests`, für Node.js Version 18 oder höher.
    
6.  **Ergebnis prüfen**
    
    Bei Erfolg erhalten Sie:
    
    ```json
    {
      "errorId": 0,
      "status": "ready",
      "solution": {
        "text": "LMResm"
      },
      "taskId": "2376919c-1863-11ec-a012-94e6f7355a0b"
    }
    ```
    
    `errorId` 0 bedeutet Erfolg; der erkannte Text steht in `solution.text`. Bei `errorId` 1 schlagen Sie `errorCode` unter [Fehlercodes](https://docs.yescaptcha.com/de/api/errors.md) nach.
    

## Nächste Schritte

-   Typen, die ein Token zurückgeben, etwa reCAPTCHA und hCaptcha, arbeiten **asynchron**: `createTask` liefert zuerst eine `taskId`, danach rufen Sie alle 5 Sekunden `getTaskResult` auf. Den vollständigen Ablauf finden Sie unter [Anfragen und Antworten](https://docs.yescaptcha.com/de/api/overview.md), ein Beispiel unter [reCAPTCHA v2](https://docs.yescaptcha.com/de/tasks/recaptcha-v2.md).
-   Aufgabentyp auswählen: [Aufgabentypen und Preise](https://docs.yescaptcha.com/de/tasks.md).
-   Ein Client, den Sie direkt in Ihr Projekt kopieren können: [Python](https://docs.yescaptcha.com/de/samples/python.md), [Node.js](https://docs.yescaptcha.com/de/samples/nodejs.md).
-   Ohne Code: [Browser-Erweiterung](https://docs.yescaptcha.com/de/extension.md).