Tencent Cloud International Account: Tutorial integrasi API pengenalan teks OCR: pelaksanaan pantas pengenalan dokumen dan sijil
Dalam pembangunan perisian hari ini dan transformasi digital perusahaan,
OCR (Pengiktirafan Watak Optik)
Ini pasti fungsi frekuensi tinggi dan hanya diperlukan. Sama ada pengenalan kad pengenalan pengguna semasa pengesahan nama sebenar, kemasukan invois secara automatik oleh sistem kewangan, atau elektronik dokumen kertas dengan cepat, OCR dapat membantu kita menjimatkan banyak kos kemasukan manual.
Terdapat banyak perkhidmatan OCR di pasaran, tetapi dari
Ketepatan pengecaman, liputan dokumen/bil domestik dan kestabilan antara muka
Dari sudut pandang, perkhidmatan pengenalan kata (OCR) Tencent Cloud selalu berada di eselon pertama.
Artikel hari ini, dari perspektif pembangun sebenar, saya akan membawa anda menyelesaikannya
Integrasi dan Pembangunan Tencent Cloud OCR API
, Bawa anda dengan cepat menyedari pengenalan automatik dokumen umum dan pelbagai dokumen!
1. Mengapa memilih Tencent Cloud OCR?
Sebelum menulis kod secara rasmi, mari kita bincangkan mengapa banyak syarikat dan pembangun memberi keutamaan kepada Tencent Cloud OCR ketika memilih model:
Kategori ini sangat kaya: Selain percetakan umum asas dan pengenalan tulisan tangan, ia juga secara khusus mengoptimumkan model mendalam untuk puluhan senario tertentu seperti kad pengenalan, lesen memandu, lesen perniagaan, invois cukai nilai tambah, dan kad bank, dengan ketepatan yang sangat tinggi.
Di luar kotak, tindak balas sangat cepat: tidak perlu melatih model pembelajaran mendalam sendiri, hubungi API RESTful atau SDK rasmi secara langsung, dan kembalikan hasil JSON berstruktur dalam milisaat.
Jaminan keselamatan dan pematuhan: Untuk maklumat dokumen sensitif seperti kad pengenalan, Tencent Cloud menyediakan transmisi keselamatan data standard tinggi dan mekanisme perlindungan pematuhan.
💡Petua pra-persiapan: Sebelum memanggil Tencent Cloud API, anda perlu mempunyai akaun Tencent Cloud yang telah menyelesaikan pengesahan nama sebenar dan membuka perkhidmatan OCR. Sekiranya anda adalah pasukan korporat, penyedia perkhidmatan, atau perlu membeli sumber daya pengkomputeran secara berkumpulan, disarankan untuk membeli dan membuka akaun Tencent Cloud melalui saluran rasmi. Ini bukan sahaja memudahkan penginvoisan dan pengurusan bersatu, tetapi juga sering menikmati potongan dan seni bina pakej eksklusif yang lebih menjimatkan. Sokongan akses guru.
2. Kerja persiapan bersepadu
Sebelum menulis kod Python/Java, kita perlu mendapatkan "kunci" yang diperlukan untuk memanggil API di konsol awan Tencent:
1. Dapatkan kunci (SecretId dan SecretKey)
Log masuk ke Tencent Cloud Console dan masukkan Pengurusan Akses (CAM) -> Pengurusan Kunci API.
Klik "Kunci Baru" dan sistem akan menghasilkan sepasang SecretId dan SecretKey secara automatik.
Catatan: Kedua-dua kunci ini adalah satu-satunya sijil pengenalan untuk memanggil API. Jangan menyandikan kod ke kod front-end dalam teks biasa atau menyerahkannya ke gudang awam GitHub!
2. Buka perkhidmatan OCR dan kuota percuma
Masukkan konsol Tencent Cloud OCR dan buka perkhidmatan pengenalan yang perlu anda gunakan (contohnya: pengenalan kad pengenalan
IDCardOCR
Atau pengenalan badan cetak sejagat
GeneralBasicOCR
)。 Tencent Cloud biasanya memberi pengguna baru kuota percuma bulanan tertentu, yang sangat sesuai
Ujian pembangunan bersama.
3. Latihan pertempuran sebenar: Python dengan cepat mengintegrasikan Tencent Cloud OCR
Seterusnya kami menggunakan yang paling popular dan terpelihara
Tencent Cloud SDK Rasmi (TencentCloud SDK untuk Python)
Datang untuk pertempuran sebenar.
Langkah 1: Memasang SDK Rasmi
Buka terminal atau baris arahan, jalankan arahan berikut untuk memasang Python SDK:
Pip install tenentcloud-sdk-python
Langkah 2: Pelaksanaan kod teras (ambil pengenalan kad pengenalan sebagai contoh)
Pengecaman kad pengenalan adalah keperluan yang paling biasa di tempat kejadian. Tencent Cloud OCR secara automatik dapat mengenal pasti nama, jantina, etnik, tarikh lahir, alamat, nombor ID, dan bahkan menilai bahagian depan dan belakang kad pengenalan dan amaran.
Buat satu
Ocr_demo.py
Fail, tulis kod berikut:
Import base64
Import json
Ferro m tencentcloud.com mon port credential
Fro m tencentcloud.com mon.profile.client_profile import ClientProfile
Fero m tencentcloud.com mon.profile.http_profile import HtpProfile
Fro m tencentcloud.com mon.exception.tencent_cloud_sdk_exception Import TencentClouddSDKException
Dari tencentcloud.ocr.v20181119 import ocr_client, models
Def recognize_id_card(image_path):try:
#1. Permulaan kunci (disyorkan untuk membaca dari pemboleh ubah persekitaran atau fail konfigurasi, jangan pengekodan keras)
Secret_id = "YOUR_SECRET_ID"
Secret_key = "YOUR_SECRET_KEY"
Cred = credential.Credential(secret_id, secret_key)
#2.
Konfigurasi pilihan HTTP dengan sifat pelanggan
httpProfil = HttpProfile()
httpprofile. endpoint = "ocr.tencentcloudapi.com" # OCR nama domain API
ClientProfile = ClientProfile()
Profil client. httpfile = httpProfil
#3. Nyatakan pelanggan OCR (kawasan yang ditentukan, seperti ap-guangzhou Guangzhou)
Client = ocr_client.OcrClient(cred, "ap-guangzhou", clientProfile)
#4. Tukar gambar tempatan ke kod Base64 (anda juga boleh memuat naik URL rangkaian awam gambar secara langsung) dengan terbuka (image_path, "rb") sebagai f:
Base64_data = base64.b64encode(f.read()).decode("utf-8")
#5. Membina objek permintaan
Req = models.IDCardOCRRequest()
Params = {
"ImageBase64": base64_data,
"CardSide": "FRONT" # FRONT bermaksud wajah potret, BACK bermaksud wajah lambang kebangsaan
}
& N
Bsp; req.from_json_string(json.dumps(params))
#6. Memulakan permintaan API
Resp = client.IDCardOCR(req)
#7. Menganalisis dan mengeluarkan hasil
Result = json.loads(resp.to_json_string())
Cetak ("--- hasil pengiktirafan ---")
Cetak (f "nama: {result.get('Name')}")
Print (f "jantina: {result.get('Sex')}")
Cetak (f "nombor ID: {result.get('IdNum')}")
Cetak (f "alamat: {result.get('Address')}")
Kembali segar
Except TencentCloudSDKException as err:
Cetak (f "Pengecualian panggilan API: {err}")
# Ujian dijalankan jika __name__ = = "__main__":
Recognize_id_card ("my_id_card.jpg")
Langkah 3: Sambungan Pengenalan Dokumen/Borang Umum
Sekiranya anda perlu mengenal pasti dokumen kertas, PDF atau jadual, anda hanya perlu menukar kaedah API. Contohnya menggunakan
Pengenalan percetakan sejagat (GeneralBasicOCR)
:
# Cukup ganti objek permintaan dan kaedah panggilan
Req = models.GeneralBasic
OCRRequest()
Params = {"ImageBase64": base64_data}
Req. from_json_string(json.dumps(params))
Resp = client.GeneralBasicOCR(req)
# Resp akan mengandungi koordinat kedudukan blok teks (Polygon) dan kandungan teks yang dikenal pasti
4. Panduan untuk mengelakkan lubang di persekitaran pengeluaran
Semasa benar-benar melancarkan fungsi OCR ke dalam persekitaran pengeluaran, terdapat beberapa titik pengoptimuman yang sangat kritikal yang dapat membantu anda meningkatkan kestabilan dan pengalaman sistem:
Pra-pemprosesan dan pemampatan gambar Tencent Cloud API mempunyai had pada ukuran gambar yang masuk (Base64 biasanya tidak melebihi 7MB/10MB setelah pengekodan). Cadangan: Bahagian depan atau pelayan harus melakukan penskalaan dan pemampatan JPEG yang sesuai sebelum memuat naik, yang bukan hanya dapat mengelakkan had yang berlebihan, tetapi juga dapat mengurangkan masa penghantaran rangkaian yang memakan masa dan meningkatkan kelajuan tindak balas.
Keutamaan adalah mengesyorkan penghantaran URL. Sekiranya gambar anda telah disimpan dalam penyimpanan objek (seperti Tencent Cloud COS), cuba pindahkan URL gambar dan bukannya rentetan Base64, yang dapat mengurangkan penggunaan memori pelayan dan tekanan lebar jalur rangkaian.
Mekanisme kerja lebih masa dan percubaan semula tidak dapat dielakkan. Semasa memanggil pelanggan, disarankan untuk menetapkan waktu tamat yang wajar (seperti 3 ~ 5 saat), dan tangkap TencentCloudSDKException dalam kod untuk melaksanakan ujian semula penghindaran eksponensial.
Keselamatan dan kepatuhan data sensitif Setelah mengenal pasti data privasi peribadi seperti kad pengenalan dan kad bank, ingatlah untuk tidak mencetak nombor kad lengkap dan bidang sensitif dalam teks biasa di log. Sebaiknya lakukan proses desensitisasi sebelum membuat pesanan.
Ringkasan
Melalui operasi praktikal artikel ini, anda dapat melihat bahawa mengintegrasikan API pengenalan teks Tencent Cloud OCR sebenarnya sangat mudah. Hanya berpuluh-puluh baris kod Python yang dapat dengan cepat membina kemampuan pengenalan dokumen dan dokumen yang kuat.
Sama ada membina sistem pejabat automatik perusahaan atau mengembangkan aplikasi/program kecil yang berorientasikan pengguna, Tencent Cloud OCR dapat memberikan ketepatan dan kestabilan yang sangat tinggi. Sekiranya anda bersiap untuk mengakses fungsi yang berkaitan dalam projek, disarankan untuk membuat penilaian seni bina dan kekuatan pengkomputeran terlebih dahulu, dan memilih formal
Pembelian akaun Tencent Cloud
Dengan saluran perkhidmatan, ia bukan sahaja dapat mengurangkan kos operasi dan penyelenggaraan awal, tetapi juga memastikan ketersediaan pengembangan perniagaan seterusnya yang tinggi!
