
Nikolai Smirnov
Software Development Lead
Diterbitkan Oct 13, 2026
Diperbarui Oct 13, 2026 ยท min baca

ImageToTextTask CapSolver ketika CAPTCHA meminta Anda untuk membaca karakter dari gambar.ImageToTextTask mengembalikan hasil pengenalan langsung; tidak memerlukan loop pemanggilan hasil terpisah.Skrip Python dapat mencapai formulir yang diizinkan dan berhenti pada gambar kecil yang berisi huruf atau angka yang terdistorsi. Langkah berikutnya sederhana: tangkap gambar saat ini, minta solver CAPTCHA gambar untuk mengenali karakternya, lalu kirim teks yang dikembalikan ke formulir yang sesuai.
CapSolver menyediakan ImageToTextTask untuk langkah pengenalan ini. Panduan ini menggunakan contoh SDK Python resmi mereka dan menjelaskan cara mempersiapkan input, membaca hasil, serta mendiagnosis kesalahan yang umum terjadi sekitar pemanggilan. Gunakan alur kerja pada formulir yang Anda miliki atau diizinkan untuk otomatisasi; respons pengenalan tidak mengubah aturan akses tujuan.
ImageToTextTask mengenali teks dalam gambar dan mengembalikan karakter yang dapat digunakan aplikasi Python Anda.
Ini adalah tugas pengenalan karakter optik (OCR). Inputnya adalah gambar; output yang berguna adalah teks yang ditampilkan dalam gambar tersebut. Cocok untuk formulir yang meminta Anda memasukkan karakter yang ditampilkan ke dalam bidang jawaban.
Checkbox reCAPTCHA atau widget Turnstile adalah integrasi yang berbeda. Jangan kirim screenshot seluruh widget ke ImageToTextTask dan harapkan token verifikasi browser. Gunakan tugas yang sesuai saat aplikasi membutuhkan token daripada teks yang dikenali.
Mulailah dengan memeriksa apa yang diminta formulir. Jika menampilkan gambar karakter di samping bidang teks, pengenalan gambar mungkin sesuai. Jika meminta interaksi grid, pemeriksaan tak terlihat, atau format tantangan lain, identifikasi format tersebut sebelum memilih API.
Anda membutuhkan gambar CAPTCHA yang saat ini, Python, paket CapSolver, dan kunci akun CapSolver dengan akses ke layanan yang diperlukan.
Simpan gambar dari uji coba atau aplikasi yang diizinkan sebagai captcha.png. Pertahankan area karakter lengkap terlihat. Jangan termasuk teks halaman yang tidak relevan, kontrol browser, atau CAPTCHA lain bersamanya. Tujuannya adalah mengirimkan gambar yang akan dibaca pengguna untuk upaya formulir tertentu.
Instal paket resmi di lingkungan Python Anda:
python -m pip install capsolver==1.0.7
Ini menetapkan versi SDK yang digunakan untuk pemeriksaan paket di balik panduan ini. Panduan instalasi paket Python menjelaskan mengapa lingkungan terisolasi berguna saat proyek berbeda membutuhkan dependensi yang berbeda.
Panggilan SDK yang hidup di bagian ini memerlukan kunci akun nyata dan string Base64 lengkap gambar. Kedua nilai ini diperlukan, bukan nilai yang dapat diganti oleh placeholder yang ditunjukkan dalam dokumentasi. Contoh berasal dari dokumentasi resmi CapSolver; hasil pengenalan langsung tidak ditunjukkan di sini.
Jaga kunci akun tetap jauh dari screenshot yang dibagikan, repositori sumber, dan tiket dukungan. Situs publik situs yang memiliki situs kunci lain, jika ada, bukan pengganti untuk kunci akun CapSolver.
Konversi konten biner file ke string Base64 murni sebelum menempatkannya di bidang body tugas.
Simpan potongan persiapan berikut sebagai prepare_image.py di direktori yang sama dengan captcha.png:
from pathlib import Path
import base64
image_bytes = Path("captcha.png").read_bytes()
image_base64 = base64.b64encode(image_bytes).decode("ascii")
Path("captcha-base64.txt").write_text(image_base64, encoding="ascii")
print("Saved Base64 image to captcha-base64.txt")
Jalankan dengan python prepare_image.py. File teks berisi nilai lengkap yang digunakan untuk body di langkah berikutnya.
Potongan ini menggunakan bacaan file biner dan enkripsi Base64 yang didokumentasikan Python. Ini mempersiapkan input secara lokal; tidak memanggil CapSolver atau mengenali karakter.
Buka gambar sumber sebelum melanjutkan. File bernama captcha.png masih dapat berisi data yang salah jika unduhan sebelumnya menyimpan halaman error HTML. Pastikan menampilkan gambar yang diharapkan dan file teks dibuat dari file tersebut.
Jangan kirim jalur lokal seperti captcha.png sebagai body tugas. Jangan mengenkripsi URL gambar sebagai teks. API membutuhkan byte gambar sebenarnya yang direpresentasikan sebagai Base64.
Panggil capsolver.solve dengan tugas ImageToTextTask yang didokumentasikan setelah mengganti placeholder yang diperlukan.
Contoh SDK berikut berasal dari dokumentasi ImageToTextTask resmi. Simpan sebagai solve_image.py. Ganti ... dengan kunci akun Anda dan ganti seluruh string body yang dipersingkat dengan konten dari captcha-base64.txt sebelum menjalankan python solve_image.py.
import capsolver
capsolver.api_key = "..."
solution = capsolver.solve({
"type": "ImageToTextTask",
"module": "common",
"body": "/9j/4AAQSkZJRgABA......"
})
print(solution)
Kunci dan string gambar yang ditunjukkan adalah placeholder dokumentasi. Menjalankannya tanpa perubahan tidak dapat menghasilkan hasil pengenalan yang berguna. Langkah persiapan terpisah di atas menyediakan nilai gambar nyata; akun Anda menyediakan kunci.
Bidang tugas memiliki tujuan kecil dan spesifik:
| Field | Apa yang disediakan |
|---|---|
type |
ImageToTextTask |
module |
common untuk contoh umum yang ditunjukkan di sini |
body |
Konten gambar yang dienkripsi Base64 lengkap |
websiteURL |
URL halaman sumber opsional, seperti yang didokumentasikan untuk tugas ini |
Dokumentasi resmi juga menjelaskan modul number untuk gambar numerik. Pilih hanya ketika gambar berisi angka dan mode yang didokumentasikan sesuai dengan kasus penggunaan Anda. Jangan menebak nama modul tambahan atau menyalin modul dari tugas pengenalan yang tidak relevan.
Jika Anda lebih suka integrasi HTTP nanti, tugas pengenalan yang sama dikirimkan melalui createTask. SDK Python adalah cara yang nyaman untuk membuat pemanggilan tersebut tanpa menulis pengelolaan permintaan HTTP sendiri.
Klaim Kode Bonus CapSolver Anda
Tingkatkan anggaran otomatisasi Anda secara instan!
Gunakan kode bonus CAP26 saat menambahkan dana akun CapSolver Anda untuk mendapatkan bonus tambahan 5% pada setiap penambahan dana โ tanpa batas.
Klaim sekarang di Dasbor CapSolver Anda
ImageToTextTask mengembalikan output pengenalan langsung alih-alih memerlukan siklus getTaskResult terpisah.
Dokumentasi respons HTTP menempatkan karakter yang dikenali di bawah solution.text. Contoh SDK mengembalikan objek solusi; panduan CAPTCHA gambar Python yang ada membaca teksnya dengan solution.get("text").
Periksa respons aktual sebelum menggunakannya. Hasil yang berhasil harus berisi karakter yang dikenali untuk gambar yang Anda kirimkan. Kesalahan, hasil yang hilang, atau nilai kosong bukanlah jawaban yang dimasukkan ke formulir.
Jangan tambahkan loop polling umum yang dicopy dari tutorial token reCAPTCHA. Tugas ini dapat memiliki perilaku respons yang berbeda. Polling tambahan tidak meningkatkan hasil gambar yang sudah dikembalikan langsung.
Juga bedakan pengenalan dari pengiriman formulir. Mencetak solusi memastikan bahwa skrip Anda mendapatkan hasil dari langkah penyelesaian. Aplikasi yang mengelilinginya masih perlu memasukkan teks tersebut ke bidang yang tepat dan memeriksa respons formulir.
Gunakan teks yang dikenali hanya untuk upaya formulir yang menyediakan gambar.
Misalkan formulir yang diizinkan menampilkan gambar A. Skrip Anda menangkap A, mengirimkannya ke CapSolver, dan menerima jawaban. Jika halaman segar ke gambar B saat permintaan sedang diproses, jawaban untuk A tidak lagi menjadi input yang andal untuk formulir saat ini.
Jaga hubungan halaman dan gambar tetap jelas. Selesaikan upaya saat ini sebelum meminta tantangan baru secara sengaja. Jika segar terjadi, tangkap gambar pengganti dan anggap sebagai upaya baru daripada mengirim ulang jawaban sebelumnya.
Simpan karakter yang dikembalikan oleh solver. Jangan secara otomatis mengubah huruf kecil, menghapus nol di depan, atau mengonversi jawaban menjadi angka kecuali formulir tujuan secara eksplisit membutuhkan transformasi tersebut. Nilai teks dan nilai numerik dapat mewakili input yang berbeda.
Setelah pengiriman, periksa hasil yang diharapkan. Untuk formulir pencarian yang Anda miliki, itu mungkin panel hasil yang diminta. Untuk ujian QA, itu mungkin keadaan sukses khusus aplikasi. Kehilangan CAPTCHA adalah bukti yang berguna, tetapi bukan selalu hasil bisnis lengkap.
Perbaikan tercepat datang dari memeriksa gambar, permintaan, dan formulir dalam urutan ini.
Pastikan body berisi byte gambar yang dienkripsi Base64. Hapus awalan data:image/...;base64, jika sumber gambar menambahkannya, dan hindari baris baru. Pastikan file adalah gambar, bukan halaman HTML atau unduhan kosong.
Gunakan referensi kesalahan CapSolver untuk kode yang sebenarnya dikembalikan. Masalah kunci akun, tugas yang tidak didukung, dan permintaan gambar yang tidak valid memerlukan perbaikan berbeda. Jangan terus mengirim input yang ditolak tanpa memeriksa kesalahan.
Periksa gambar yang dikirim ke API secara tepat. Cari karakter yang dipotong, gambar lama, atau teks yang tidak relevan dalam tangkapan. Periksa apakah modul yang dipilih sesuai dengan konten karakter.
Simpan contoh diagnostik terbatas dari uji coba Anda sendiri, dengan konten halaman sensitif dikecualikan. Itu lebih berguna untuk menyelidiki kualitas pengenalan daripada screenshot seluruh browser setelah tantangan berubah.
Periksa apakah gambar segar, apakah jawaban dimasukkan ke bidang yang benar, dan apakah aplikasi melaporkan kesalahan validasi formulir terpisah. Bidang yang diperlukan atau status formulir yang kedaluwarsa dapat mencegah pengiriman meskipun karakter yang dikenali tampak benar.
Gunakan kebijakan ulang yang terbatas. Jika kegagalan yang sama terulang, hentikan dan periksa penyebabnya alih-alih menghasilkan gambar baru dan membeli hasil lain secara tak terbatas.
Jaga pengelolaan CAPTCHA gambar Python kecil: persiapkan gambar saat ini, kirim ImageToTextTask, baca teks yang dikembalikan, dan verifikasi upaya formulir yang sesuai.
CapSolver menangani langkah pengenalan. Skrip Anda menyediakan gambar yang valid dan menjaga jawaban terkait operasi yang tepat, yang membuat hasil berguna dalam alur kerja otomatisasi nyata.
P: Apakah ImageToTextTask memerlukan polling hasil?
Tidak. Tugas ini mengembalikan hasil pengenalan gambar secara langsung. Ikuti perilaku respons yang didokumentasikan alih-alih menambahkan loop polling yang ditujukan untuk tugas token asinkron.
P: Bisakah saya mengirim URL gambar sebagai body?
Tidak. Input body yang didokumentasikan adalah konten gambar yang dienkripsi Base64. Peroleh byte gambar yang diizinkan terlebih dahulu, lalu enkripsi.
P: Nilai apa yang berisi teks yang dikenali?
Hasil HTTP menggunakan solution.text. Dalam pola SDK Python resmi, baca teks dari objek solusi yang dikembalikan.
P: Apakah contoh ini dapat menyelesaikan checkbox reCAPTCHA?
Tidak. ImageToTextTask adalah tugas pengenalan teks. Widget reCAPTCHA membutuhkan integrasi reCAPTCHA yang sesuai alih-alih screenshot yang dikirim ke contoh ini.
P: Mengapa formulir menolak jawaban yang tampak benar?
Jawaban mungkin milik gambar sebelumnya, dimasukkan ke bidang yang salah, atau disertai nilai formulir lain yang tidak valid. Periksa formulir saat ini dan respons aktual sebelum menyalahkan pengenalan gambar.

Nikolai Smirnov
Software Development Lead
Building dependable software for complex automation.
TENTANG PENULIS
Pahami tugas CAPTCHA tanpa proxy, ketika proxy yang disediakan diperlukan, dan cara memilih tugas CapSolver yang tepat untuk alur kerja browser atau API Anda.

Memahami token CAPTCHA, cookies, dan hasil solver, termasuk reCAPTCHA, Turnstile, kedaluwarsa, konteks browser, dan pemeriksaan yang memastikan penyelesaian.
