Mulai Cepat

Halaman ini mengirim permintaan pertama dengan jenis tugas paling sederhana, ImageToTextTaskOcrBase, yang membaca huruf dan angka di dalam gambar. Jenis ini sinkron: satu permintaan createTask langsung mengembalikan hasil, biayanya 2 poin (≈ $0.30 / 1k) per gambar, dan tidak membutuhkan situs pihak ketiga, sehingga cocok untuk memastikan akun dan kode Anda sudah berfungsi.

1. Daftar akun

   Buka yescaptcha.com, lalu daftar dan masuk.

2. Salin ClientKey

   Setelah masuk, buka Dasbor (yescaptcha.com/dashboard.html), cari “ClientKey Anda”, lalu klik salin. Salin seluruh nilainya.

   Perhatian

   Semua permintaan API diautentikasi dengan ClientKey, sehingga siapa pun yang memilikinya dapat memakai saldo Anda. Jangan membagikannya dan jangan menaruhnya di kode publik; jika bocor, atur ulang di tempat yang sama.

3. Isi saldo

   Saldo harus lebih dari 10 poin untuk dapat membuat tugas. Metode pembayaran dan bonus VIP ada di Top up dan VIP.

4. Pastikan ClientKey berfungsi

   getBalance mengecek saldo dan tidak memotong poin:

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

   Jika hasilnya {"errorId": 0, "balance": 12345, ...}, berarti ClientKey sudah bisa dipakai; balance adalah sisa poin. Jika hasilnya ERROR_KEY_DOES_NOT_EXIST, berarti kunci salah disalin.

5. Kenali sebuah gambar

   Unduh gambar contoh captcha.jpg (atau pakai gambar captcha Anda sendiri), simpan ClientKey di variabel lingkungan, lalu jalankan salah satu skrip:

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

   Jalankan bash quickstart.sh captcha.jpg, python quickstart.py captcha.jpg, atau node quickstart.mjs captcha.jpg. Python memerlukan pip install requests terlebih dahulu; Node.js memerlukan versi 18 atau lebih baru.

6. Lihat hasilnya

   Jika berhasil, Anda mendapatkan:

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

   errorId bernilai 0 berarti berhasil, dan teks hasil pengenalan ada di solution.text. Jika errorId bernilai 1, lihat errorCode; artinya dijelaskan di Kode error.

Langkah berikutnya

• Jenis yang mengembalikan token seperti reCAPTCHA dan hCaptcha bersifat asinkron: createTask mengembalikan taskId terlebih dahulu, lalu Anda memanggil getTaskResult setiap 5 detik. Alur lengkapnya ada di Permintaan dan respons; contohnya di reCAPTCHA v2.
• Memilih jenis tugas: Jenis tugas dan harga.
• Klien yang bisa langsung disalin ke proyek Anda: Python, Node.js.
• Tanpa kode: Ekstensi browser.