
Adélia Cruz
MCP Integration Engineer
Diterbitkan Nov 20, 2026
Diperbarui Nov 20, 2026 · min baca

Input API solver CAPTCHA adalah kredensial, pengenal tugas, dan data tantangan yang digunakan layanan penyelesai untuk memproses satu permintaan CAPTCHA. Di CapSolver, permintaan createTask memisahkan kredensial akun Anda, clientKey, dari objek task yang menggambarkan tantangan.
Pembedaan ini penting saat menghubungkan solver ke aplikasi yang sudah ada. Sebuah browser mungkin sedang menangani permintaan layanan dengan puluhan field, tetapi field tersebut tidak otomatis menjadi bagian dari tugas CAPTCHA. Mulailah dari tipe tantangannya dan persyaratan yang terdokumentasi. Putuskan apa yang perlu dikirim berdasarkan kontrak itu, bukan dengan men-serialize semua yang saat ini diketahui browser atau agen.
Panduan ini menjelaskan kategori input untuk tugas image‑to‑text, reCAPTCHA v2, dan Cloudflare Turnstile mandiri. Ini adalah referensi pemilihan field, bukan klaim bahwa satu bentuk permintaan mendukung setiap tantangan atau bahwa solver mengendalikan website tujuan.
Data yang dibutuhkan bergantung pada apakah solver menerima gambar atau informasi tentang tantangan berbasis widget. Tabel di bawah membandingkan beberapa tipe tugas CapSolver; ini bukan inventaris lengkap semua tugas yang didukung.
| Tantangan | Tipe task | Input inti task | Konteks tambahan |
|---|---|---|---|
| Teks di dalam gambar | ImageToTextTask |
Data gambar di body |
Opsi yang terdokumentasi seperti modul pengenalan atau URL sumber halaman |
| reCAPTCHA v2 standar | ReCaptchaV2TaskProxyLess |
websiteURL dan websiteKey |
Field terdokumentasi yang sesuai dengan konfigurasi tantangan sebenarnya |
| Turnstile mandiri | AntiTurnstileTaskProxyLess |
websiteURL dan websiteKey |
metadata.action dan metadata.cdata bila berlaku |
Setiap tugas juga membutuhkan type‑nya, dan permintaan pembungkus membutuhkan kredensial solver Anda. Hindari memperlakukan field opsional seperti daftar belanja: menambahkan semua parameter yang tersedia tidak membuat permintaan otomatis menggambarkan tantangan saat ini dengan benar.
Sebuah ImageToTextTask menerima gambar berupa data Base64 di body. Format yang terdokumentasi tidak menyertakan prefiks data:image/...;base64, dan tanpa pemisah baris. Nama file lokal saja bukan isi gambar.
Untuk formulir layanan yang diizinkan dengan CAPTCHA teks kecil, siapkan gambar CAPTCHA itu sendiri. Jangan menggantinya dengan screenshot satu halaman penuh yang berisi pertanyaan pelanggan, detail kontak, atau riwayat pesanan. Materi di sekeliling itu tidak terkait dengan pengenalan karakter.
Persiapan gambar tetap harus mempertahankan informasi yang dibutuhkan untuk membaca tantangan. Crop yang memotong sebagian karakter adalah input yang tidak lengkap. Screenshot dari gambar yang gagal dimuat juga merupakan input yang salah, meskipun encoding Base64‑nya valid. Itu masalah pemilihan konten, berbeda dari pemformatan permintaan.
Sebuah tugas reCAPTCHA v2 menggunakan websiteURL untuk halaman yang memuat tantangan dan websiteKey untuk site key widget. Alamat halaman harus menggambarkan halaman yang relevan; URL beranda yang diingat tidak selalu menjadi pengganti yang berguna.
Bergantung pada konfigurasi, dokumentasi menjelaskan field tambahan seperti pageAction, recaptchaDataSValue, atau payload Enterprise. Gunakan varian task yang berlaku dan skema saat ini. Jangan menyalin parameter Enterprise ke task standar hanya karena contoh permintaan menyertakannya.
Konfigurasi widget reCAPTCHA Google menampilkan site key di pengaturan sisi halaman seperti data-sitekey. Pengenal widget publik ini tidak boleh disamakan dengan kredensial akun solver privat Anda.
Tugas Turnstile mandiri memerlukan URL halaman dan site key. Skemanya juga mendukung action dan cdata di dalam metadata. Berikan nilai‑nilai tersebut bila memang merupakan bagian dari tantangan yang sedang ditangani; jangan mengarang label hanya untuk membuat permintaan terlihat lebih lengkap.
Halaman Cloudflare yang menyebut pemeriksaan keamanan tidak cukup sebagai bukti bahwa tugas ini yang berlaku. Turnstile mandiri dan tantangan Cloudflare satu halaman penuh memiliki dokumentasi dan persyaratan terpisah. Identifikasi alur mana yang dihadapi aplikasi Anda sebelum memilih field inputnya.
Key ini mengidentifikasi pihak yang berbeda dan harus tetap berada di bagian alur kerjanya masing‑masing. Menyalahgunakannya dapat mengubah permintaan yang seharusnya benar menjadi kesalahan autentikasi atau konfigurasi.
| Nilai | Tujuan | Tempat yang tepat |
|---|---|---|
| Solver API key | Mengotorisasi aplikasi Anda untuk memakai layanan solver | Autentikasi permintaan solver, sesuai dokumentasi layanan tersebut |
| CAPTCHA site key | Mengidentifikasi widget yang digunakan di halaman | Parameter widget pada task yang relevan |
| Verification secret milik pemilik website | Memungkinkan situs memvalidasi respons CAPTCHA ke penyedia tantangan | Proses validasi sisi server milik website |
Glosarium API key menjelaskan mengapa kredensial API perlu dilindungi. Simpan kredensial solver di konfigurasi sisi server aplikasi Anda yang terkontrol, bukan di formulir publik atau skrip yang dikirim ke browser. Panduan manajemen secret OWASP memberikan prinsip umum untuk mengendalikan akses ke kredensial semacam itu.
Verification secret milik pemilik website adalah konsep terpisah. Dokumentasi validasi Turnstile Cloudflare, misalnya, menjelaskan server yang mengirimkan secret dan token respons ke Siteverify. Secret itu bukan websiteKey yang diminta oleh task solver mandiri.
Jika aplikasi Anda adalah klien resmi milik website orang lain, jangan berasumsi bahwa Anda perlu mengakses verification secret privat situs tersebut. Gunakan input task solver yang terdokumentasi dan biarkan tujuan akhir melakukan validasinya sendiri.
Tukarkan Kode Bonus CapSolver Anda
Tingkatkan anggaran otomatisasi Anda seketika!
Gunakan kode bonus CAP26 saat mengisi saldo akun CapSolver untuk mendapatkan bonus 5% ekstra di setiap pengisian — tanpa batas.
Tukarkan sekarang di Dashboard CapSolver
Skema task yang dipilih di atas tidak memerlukan seluruh formulir bisnis, HTML halaman, atau riwayat percakapan agen. Bangun permintaan keluar berdasarkan field yang terdokumentasi, bukan dengan meneruskan seluruh state aplikasi.
Pertimbangkan formulir pertanyaan bisnis yang sah. Aplikasi Anda mungkin menyimpan pengenal produk, jumlah yang diminta, alamat kontak, dan pesan. Jika halaman menampilkan CAPTCHA teks‑gambar, permintaan pengenalan dapat disiapkan dari gambar tantangan. Pertanyaan bisnis tetap berada di alur penanganan formulir aplikasi itu sendiri. Ini contoh pemisahan tanggung jawab, bukan integrasi yang sudah diuji dengan situs tertentu.
Tugas berbasis widget mengubah isi bagian tantangan: URL halaman, site key, dan konteks yang berlaku menggantikan gambar. Pertanyaan bisnis tetap tidak menjadi input solver hanya karena muncul di layar yang sama.
Terapkan pengujian yang sama pada field yang tampak tidak berbahaya. URL halaman mungkin mengandung referensi akun atau informasi lain di query string. Tinjau apakah membagikan URL yang dibutuhkan sesuai dengan alur kerja yang diotorisasi. Jangan diam‑diam menghapus konteks tantangan yang dibutuhkan atau mengganti halaman lain untuk menyembunyikan ketidaksesuaian. Jika data yang dibutuhkan tidak boleh dibagikan, selesaikan batasan itu sebelum melakukan pemanggilan.
Untuk keluarga task yang didukung di luar artikel ini, periksa dokumentasinya sendiri. Beberapa task memerlukan informasi lingkungan atau sesi lain. Ketiadaan suatu field dalam perbandingan ini tidak berarti field itu tidak pernah diperlukan.
Input tidak lengkap bila gagal menggambarkan tantangan yang dibutuhkan oleh task yang dipilih, meskipun permintaan berupa JSON yang valid. Tinjau pemilihan task dan nilai sebenarnya sebelum menambahkan data yang tidak terkait atau mengulang permintaan yang sama.
| Gejala dalam permintaan Anda | Yang perlu diperiksa |
|---|---|
| Field Base64 berisi path file | Apakah byte gambar yang dikirimkan, bukan referensi ke file lokal |
| Gambar menampilkan seluruh formulir | Apakah CAPTCHA yang dimaksud masih dapat dibaca dan apakah informasi bisnis yang tidak terkait ikut disertakan tanpa perlu |
| Task widget memiliki URL tetapi tanpa site key | Pengenal widget yang dibutuhkan oleh task tersebut |
| Parameter berasal dari halaman atau lingkungan berbeda | Apakah URL, site key, dan konteks yang relevan menggambarkan tantangan yang sama |
| Task standar berisi field Enterprise yang disalin | Apakah varian task dan nama parameter sesuai dengan dokumentasi saat ini |
| Field opsional berisi nilai hasil tebakan | Apakah tantangan benar‑benar menyediakan konteks tersebut |
Untuk masalah yang khusus menyangkut pengenal reCAPTCHA dan token yang dikembalikan, panduan penelusuran kesalahan invalid site key dan token membahas tugas diagnostik yang lebih sempit itu.
Tinjauan permintaan yang berguna dapat mencatat tipe task, field wajib mana yang ada, dan dokumentasi mana yang membenarkan setiap field opsional. Anda tidak perlu menempelkan kredensial, gambar mentah, atau token lengkap ke tiket tinjauan untuk menjelaskan keputusan tersebut. Ini membuat tinjauan tetap fokus pada kontrak permintaan alih‑alih menumpuk salinan tambahan payload.
Skema input memberi tahu apa yang dapat diterima API; skema tidak menjelaskan kebijakan retensi penyedia, komitmen kontraktual, atau keputusan akhir di tujuan. Jaga agar pertanyaan‑pertanyaan itu tetap terpisah saat meninjau integrasi solver.
Sebelum penggunaan produksi, nilai data sebenarnya yang akan dikirim aplikasi Anda dan lihat kebijakan atau perjanjian penyedia terkait untuk persyaratan penanganannya. Jangan menyimpulkan jadwal penghapusan, jaminan lokasi penyimpanan data, atau pembatasan pelatihan hanya dari contoh task singkat. Tidak ada jaminan seperti itu yang mengikuti keberadaan websiteURL atau body saja.
Demikian pula, jawaban atau token yang dikembalikan adalah satu komponen dari alur kerja. Aplikasi Anda harus memeriksa apakah halaman atau layanan yang dituju menerima aksi berikutnya yang diotorisasi. Permintaan solver yang berhasil tidak bisa memastikan bahwa pertanyaan bisnis terkirim, dokumen diambil, atau tujuan memberikan izin untuk aktivitas lebih lanjut.
Permintaan CAPTCHA yang jelas dimulai dari tipe tantangan yang didukung, lalu menyertakan input wajib dan konteks yang berlaku. Jaga agar kredensial solver, pengenal widget, dan data bisnis tetap terpisah sepanjang proses itu.
Pendekatan ini memudahkan peninjauan permintaan: setiap field keluar memiliki tujuan yang terdokumentasi, dan konteks tantangan yang hilang dapat diselidiki tanpa meneruskan seluruh state browser. Gunakan dokumentasi task terbaru setiap kali tipe tantangan atau konfigurasi halaman berubah.
Gunakan CapSolver untuk langkah CAPTCHA yang didukung dalam alur kerja otomatisasi resmi Anda. Mulailah dari skema task yang relevan, siapkan hanya input yang wajib dan berlaku, dan lakukan pengecekan hasil di aplikasi Anda.
T: Apakah setiap task solver CAPTCHA membutuhkan gambar?
Tidak. Pengenalan image‑to‑text menggunakan data gambar, sedangkan task reCAPTCHA v2 dan Turnstile mandiri yang dijelaskan di sini menggunakan parameter halaman dan widget. Pilih task sebelum menyiapkan payload.
T: Bisakah saya menggunakan solver API key sebagai websiteKey?
Tidak. Solver API key mengotorisasi permintaan Anda ke layanan; websiteKey mengidentifikasi widget CAPTCHA. Nilai‑nilai ini tidak dapat dipertukarkan.
T: Haruskah saya mengirim field opsional jika saya tidak tahu nilainya?
Tidak. Gunakan field opsional bila tantangan saat ini dan dokumentasi task membenarkannya. Menebak action atau menyalin konteks yang tidak terkait tidak memperbaiki input yang kurang.
T: Apakah API perlu detail pelanggan dari formulir?
Skema task yang dipilih dalam panduan ini tidak memerlukan detail kontak pelanggan, teks pertanyaan, atau catatan pesanan. Pisahkan data aplikasi itu dari input tantangan dan tinjau setiap informasi sensitif yang tertanam di field wajib.
T: Apakah mengirim lebih sedikit field menjamin hasil yang sukses?
Tidak. Tujuannya adalah permintaan yang benar dan spesifik per task, bukan permintaan sekecil mungkin dengan segala cara. Menghilangkan data wajib atau konteks tantangan yang relevan dapat membuat permintaan tidak lengkap, dan tujuan akhir tetap menentukan apakah aksi berikutnya diterima.

Adélia Cruz
MCP Integration Engineer
Making CapSolver tools accessible through MCP.
TENTANG PENULIS