# YesCaptcha Docs

> YesCaptcha adalah API pengenalan captcha: satu antarmuka JSON untuk menyelesaikan reCAPTCHA, hCaptcha, Cloudflare Turnstile, FunCaptcha, AWS WAF, dan captcha gambar. Poin dipotong per tugas, dan tugas yang gagal atau timeout dikembalikan poinnya secara otomatis.

These pages are machine-translated from Chinese; the Chinese version prevails.

- Home: https://docs.yescaptcha.com/id/index.md
- OpenAPI 3.1: https://docs.yescaptcha.com/openapi.json
- Data (JSON): https://docs.yescaptcha.com/data/task-types.json, https://docs.yescaptcha.com/data/error-codes.json, https://docs.yescaptcha.com/data/vip-levels.json
- Full text: https://docs.yescaptcha.com/id/llms-full.txt

## Memulai

- [Pengantar](https://docs.yescaptcha.com/id/getting-started/introduction.md): Apa itu YesCaptcha. Selesaikan reCAPTCHA, hCaptcha, Turnstile, FunCaptcha, dan captcha gambar melalui API atau ekstensi browser, dengan pemotongan poin per tugas dan pengembalian poin otomatis jika gagal.
- [Mulai Cepat](https://docs.yescaptcha.com/id/getting-started/quickstart.md): Kirim permintaan YesCaptcha pertama Anda dalam 5 menit. Daftar, salin ClientKey, isi saldo, lalu kenali gambar captcha dengan curl, Python, atau Node.js (ImageToTextTaskOcrBase, sinkron, 2 poin per gambar).
- [Endpoint](https://docs.yescaptcha.com/id/getting-started/endpoints.md): Dua endpoint YesCaptcha API, global api.yescaptcha.com dan Tiongkok cn.yescaptcha.com. Hanya menerima HTTPS POST dengan JSON; buat dan periksa tugas di endpoint yang sama.
- [Penagihan dan pengembalian poin](https://docs.yescaptcha.com/id/getting-started/billing.md): Cara YesCaptcha memotong poin. 1,000 poin = ¥1, harga tetap per jenis tugas; tugas yang gagal dan timeout dikembalikan poinnya, permintaan yang mengembalikan error tidak dipotong; saldo harus lebih dari 10 poin; laporan pengenalan gambar yang gagal dikembalikan poinnya setelah sekitar 24 jam.

## Referensi API

- [Permintaan dan respons](https://docs.yescaptcha.com/id/api/overview.md): Ketentuan umum YesCaptcha API: POST JSON, autentikasi dengan ClientKey, format respons errorId, tugas sinkron dan asinkron, polling setiap 5 detik, batas waktu 110 detik, hasil disimpan sekitar 10 menit, bahasa pesan mengikuti Accept-Language.
- [createTask — membuat tugas](https://docs.yescaptcha.com/id/api/create-task.md): POST /createTask membuat tugas captcha. Parameter permintaan (clientKey, task, softID), urutan pemeriksaan, jenis asinkron mengembalikan taskId dan jenis sinkron langsung mengembalikan solution; saldo harus lebih dari 10 poin.
- [getTaskResult — mengambil hasil](https://docs.yescaptcha.com/id/api/get-task-result.md): POST /getTaskResult memeriksa hasil tugas asinkron. Lakukan polling setiap 5 detik, tunggu terus saat processing, ambil solution saat ready, dan berhenti jika terjadi error; tugas berjalan hingga sekitar 110 detik, hasil disimpan sekitar 10 menit, dan pemeriksaan tidak memotong poin.
- [getBalance — Cek Saldo](https://docs.yescaptcha.com/id/api/get-balance.md): POST /getBalance menampilkan saldo akun dalam poin (1,000 poin = ¥1) serta saldo bagi hasil developer dan hadiah referral. Tidak memotong poin; bisa dipakai untuk memverifikasi ClientKey.
- [getSoftID — cek ID developer](https://docs.yescaptcha.com/id/api/get-soft-id.md): POST /getSoftID mengembalikan ID developer Anda (softID) dan akumulasi bagi hasil. Sertakan softID di permintaan createTask yang dikirim perangkat lunak Anda untuk pengguna lain agar Anda mendapat bagi hasil.
- [report — laporkan hasil tugas](https://docs.yescaptcha.com/id/api/report.md): POST /report memberi tahu YesCaptcha apakah hasil tugas benar atau salah; laporkan keberhasilan maupun kegagalan secara jujur. Tugas pengenalan gambar yang dilaporkan gagal dalam 1 jam setelah dibuat akan diselesaikan untuk pengembalian poin sekitar 24 jam kemudian.
- [useragent — mengambil User-Agent](https://docs.yescaptcha.com/id/api/useragent.md): GET https://api.yescaptcha.com/useragent mengembalikan User-Agent browser yang disarankan saat ini (teks biasa). Field userAgent pada tugas hCaptcha hanya menerima nilai ini.
- [Kode error](https://docs.yescaptcha.com/id/api/errors.md): Arti dan cara menangani semua kode error YesCaptcha API, dikelompokkan menurut format permintaan, akun dan saldo, tugas bersamaan dan jeda, hasil tugas, parameter situs, gambar, proxy, dan server. Permintaan yang mengembalikan error tidak dipotong poinnya.
- [Batas tugas bersamaan dan jeda otomatis](https://docs.yescaptcha.com/id/api/rate-limits.md): Batas tugas bersamaan di YesCaptcha (ERROR_THREADS_MAXIMUM, tidak ada pemotongan poin, tidak dihitung untuk jeda), jeda otomatis saat terlalu banyak error (100 kali dalam satu menit menyebabkan jeda 5 menit, ERROR_IP_BLOCKED_5MIN), dan cache parameter tidak valid (cached).

## Jenis tugas

- [Jenis tugas dan harga](https://docs.yescaptcha.com/id/tasks.md): Harga (poin, 1,000 poin = ¥1) dan cara pengembalian hasil semua jenis tugas YesCaptcha yang dipublikasikan, yaitu token untuk reCAPTCHA, hCaptcha, dan Turnstile, Cookie untuk halaman verifikasi Cloudflare, serta hasil pengenalan untuk teks gambar dan pengenalan gambar.
- [reCAPTCHA v2](https://docs.yescaptcha.com/id/tasks/recaptcha-v2.md): Dapatkan token reCAPTCHA v2 (versi biasa, tak terlihat, dan Enterprise) dengan YesCaptcha: jenis tugas dan harga, parameter permintaan, contoh curl/Python/Node.js, serta format hasil.
- [reCAPTCHA v3](https://docs.yescaptcha.com/id/tasks/recaptcha-v3.md): Dapatkan token reCAPTCHA v3 (termasuk versi Enterprise) dengan YesCaptcha: cara mengisi pageAction, jenis dengan skor tetap 0.7 dan 0.9, jenis tugas dan harga, parameter, contoh, dan hasil yang dikembalikan.
- [hCaptcha](https://docs.yescaptcha.com/id/tasks/hcaptcha.md): Dapatkan token hCaptcha dengan YesCaptcha: HCaptchaTaskProxyless, HCaptchaTaskProxylessM1, dan HCaptchaTask dengan proxy sendiri, cara mengisi userAgent dan rqdata, serta cara menggunakan respKey yang dikembalikan.
- [Cloudflare Turnstile](https://docs.yescaptcha.com/id/tasks/turnstile.md): Dapatkan token Cloudflare Turnstile dengan YesCaptcha: TurnstileTaskProxyless, TurnstileTaskProxylessM1, dan TurnstileTask dengan proxy sendiri, beserta parameter, contoh, dan hasil yang dikembalikan; serta perbedaannya dengan halaman verifikasi Cloudflare.
- [Halaman verifikasi Cloudflare](https://docs.yescaptcha.com/id/tasks/cloudflare-challenge.md): Lewati halaman pemeriksaan "Just a moment..." (Mohon tunggu) dari Cloudflare dengan YesCaptcha dan dapatkan cf_clearance serta Cookie lainnya, User-Agent, dan konten halaman: parameter CloudFlareTaskS2 dan CloudFlareTaskS3, persyaratan proxy, hasil, cara memakainya, dan error umum.
- [Pengenalan teks pada gambar](https://docs.yescaptcha.com/id/tasks/image-to-text.md): Kenali huruf dan angka di dalam gambar dengan YesCaptcha. ImageToTextTaskOcrBase dan ImageToTextTaskMuggle mengembalikan hasil secara sinkron; ImageToTextTask dan ImageToTextTaskM1 bersifat asinkron dan mendukung huruf besar/kecil, hanya angka, ekspresi hitung, dan batas panjang; model khusus tersedia.
- [Pengenalan gambar reCAPTCHA v2](https://docs.yescaptcha.com/id/tasks/recaptcha-classification.md): Kenali tantangan gambar reCAPTCHA v2 dengan YesCaptcha (ReCaptchaV2Classification): unggah gambar 3x3, 4x4, atau 1x1 beserta ID pertanyaan, dan dapatkan kotak yang harus diklik secara sinkron; harga sesuai ukuran gambar; tabel ID pertanyaan.
- [Pengenalan gambar hCaptcha](https://docs.yescaptcha.com/id/tasks/hcaptcha-classification.md): Kenali tantangan gambar hCaptcha dengan YesCaptcha (HCaptchaClassification): pemilihan kisi, klik posisi tertentu, seret ke posisi tertentu, dan pertanyaan animasi; sinkron, dan tidak ada pemotongan poin jika target tidak ditemukan.
- [Pengenalan gambar FunCaptcha](https://docs.yescaptcha.com/id/tasks/funcaptcha-classification.md): Kenali teka-teki gambar FunCaptcha (Arkose Labs) dengan YesCaptcha (FunCaptchaClassification). Unggah gambar teka-teki (kisi 6 gambar atau teka-teki panah dengan gambar kiri dan kanan) beserta pertanyaan dalam bahasa Inggris, lalu dapatkan secara sinkron gambar mana yang harus dipilih; semua jenis teka-teki didukung.
- [Pengenalan gambar AWS WAF / bCaptcha](https://docs.yescaptcha.com/id/tasks/aws-bcaptcha-classification.md): Kenali tantangan gambar kisi 3×3 AWS WAF CAPTCHA dan bCaptcha dengan YesCaptcha (AwsClassification, bCaptchaClassification). Unggah gambar utuh beserta pertanyaannya, lalu dapatkan kotak yang harus diklik secara sinkron.

## Ekstensi browser

- [YesCaptcha Assistant](https://docs.yescaptcha.com/id/extension.md): YesCaptcha Assistant (ekstensi browser) untuk Chrome dan Firefox yang mengenali dan mengklik reCAPTCHA, hCaptcha, FunCaptcha, AWS WAF, dan captcha lainnya secara otomatis. Ekstensi ini gratis; poin dipotong sesuai API yang dipakai untuk pengenalan. Tautan toko, unduhan paket, serta video instalasi untuk Chrome, BitBrowser, dan Kiwi Browser.

## Panduan

- [Menentukan jenis captcha](https://docs.yescaptcha.com/id/guides/identify-captcha.md): Cara mengetahui captcha apa yang dipakai sebuah halaman web, yaitu reCAPTCHA v2, v2 invisible, v3, versi Enterprise, hCaptcha, perbedaan Cloudflare Turnstile dengan halaman verifikasi Cloudflare, serta jenis tugas YesCaptcha yang sesuai.
- [Cara menemukan parameter reCAPTCHA](https://docs.yescaptcha.com/id/guides/find-recaptcha-parameters.md): Cara menemukan websiteKey (sitekey) reCAPTCHA, websiteURL, pageAction untuk v3, dan fungsi callback di panel Network, Sources, dan Console pada developer tools, lengkap dengan skrip pencarian otomatis.
- [Cara menemukan parameter hCaptcha](https://docs.yescaptcha.com/id/guides/find-hcaptcha-parameters.md): Cara menemukan websiteKey (sitekey), websiteURL, dan rqdata versi Enterprise pada hCaptcha: cari data-sitekey di source halaman, atau cari request checksiteconfig dan getcaptcha di panel Network.
- [Mencari parameter Turnstile](https://docs.yescaptcha.com/id/guides/find-turnstile-parameters.md): Cara menemukan websiteKey (sitekey, diawali 0x) dan websiteURL Cloudflare Turnstile: cari data-sitekey atau turnstile.render di source halaman, atau lihat request challenges.cloudflare.com di Network.
- [Menggunakan token untuk menyelesaikan reCAPTCHA](https://docs.yescaptcha.com/id/guides/submit-recaptcha-token.md): Yang dilakukan setelah mendapat token reCAPTCHA (gRecaptchaResponse): cara kerjanya, mengirimnya langsung lewat request (field g-recaptcha-response), atau mengisinya di browser lalu memanggil callback, lengkap dengan contoh Python di halaman demo Google.
- [Klik gambar reCAPTCHA dengan Selenium](https://docs.yescaptcha.com/id/guides/recaptcha-click-selenium.md): Gunakan Python, Selenium 4, dan ReCaptchaV2Classification untuk mengklik soal gambar reCAPTCHA v2 secara otomatis di browser sungguhan: memicu captcha, membaca pertanyaan dan gambar, memanggil API pengenalan, mengklik kotak, lalu mengirim; lengkap dengan kode contoh.
- [Klik gambar hCaptcha dengan Selenium](https://docs.yescaptcha.com/id/guides/hcaptcha-click-selenium.md): Gunakan Python, Selenium 4, dan HCaptchaClassification untuk menyelesaikan tantangan gambar kisi 3×3 hCaptcha di browser sungguhan. Klik kotak centang, baca pertanyaan dan 9 gambar, panggil API, klik, lalu kirim; lengkap dengan kode contoh.

## Contoh kode

- [Contoh Kode dan SDK](https://docs.yescaptcha.com/id/samples.md): Contoh kode YesCaptcha yang bisa langsung dijalankan (Python, Node.js, curl, C#, Easy Language) dan SDK komunitas tidak resmi (Python, Node.js, Go).
- [Python](https://docs.yescaptcha.com/id/samples/python.md): Contoh Python untuk YesCaptcha: cek saldo, mengenali captcha gambar, kelas client yang bisa dipakai ulang (membuat tugas, polling setiap 5 detik), kontrol tugas bersamaan dengan asyncio, serta mengirim reCAPTCHA dengan requests dan Selenium.
- [Node.js](https://docs.yescaptcha.com/id/samples/nodejs.md): Contoh Node.js untuk YesCaptcha (Node.js 18+ dengan fetch bawaan, tanpa library pihak ketiga): cek saldo, kenali captcha gambar, dan kelas client yang bisa dipakai ulang (membuat tugas, polling setiap 5 detik).
- [C#](https://docs.yescaptcha.com/id/samples/csharp.md): Contoh C# YesCaptcha (.NET 6+, HttpClient + System.Text.Json): cek saldo, buat tugas reCAPTCHA v2, lalu polling hasilnya setiap 5 detik.
- [Easy Language (易语言)](https://docs.yescaptcha.com/id/samples/easy-language.md): Contoh YesCaptcha dalam Easy Language (易语言) dari pengguna: klik otomatis reCAPTCHA dan hCaptcha, pengenalan gambar FunCaptcha, pengiriman token reCAPTCHA; paket unduhan dan poin penting memanggil API.

## Akun

- [Beberapa clientKey: batas penggunaan, daftar IP yang diizinkan, dan masa berlaku](https://docs.yescaptcha.com/id/account/client-keys.md): Satu akun YesCaptcha dapat memiliki hingga 20 clientKey yang memotong saldo akun yang sama. Setiap key dapat diberi batas penggunaan sendiri (per hari, per minggu, per bulan, atau total sekali pakai, direset menurut waktu Beijing), daftar IP yang diizinkan, dan masa berlaku, dan berlaku dalam hitungan detik.
- [Isi Saldo dan VIP](https://docs.yescaptcha.com/id/account/recharge.md): Cara top up YesCaptcha (WeChat Pay, Alipay, PayPal, kripto), 1,000 poin = ¥1; total top up kumulatif otomatis menaikkan Level VIP 1 hingga VIP 10, lalu setiap top up berikutnya mendapat bonus poin sesuai persentase.
- [Program referral](https://docs.yescaptcha.com/id/account/referral.md): Program referral YesCaptcha. Pengguna yang diundang langsung mendapat VIP saat mendaftar (level Anda dikurangi 1, dari VIP 1 hingga VIP 6), dan Anda mendapat 20% dari jumlah yang mereka belanjakan (masing-masing 10% jika ada bagi hasil developer), yang bisa dipindahkan ke saldo atau ditarik mulai ¥100 di Dasbor.
- [Bagi hasil developer](https://docs.yescaptcha.com/id/account/developer.md): Bagi hasil developer YesCaptcha. Sertakan softID Anda di request yang dikirim software Anda untuk para penggunanya, lalu terima 20% dari jumlah yang mereka belanjakan (masing-masing 10% jika ada pengundang); pindahkan ke saldo atau tarik dana mulai ¥100 di dasbor.

## Bantuan

- [Pertanyaan Umum](https://docs.yescaptcha.com/id/help/faq.md): Pertanyaan umum tentang YesCaptcha: apakah tugas yang gagal dipotong poinnya, berapa lama token berlaku, tingkat keberhasilan, pengenalan oleh manusia atau mesin, risiko akun diblokir, memakai satu ClientKey di banyak tempat, memilih endpoint, serta perbedaan ekstensi dan API.
- [Masalah koneksi dan jaringan](https://docs.yescaptcha.com/id/help/troubleshooting.md): Apa yang harus dilakukan jika tidak bisa terhubung ke API YesCaptcha. Langkah pemeriksaan untuk Failed to establish a new connection, kegagalan resolusi DNS, gangguan software proxy, dan error SSL (Certificate has expired, SSLEOFError).
- [Hubungi Kami](https://docs.yescaptcha.com/id/help/contact.md): Hubungi dukungan YesCaptcha lewat WeChat, QQ, WhatsApp, LINE, Telegram @yescaptcha_official, atau email yescaptcha@gmail.com, jam layanan 9:00–21:00 UTC+8.
- [Catatan pembaruan layanan](https://docs.yescaptcha.com/id/changelog.md): Perubahan YesCaptcha yang berdampak bagi pengguna, dicatat per tanggal: jenis tugas yang baru dirilis dan dihentikan, aturan penagihan dan pengembalian poin setelah laporan, batas tugas bersamaan, serta migrasi dokumentasi. Dicatat sejak Oktober 2026.

## Other languages

- [简体中文](https://docs.yescaptcha.com/zh/llms.txt)
- [English](https://docs.yescaptcha.com/en/llms.txt)
- [日本語](https://docs.yescaptcha.com/ja/llms.txt)
- [한국어](https://docs.yescaptcha.com/ko/llms.txt)
- [Русский](https://docs.yescaptcha.com/ru/llms.txt)
- [Español](https://docs.yescaptcha.com/es/llms.txt)
- [Português](https://docs.yescaptcha.com/pt/llms.txt)
- [Tiếng Việt](https://docs.yescaptcha.com/vi/llms.txt)
- [Deutsch](https://docs.yescaptcha.com/de/llms.txt)
- [Français](https://docs.yescaptcha.com/fr/llms.txt)
- [Türkçe](https://docs.yescaptcha.com/tr/llms.txt)
- [ไทย](https://docs.yescaptcha.com/th/llms.txt)