Hızlı başlangıç

Bu sayfada, en basit görev türü olan ImageToTextTaskOcrBase (görseldeki İngilizce harf ve rakamları tanır) ile ilk isteği gönderiyoruz. Görev senkrondur: tek bir createTask isteği sonucu döndürür. Görsel başına ücret: 2 puan (≈ $0.30 / 1k). Üçüncü taraf bir siteye ihtiyaç duymaz, bu yüzden hesabınızın ve kodunuzun çalıştığını doğrulamak için uygundur.

1. Hesap oluşturun

   yescaptcha.com adresinden kayıt olun ve giriş yapın.

2. ClientKey’nizi kopyalayın

   Giriş yaptıktan sonra Panel’de (yescaptcha.com/dashboard.html) “ClientKey’niz” alanını bulun ve kopyalayın. Değerin tamamını kopyalayın.

   Dikkat

   Tüm API istekleri ClientKey ile doğrulanır; ClientKey’ye sahip olan herkes bakiyenizi kullanabilir. Başkalarıyla paylaşmayın, herkese açık koda yazmayın. Sızdırdıysanız aynı yerden sıfırlayabilirsiniz.

3. Bakiye yükleyin

   Görev oluşturmak için bakiyenin 10 puandan fazla olması gerekir. Ödeme yöntemleri ve VIP bonusu için Bakiye yükleme ve VIP sayfasına bakın.

4. ClientKey’nin çalıştığını doğrulayın

   getBalance bakiyeyi sorgular, puan düşmez:

   curl -s https://api.yescaptcha.com/getBalance \
     -H 'Content-Type: application/json' \
     -d '{"clientKey": "YOUR_CLIENT_KEY"}'

   {"errorId": 0, "balance": 12345, ...} dönerse hazırsınız; balance kalan puandır. ERROR_KEY_DOES_NOT_EXIST dönerse ClientKey yanlış kopyalanmıştır.

5. Bir görseli okuyun

   Örnek görseli captcha.jpg indirin (kendi CAPTCHA görselinizi de kullanabilirsiniz), ClientKey’nizi ortam değişkenine koyup betiklerden birini çalıştırın:

   export YESCAPTCHA_CLIENT_KEY=your_client_key

   curl

   quickstart.sh

   #!/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

   """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

   // 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);

   Çalıştırma: bash quickstart.sh captcha.jpg, python quickstart.py captcha.jpg veya node quickstart.mjs captcha.jpg. Python için önce pip install requests gerekir; Node.js için 18 veya üzeri sürüm gerekir.

6. Sonucu inceleyin

   Başarılı olduğunda şu yanıt döner:

   {
     "errorId": 0,
     "status": "ready",
     "solution": {
       "text": "LMResm"
     },
     "taskId": "2376919c-1863-11ec-a012-94e6f7355a0b"
   }

   errorId değeri 0 ise işlem başarılıdır; okunan metin solution.text içindedir. errorId 1 ise errorCode değerine bakın, anlamları için Hata kodları sayfasına bakın.

Sonraki adımlar

• reCAPTCHA ve hCaptcha gibi token döndüren görev türleri asenkron çalışır: createTask önce taskId döndürür, ardından her 5 saniyede bir getTaskResult çağrılır. Tam akış için İstek ve yanıt sayfasına, örnek için reCAPTCHA v2 sayfasına bakın.
• Görev türü seçimi: Görev türleri ve fiyatlar.
• Projenize doğrudan kopyalayabileceğiniz istemciler: Python, Node.js.
• Kod yazmadan: YesCaptcha Assistant (tarayıcı eklentisi).