
Ethan Collins
AI Agent Workflow Engineer
Diterbitkan Oct 22, 2026
Diperbarui Oct 22, 2026 · min baca

ImageToTextTask CapSolver menerima data gambar dan langsung mengembalikan teks yang dikenali; tugas token reCAPTCHA menggunakan parameter situs web dan memiliki kontrak hasil yang berbeda.Memilih antara pengenalan gambar CAPTCHA dan penyelesaian token dimulai dari pertanyaan praktis: apa yang diharapkan langkah berikutnya di aplikasi Anda? Sebuah kolom teks mungkin membutuhkan karakter yang ditampilkan di gambar. Integrasi reCAPTCHA mengharapkan token respons. Mengirim hasil pertama ke antarmuka kedua tidak akan berhasil, bahkan jika keduanya sama-sama disebut “menyelesaikan CAPTCHA”.
CapSolver mendokumentasikan tugas pengenalan dan token secara terpisah. Panduan ini membandingkan input, output, dan tanggung jawab integrasinya sehingga Anda dapat memilih titik awal yang tepat untuk pengujian atau otomasi yang sah. Panduan ini tidak memberi peringkat penyedia maupun mengasumsikan bahwa setiap CAPTCHA dapat ditangani melalui permintaan yang sama.
Pengenalan gambar menghasilkan jawaban tentang konten gambar, sedangkan penyelesaian token menghasilkan nilai respons untuk sistem verifikasi yang didukung.
Itu adalah perbedaan di tingkat API. Perbedaan itu tidak menentukan model dasar apa yang digunakan layanan atau apakah browser terlibat secara internal. Untuk pekerjaan integrasi, pembedaan yang berguna adalah informasi yang Anda kirim dan hasil yang Anda terima.
Sebuah CAPTCHA dapat memiliki beberapa bentuk yang terlihat. Beberapa meminta seseorang membaca karakter yang terdistorsi; lainnya menampilkan tantangan pemilihan gambar; yang lain lagi bekerja tanpa teka-teki gambar. Kehadiran gambar saja tidak memberi tahu Anda apa yang akan diterima aplikasi sebagai penyelesaian.
| Titik keputusan | Pengenalan gambar | Penyelesaian token |
|---|---|---|
| Input tipikal | Byte gambar yang dikodekan sebagai teks, plus instruksi spesifik tugas | URL situs web, kunci situs, dan parameter spesifik tugas |
| Output tipikal | Karakter yang dikenali atau hasil klasifikasi | Token respons CAPTCHA |
| Yang harus disediakan pemanggil | Gambar yang benar untuk tantangan saat ini | Jenis CAPTCHA yang benar dan parameter halaman saat ini |
| Yang tersisa setelahnya | Gunakan jawaban di langkah aplikasi yang dimaksud dan periksa penerimaannya | Kirim token melalui integrasi yang dimaksud dan periksa penerimaannya |
| Ketidaksesuaian umum | Menganggap keluaran klasifikasi sebagai token verifikasi | Mengirim token ke field yang mengharapkan karakter gambar |
Perbandingan ini menggambarkan kontrak tugas yang umum, bukan skema universal. Baca dokumentasi untuk tugas yang tepat sebelum membangun parser hasil bersama.
Pilih pengenalan gambar ketika alur kerja Anda memiliki sebuah gambar dan membutuhkan jawaban terdefinisi tentang isinya.
Sebagai contoh, pengujian resmi terhadap aplikasi dengan teks CAPTCHA mungkin sudah memiliki akses ke gambar yang ditampilkan. Langkah berikutnya mengharapkan karakternya. Tugas OCR dapat menyediakan teks tersebut, sementara pengujian aplikasi tetap bertanggung jawab untuk memasukkannya dan memeriksa hasilnya.
Referensi tugas ImageToText resmi memerlukan body yang berisi konten gambar yang dikodekan Base64. URL situs web bersifat opsional untuk tugas ini. Menyediakan site key tanpa gambar tidak memenuhi persyaratan input tersebut.
Base64 merepresentasikan data biner menggunakan karakter teks. Ini adalah sebuah encoding, bukan langkah peningkatan gambar. CAPTCHA yang dipotong dengan buruk atau sudah kedaluwarsa tetap tidak cocok setelah dikodekan.
Untuk ImageToTextTask, gunakan konten gambar tanpa pemisah baris atau prefiks data:image/...;base64,, seperti yang ditentukan referensi tugas. Jauhkan konten halaman yang tidak terkait dan informasi pribadi dari gambar yang dikirim ke layanan.
Body permintaan berikut mengikuti skema resmi dengan placeholder eksplisit untuk gambar. Ini adalah contoh skema, bukan penyelesaian yang dijalankan: ganti key dan nilai gambar sebelum menggunakannya dengan POST https://api.capsolver.com/createTask.
{
"clientKey": "YOUR_API_KEY",
"task": {
"type": "ImageToTextTask",
"body": "BASE64_IMAGE_CONTENT"
}
}
Tugas ini mengembalikan hasil pengenalannya secara langsung. Periksa field error sebelum membaca solution.text; jangan menambahkan loop polling hanya karena tugas CAPTCHA lain membutuhkannya.
Klasifikasi gambar menjawab sebuah pertanyaan tentang gambar, bukan menyalin karakter. CapSolver mendokumentasikan klasifikasi gambar reCAPTCHA sebagai tugas terpisah dengan input gambar dan pertanyaan.
Respons klasifikasi bukanlah verifikasi reCAPTCHA yang sudah selesai. Jika Anda memilih antarmuka pengenalan, aplikasi Anda tetap memerlukan alur kerja tantangan yang kompatibel. Jangan berasumsi bahwa daftar area gambar yang dipilih dapat disisipkan kapan pun aplikasi mengharapkan token respons.
Untuk integrasi pertama, tuliskan terlebih dahulu output yang diharapkan sebelum memilih nama tugas. “Membaca karakter” dan “mendapatkan respons reCAPTCHA” adalah kebutuhan yang berbeda, meskipun keduanya sama-sama dimulai dari tangkapan layar di tiket dukungan.
Pilih penyelesaian token ketika aplikasi menggunakan integrasi CAPTCHA yang didukung dan output yang dibutuhkan adalah token responsnya.
Referensi tugas reCAPTCHA v2 menjelaskan parameter situs web seperti websiteURL dan websiteKey. Parameter-parameter ini mengidentifikasi halaman dan integrasi CAPTCHA. Mereka bukan pengganti satu sama lain, dan site key publik bukan API key CapSolver Anda.
Skema contoh kedua ini menunjukkan bentuk dasar tugas reCAPTCHA v2 tanpa proxy. Ini bukan permintaan yang dijalankan dan tidak mencakup setiap parameter opsional yang mungkin dibutuhkan integrasi tertentu.
{
"clientKey": "YOUR_API_KEY",
"task": {
"type": "ReCaptchaV2TaskProxyLess",
"websiteURL": "https://www.yourwebsite.com",
"websiteKey": "YOUR_RECAPTCHA_SITE_KEY"
}
}
Gunakan nilai halaman aktual yang diizinkan dan jenis tugas yang didokumentasikan untuk versi CAPTCHA tersebut. Integrasi v2, v3, atau Enterprise tidak boleh dipilih dengan coba-coba menggunakan nama tugas yang tidak terkait.
Dengan alur asinkron createTask, simpan ID tugas yang dikembalikan dan dapatkan hasil tugas tersebut melalui getTaskResult. Baca field solution yang didokumentasikan untuk tugas yang dipilih. Hindari menulis satu parser yang mengasumsikan setiap respons sukses berisi field yang sama.
Tukarkan Kode Bonus CapSolver Anda
Tingkatkan anggaran otomasi Anda seketika!
Gunakan kode bonus CAP26 saat mengisi saldo akun CapSolver Anda untuk mendapatkan bonus 5% ekstra pada setiap isi ulang — tanpa batas.
Tukarkan sekarang di Dashboard CapSolver
Kedua alur kerja memerlukan pemeriksaan di tingkat aplikasi setelah solver mengembalikan hasilnya.
Untuk teks CAPTCHA, itu mungkin berarti mengonfirmasi bahwa form yang dimaksud menerima karakter untuk tantangan yang sama. Jika gambar diperbarui saat permintaan berjalan, jawaban untuk gambar sebelumnya bukan lagi hasil yang dibutuhkan form Anda saat ini.
Untuk integrasi token, string yang tidak kosong tidak menjamin bahwa aplikasi menerima permintaan tersebut. Dokumentasi verifikasi reCAPTCHA Google menjelaskan langkah verifikasi token di sisi server situs web. Secret verifikasi privat milik situs web berada di server mereka; pengguna solver tidak perlu mendapatkan secret milik orang lain.
Cloudflare juga mengharuskan validasi sisi server untuk respons Turnstile. Pemeriksaan dari penyedia ini terpisah dari laporan solver bahwa sebuah tugas sudah siap. Jika Anda mengoperasikan aplikasi tersebut, periksa hasil validasinya. Jika Anda sedang menguji alur kerja lain yang diizinkan, periksa hasil sukses yang didokumentasikan tanpa mengklaim visibilitas ke backend privatnya.
Pembedaan ini juga membantu saat debugging. Catat apakah kegagalan terjadi saat pengambilan gambar, pembuatan tugas, pengambilan hasil, pengiriman hasil, atau penerimaan oleh aplikasi. Tangkapan layar dari error akhir saja mungkin tidak mengidentifikasi langkah mana yang membutuhkan perhatian.
Untuk detail lebih lanjut tentang nilai yang dikembalikan, lihat penjelasan tentang token CAPTCHA dan cookie. Jawaban OCR maupun token respons tidak serta-merta menetapkan sesi browser yang persisten.
Pilih antarmuka terkecil yang didukung yang menyediakan hasil yang dapat dikonsumsi alur kerja Anda yang sudah ada.
Gunakan tugas pengenalan teks ketika tantangannya berupa gambar teks dan Anda dapat memperoleh gambar saat ini secara sah. Konfirmasikan pengambilan gambar, encoding, teks yang dikembalikan, dan respons form sebagai langkah terpisah. Ini cocok langsung untuk OCR; menambahkan tugas token situs web tidak akan memenuhi kebutuhan field input tersebut.
Gunakan tugas token yang sesuai ketika Anda memiliki parameter yang didokumentasikan dan jalur integrasi yang sah. Jangan mengubah keberadaan teka-teki gambar menjadi keharusan memelihara alur kerja klasifikasi gambar terpisah. Mulailah dari produk CAPTCHA dan kontrak responsnya.
Minta agen mengidentifikasi tantangan yang didukung dan konteks integrasi yang tersedia sebelum meminta tindakan solver. Tangkapan layar saja tidak membuktikan bahwa agen memiliki input gambar yang benar, site key, callback, atau jalur pengiriman hasil yang tepat. Berhentilah jika informasi kurang alih-alih membiarkan model mengada-ada nilai.
Untuk alur kerja browser yang mapan, integrasi browser yang terdokumentasi mungkin menangani lebih banyak interaksi tersebut. Perbandingan dalam panduan ini tidak menggantikan uji integrasi dengan klien atau browser spesifik yang ingin Anda gunakan.
Bandingkan kompatibilitas, usaha implementasi, dan hasil aplikasi yang terverifikasi sebelum membandingkan harga headline per tugas.
Kompatibilitas adalah yang utama: respons berbiaya rendah tidak berguna jika formatnya salah untuk aplikasi. Selanjutnya, perhitungkan pekerjaan yang harus dipelihara tim Anda, seperti pengambilan gambar, status tantangan, pengambilan hasil, dan pemeriksaan penerimaan akhir. Tanggung jawab ini berbeda antara alur kerja meski keduanya menggunakan HTTP API.
Evaluasilah sampel kecil yang sah yang mencerminkan jenis CAPTCHA yang benar-benar Anda butuhkan. Jaga agar kondisi sumber cukup konsisten untuk memahami kegagalan. Catat error tugas dan penolakan aplikasi secara terpisah, dan hindari menganggap status siap dari penyedia sebagai tingkat keberhasilan end-to-end Anda.
Jangan menyimpulkan kecepatan, akurasi pengenalan, atau keunggulan biaya hanya dari klasifikasi ini. Hal-hal tersebut adalah pengukuran untuk tugas dan integrasi tertentu, bukan konsekuensi dari kata “gambar” atau “token”.
Jawaban yang diharapkan memberi Anda titik awal paling jelas: karakter gambar, keluaran klasifikasi, atau token respons verifikasi.
Periksa jawaban tersebut terhadap dokumentasi tugas saat ini, berikan input yang sesuai, dan tetapkan bagaimana aplikasi Anda akan mengonfirmasi penyelesaiannya. CapSolver menyediakan antarmuka terpisah untuk kebutuhan ini; memilih dengan sengaja mengurangi ketidaksesuaian input dan output yang dapat dihindari.
Coba CapSolver dengan jenis CAPTCHA yang didukung dalam alur kerja yang sah. Mulailah dengan satu kontrak tugas yang sudah dipastikan sebelum memperluas implementasi Anda.
T: Apakah pengenalan gambar CAPTCHA sama dengan penyelesaian token?
Tidak. Pengenalan mengembalikan informasi tentang gambar, seperti teks atau hasil klasifikasi. Penyelesaian token mengembalikan respons untuk integrasi CAPTCHA yang didukung. Pilih antarmuka berdasarkan apa yang diharapkan aplikasi berikutnya.
T: Bisakah hasil OCR digunakan sebagai token reCAPTCHA?
Tidak. Karakter yang dikenali bukan token respons reCAPTCHA. Keduanya termasuk dalam kontrak input dan verifikasi yang berbeda.
T: Apakah setiap tugas CAPTCHA membutuhkan polling?
Tidak. CapSolver mendokumentasikan hasil langsung untuk ImageToTextTask, sementara tugas token asinkron menggunakan ID tugas dan pengambilan hasil. Ikuti alur yang didokumentasikan untuk tugas yang dipilih alih-alih menerapkan satu loop ke semua respons.
T: Metode mana yang lebih baik untuk agen AI?
Metode yang lebih baik adalah yang sesuai dengan tantangan dan integrasi aktual agen tersebut. Agen yang dapat mengambil gambar tidak otomatis mampu menyelesaikan alur kerja berbasis token. Verifikasikan input yang dibutuhkan dan langkah pengiriman hasil.
T: Apakah respons solver yang sukses berarti aplikasi saya berhasil?
Tidak. Aplikasi tetap harus menerima jawaban atau token dan menyelesaikan tindakan yang dimaksud. Periksa hasil tersebut secara terpisah dan jaga agar otomasi tetap berada dalam akses yang Anda izinkan untuk digunakan.

Ethan Collins
AI Agent Workflow Engineer
Building clearer handoffs between AI agents and tools.
TENTANG PENULIS
Perbaiki ERROR_IP_BANNED dengan menghentikan permintaan API CAPTCHA yang berulang dan salah, menemukan kesalahan pertama, memeriksa kode terkait, dan melanjutkan dengan pengujian terkontrol.

Memecahkan masalah kesalahan proxy CapSolver dengan memeriksa parameter tugas, autentikasi, konektivitas, dan pengaturan sesi sebelum mencoba ulang permintaan CAPTCHA.
