reCAPTCHA v2 görsel tanıma

ReCaptchaV2Classification, reCAPTCHA v2’nin açtığı görsel soruları tanır: görseli ve soru ID’sini gönderirsiniz, hangi karelere tıklanacağı döner; tıklamayı tarayıcıda kendi programınız yapar. Token döndürmez. Senkron çalışır, tek bir createTask isteği sonucu verir; 3x3 ve 4x4 görsellerin her biri 6 puan (≈ $0.90 / 1k), 1x1 küçük görsel daha ucuzdur (aşağıdaki tabloya bakın).

İpucu

Tıklama kodu yazmak istemiyorsanız, bu arayüzü kullanarak otomatik tıklayan tarayıcı eklentisini kullanabilirsiniz.

POSThttps://api.yescaptcha.com/createTaskGlobal uç noktaKopyala

POSThttps://cn.yescaptcha.com/createTaskÇin uç noktasıKopyala

Türler ve fiyatlar

Görev türü	Fiyat	Mod	Notlar
ReCaptchaV2Classification	$0.90 / 1k; 6 puan/görev · ¥6 / 1k	Senkron	1x1 kutucuk (100x100) için 2 puan; 3x3 (300x300) ve 4x4 (450x450) için 6 puan

ABD doları fiyatları, 1 ABD doları ≈ ¥6.67 kuruyla hesaplanan tahminlerdir; görevler puan üzerinden ücretlendirilir.

İstek parametreleri

Alan	Tür	Zorunlu	Açıklama
type	string	Evet	Görev türü; bu sayfadaki "Görev türleri ve fiyatlar" bölümüne bakın
image	string	Evet	data: öneki olmadan Base64 kodlu soru görseli
question	string	Evet	/m/0k4j gibi soru ID'si; bu sayfadaki "Soru ID'leri" bölümüne bakın
confidence	number	Hayır	0 ile 1 arasında güven eşiği; yalnızca 3×3 görsellerde kullanılır. Belirtilirse (başlangıç için 0.5 uygundur) bu değerin üzerindeki tüm kareler döndürülür; belirtilmezse en olası 3 kare döndürülür

Dikkat

Görsel aşağıdaki tabloda verilen standart boyuta ölçeklenmelidir; sunucu soru türünü boyuta göre belirler.

Soru türü	Görsel boyutu	Dönen değer
3x3 ızgara (“Tüm görselleri seçin”)	300 × 300	objects: tıklanacak kareler
4x4 ızgara (“Tüm kareleri seçin”)	450 × 450	objects: tıklanacak kareler
1x1 küçük görsel (3x3’te tıkladıktan sonra yenilenen tek görsel)	100 × 100	hasObject: bu görsele tıklanıp tıklanmayacağı

Ekran görüntüsü kullanıyorsanız soru metnine bakarak ayırt edin: 3x3 sorusu “Select all images with …” (tüm görselleri seçin), 4x4 sorusu “Select all squares with …” (tüm kareleri seçin) şeklindedir.

İstek örneği

POST https://api.yescaptcha.com/createTask

{
  "clientKey": "YOUR_CLIENT_KEY",
  "task": {
    "type": "ReCaptchaV2Classification",
    "image": "BASE64_IMAGE",
    "question": "/m/0k4j"
  }
}

Dönen sonuç

3x3 ve 4x4:

{
  "errorId": 0,
  "status": "ready",
  "solution": {
    "objects": [1, 5, 8],
    "type": "multi"
  },
  "taskId": "3a9e8cb8-3871-11ec-9794-94e6f7355a0b"
}

1x1 küçük görsel:

{
  "errorId": 0,
  "status": "ready",
  "solution": {
    "hasObject": true,
    "type": "single"
  }
}

Alan	Tür	Açıklama
objects	array	Tıklanacak karelerin dizinleri; 0'dan başlar, soldan sağa ve yukarıdan aşağıya doğrudur
hasObject	boolean	1x1 küçük görselde döndürülür; görselin hedefi içerip içermediğini belirtir
type	string	Soru türü: multi (3x3 veya 4x4 görsel, objects alanına bakın), single (1x1 küçük görsel, hasObject alanına bakın); hCaptcha sürükleme soruları için drag

Karelerin numaralandırması 0’dan başlar; soldan sağa, yukarıdan aşağıya doğrudur:

confidence: eşleşen tüm kareleri tek seferde alın

3x3 sorusunda tıkladıktan sonra genellikle yeni 1x1 görseller belirir ve bunların da kontrol edilmesi gerekir. Küçük görselleri almak zorsa (örneğin mobil geliştirmede) confidence gönderebilirsiniz:

• Gönderilmezse 3x3 görsel için en yüksek skorlu 3 kare döner (reCAPTCHA en az 3 tıklama ister).
• Gönderilirse (önerilen 0.5) bu değerin üzerinde skor alan tüm kareler döner; sayı 3’ten fazla veya az olabilir, eşleşen yoksa boş dizi döner. Böylece 1x1 görsellerin ekran görüntüsünü almanız gerekmez.
• 4x4 ve 1x1 görseller üzerinde etkisi yoktur.

Soru ID’leri

question alanına soru metni değil, sorunun ID’si (/m/ ile başlar) yazılır. ID, reCAPTCHA’nın soruyu yüklediği isteğin (reload veya userverify) yanıtında görselle birlikte gelir. Aşağıdaki tabloda yaygın sorular yer alır; Çince açıklamalar yalnızca bilgi içindir:

Toplam 16

Soru ID'si	Soru (İngilizce)
/m/0pg52	taxis
/m/01bjv	bus
/m/04_sv	motorcycles
/m/013xlm	tractors
/m/01jk_4	chimneys
/m/014xcs	crosswalks
/m/015qff	traffic lights
/m/0199g	bicycles
/m/015qbp	parking meters
/m/0k4j	cars
/m/015kr	bridges
/m/019jd	boats
/m/0cdl1	palm trees
/m/09d_r	mountains or hills
/m/01pns0	fire hydrant
/m/01lynh	stairs

ERROR_UNKNOWN_QUESTION ID’nin yanlış olduğunu veya bu sorunun henüz desteklenmediğini gösterir; ERROR_UNKNOW_450x450_QUESTION bu sorunun 4x4 görselde henüz desteklenmediğini gösterir, sayfada yenileyip başka bir soru alın.

Bildirim ve puan iadesi

Tıklamadan sonra doğrulama başarısız olduysa 1 saat içinde report ile bildirebilirsiniz; bildirim sonrası puan iadesi yaklaşık 24 saat sonra hesaplanır. Kurallar için Faturalandırma ve puan iadesi sayfasına bakın. Doğrulaması geçen görevleri de report ile isSuccess: true olarak bildirin.

İlgili eğitimler

• reCAPTCHA v2 görsel tanıma ile tıklama simülasyonu (Selenium)
• reCAPTCHA v2 (token döndürür)