เริ่มต้นใช้งานอย่างรวดเร็ว

หน้านี้ส่งคำขอแรกด้วยประเภทงานที่ง่ายที่สุดคือ ImageToTextTaskOcrBase (อ่านตัวอักษรภาษาอังกฤษและตัวเลขในภาพ) เป็นแบบซิงโครนัส คือคำขอ createTask เพียงครั้งเดียวก็ได้ผลลัพธ์ ราคาครั้งละ 2 พอยต์ (≈ $0.30 / 1k) และไม่ต้องพึ่งเว็บไซต์ของบุคคลที่สาม จึงเหมาะสำหรับใช้ตรวจสอบว่าบัญชีและโค้ดของคุณทำงานได้ปกติ

1. สมัครบัญชี

   เปิด yescaptcha.com แล้วสมัครสมาชิกและเข้าสู่ระบบ

2. คัดลอก ClientKey

   หลังเข้าสู่ระบบ ให้ไปที่แดชบอร์ด (yescaptcha.com/dashboard.html) หา “ClientKey ของคุณ” แล้วคลิกคัดลอก โดยต้องคัดลอกให้ครบทั้งค่า

   คำเตือน

   คำขอ API ทุกรายการใช้ ClientKey ในการยืนยันตัวตน ผู้ที่ได้ ClientKey ไปจะใช้ยอดคงเหลือของคุณได้ อย่าส่งให้ผู้อื่นและอย่าเขียนลงในโค้ดสาธารณะ หากรั่วไหลสามารถรีเซ็ตได้ที่ตำแหน่งเดิม

3. เติมเงิน

   ยอดคงเหลือต้องมากกว่า 10 พอยต์จึงจะสร้างงานได้ วิธีเติมเงินและโบนัส VIP ดูที่ เติมเงินและ VIP

4. ตรวจสอบว่า ClientKey ใช้งานได้

   getBalance ใช้ตรวจสอบยอดคงเหลือ และไม่หักพอยต์:

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

   หากได้ผลลัพธ์ {"errorId": 0, "balance": 12345, ...} แสดงว่าพร้อมใช้งาน โดย balance คือพอยต์คงเหลือ หากได้ ERROR_KEY_DOES_NOT_EXIST แสดงว่าคัดลอกคีย์ผิด

5. จดจำภาพหนึ่งภาพ

   ดาวน์โหลดภาพตัวอย่าง captcha.jpg (หรือใช้ภาพ CAPTCHA ของคุณเองก็ได้) ใส่ ClientKey ลงในตัวแปรสภาพแวดล้อมแล้วรัน:

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

   รันด้วย bash quickstart.sh captcha.jpg, python quickstart.py captcha.jpg หรือ node quickstart.mjs captcha.jpg Python ต้องรัน pip install requests ก่อน ส่วน Node.js ต้องเป็นเวอร์ชัน 18 ขึ้นไป

6. ดูผลลัพธ์

   เมื่อสำเร็จจะได้ผลลัพธ์:

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

   errorId เป็น 0 หมายถึงสำเร็จ และข้อความที่จดจำได้อยู่ใน solution.text หาก errorId เป็น 1 ให้ดู errorCode ความหมายอยู่ใน รหัสข้อผิดพลาด

ขั้นตอนถัดไป

• งานประเภทที่คืนค่า token เช่น reCAPTCHA และ hCaptcha เป็นแบบอะซิงโครนัส: createTask จะคืน taskId ก่อน จากนั้นเรียก getTaskResult ทุก 5 วินาที ดูขั้นตอนทั้งหมดได้ที่ คำขอและการตอบกลับ ตัวอย่างอยู่ที่ reCAPTCHA v2
• เลือกประเภทงาน: ประเภทงานและราคา
• ไคลเอนต์ที่คัดลอกไปใช้ในโปรเจกต์ได้ทันที: Python, Node.js
• ไม่ต้องเขียนโค้ด: ส่วนขยายเบราว์เซอร์