حساب Tencent Cloud International: برنامج تعليمي متكامل لواجهة برمجة تطبيقات التعرف على النص OCR: تحقيق التعرف على المستندات والمستندات بسرعة

سحابة 2026-07-24 阅读 4
1

في تطوير البرمجيات والتحول الرقمي للمؤسسات اليوم ،

OCR (التعرف الضوئي على الأحرف)

بالتأكيد وظيفة عالية التردد ومتحاجة فقط. سواء كان ذلك لتحديد هوية المستخدم أثناء مصادقة الاسم الحقيقي ، أو إدخال النظام المالي تلقائيًا للفواتير ، أو إضفاء الطابع الإلكتروني السريع على المستندات الورقية ، يمكن أن يساعدنا التعرف الضوئي على الحروف في توفير الكثير من تكلفة الإدخال اليدوي.

هناك العديد من خدمات OCR في السوق ، ولكن من

دقة تحديد الهوية ، وتغطية الوثائق/الفواتير المحلية ، واستقرار الواجهة

بالنظر إلى ذلك ، كانت خدمة التعرف على النص (OCR) الخاصة بـ Tencent Cloud في المستوى الأول.

مقال اليوم ، سأأخذك من منظور مطور حقيقي

تكامل وتطوير واجهة برمجة تطبيقات Tencent Cloud OCR

، يأخذك بسرعة إلى التعرف الآلي على المستندات العامة والمستندات المختلفة!

1. لماذا اخترت Tencent Cloud OCR ؟

قبل كتابة الكود رسميًا ، دعنا نتحدث عن سبب إعطاء العديد من الشركات والمطورين الأولوية لـ Tencent Cloud OCR عند اختيار النموذج:

الفئة غنية للغاية: بالإضافة إلى الطباعة العامة الأساسية والتعرف على الكتابة اليدوية ، فقد تم أيضًا تحسين النموذج المتعمق لعشرات السيناريوهات المحددة مثل بطاقات الهوية ورخص القيادة ورخص العمل وفواتير ضريبة القيمة المضافة والبطاقات المصرفية ، وما إلى ذلك ، ومعدل الدقة مرتفع للغاية.

يتم استخدامه من خارج الصندوق ، والاستجابة سريعة للغاية: ليست هناك حاجة لتدريب نموذج التعلم العميق بنفسك ، واستدعاء RESTful API مباشرة أو SDK الرسمي ، ويتم إرجاع نتائج JSON المنظمة على مستوى ميلي ثانية.

ضمان الأمان والامتثال: بالنسبة لمعلومات المستندات الحساسة مثل بطاقات الهوية ، توفر Tencent Cloud آلية عالية المستوى لنقل أمان البيانات وحماية الامتثال.

💡نصيحة التحضير المسبق: قبل الاتصال بـ Tencent Cloud API ، تحتاج إلى الحصول على حساب Tencent Cloud الذي أكمل مصادقة الاسم الحقيقي وفتح خدمة التعرف الضوئي على الحروف. إذا كنت فريقًا من الشركات أو مزود خدمة أو بحاجة إلى شراء كميات كبيرة من الموارد ، فمن المستحسن شراء وفتح حساب Tencent Cloud من خلال القنوات الرسمية. وهذا لن يسهل فقط إصدار الفواتير والإدارة الموحدة ، ولكن غالبًا ما تتمتع أيضًا بخصومات حزمة حصرية أكثر فعالية من حيث التكلفة ودعم وصول المهندس المعماري.

2. التحضير المسبق المتكامل

قبل كتابة كود Python/Java ، نحتاج إلى الحصول على "المفتاح" الضروري لاستدعاء API في وحدة التحكم السحابية Tencent:

1. الحصول على مفاتيح (SecretId و SecretKey)

قم بتسجيل الدخول إلى Tencent Cloud Console وأدخل إدارة الوصول (CAM) -> إدارة مفتاح API.

انقر فوق "مفتاح جديد" ، سيقوم النظام تلقائيًا بإنشاء زوج من SecretId و SecretKey.

ملاحظة: هذان المفتاحان هما قسائم الهوية الفريدة التي تستدعي واجهة برمجة التطبيقات. لا ترمز أبدًا إلى رمز الواجهة الأمامية أو ترفعه إلى مستودع GitHub العام!

2. فتح خدمات OCR وحصص مجانية

أدخل Tencent Cloud OCR Console وافتح خدمات التعريف التي تحتاج إلى استخدامها (على سبيل المثال: التعرف على الهوية

IDCardOCR

أو التعرف على الطباعة العامة

GeneralBasicOCR

). عادةً ما توفر Tencent Cloud للمستخدمين الجدد مبلغًا مجانيًا شهريًا معينًا ، وهو مناسب جدًا

اختبار التطوير المشترك.

3. التدريبات القتالية الفعلية: بيثون تدمج بسرعة Tencent Cloud OCR

بعد ذلك ، نستخدم الأكثر شعبية والأكثر صيانة

SDK الرسمي لـ TencentCloud (TencentCloud SDK لـ Python)

تعال للقتال الفعلي.

الخطوة 1: تثبيت SDK الرسمي

افتح المحطة الطرفية أو سطر الأوامر ، قم بتشغيل الأمر التالي لتثبيت Python SDK:

Pip install tencentcloud-sdk-python

الخطوة 2: تنفيذ الكود الأساسي (مع تحديد الهوية ، على سبيل المثال)

التعرف على بطاقة الهوية هو المطلب الأكثر شيوعًا في المشهد. يمكن لـ Tencent Cloud OCR التعرف تلقائيًا على الاسم والجنس والعرق وتاريخ الميلاد والعنوان ورقم الهوية ، وحتى تحديد الجانب الأمامي والالخلفي من بطاقة الهوية والتحذيرات.

إنشاء واحد

Ocr_demo.py

ملف ، اكتب التعليمات البرمجية التالية:

Import base64

Import json

Pro m tencentcloud.com mon import credential

M tencentcloud.com pro mon.profile.client_profile import ClientProfile

M tencentcloud.com fro mon.profile.http: _profile import HttpProfile

M tencentcloud.com fro mon.exception.tencent_cloud_sdk_exception import TencentCloudSDKException

من tencentcloud.ocr.v20181119 import ocr_client, models

Def recognize_id_card(image_path):try:

#1. التهيئة الرئيسية (يوصى بقراءتها من متغيرات البيئة أو ملفات التكوين ، لا تشفيرها أبدًا)

Secret_id = "YOUR_SECRET_ID"

Secret_key = "YOUR_SECRET_KEY"

Cred = credential.Credential(secret_id ، secret_key)

#2.

تكوين خيارات HTTP مع خصائص العميل

http: Profile = HttpProfile()

http: Profile.endpoint = "ocr.tencentcloudapi.com" # OCR API المجال

ClientProfile = ClientProfile()

ClientProfile. http:/p.

#3. مثيل عميل OCR (منطقة محددة ، مثل ap-guangzhou قوانغتشو)

Client = ocr_client.OcrClient(cred ، "ap-guangzhou" ، ملف تعريف client)

#4. تحويل الصورة المحلية إلى رمز Base64 (يمكن أيضًا نقل عنوان URL العام للصورة مباشرة) withopen(image_path ، "rb") as f:

Base64_data = base64.b64encode(f.read()).decode("utf-8")

#5-بناء كائن الطلب

Req = models.IDCardOCRRequest()

Params = {

"ImageBase64": base64_data ،

"CardSide": "FRONT" # FRONT تعني سطح الصورة ، BACK تعني سطح الشعار الوطني

}

& N

Bsp; req.from_json_string(json.dumps(params))

#6. بدء طلب API

Resp = client.IDCardOCR(req)

#7-تحليل وإخراج النتائج

Result = json.loads(resp.to_json_string())

Print ("--- تحديد النتيجة ---")

Print (f "الاسم: {result.get('Name')}")

Print (f "الجنس: {result.get('Sex')}")

Print (f "رقم الهوية: {result.get('IdNum')}")

Print (f "العنوان: {result.get('Address')}")

Return result

Except TencentCloudSDKException as err:

Print (f "استثناء استدعاء API: {err}")

# اختبار التشغيل if __name__ = = "__main__":

Recognize_id_card ("my_id_card.jpg")

الخطوة 3: ملحق التعرف على المستندات/الجداول العامة

إذا كنت بحاجة إلى تحديد المستندات الورقية أو ملفات PDF أو النماذج ، ما عليك سوى تبديل طريقة واجهة برمجة التطبيقات. على سبيل المثال استخدام

التعرف على الطباعة العامة (GeneralBasicOCR)

:

# فقط بحاجة إلى استبدال كائن الطلب وطريقة الاتصال

Req = models.GeneralBasic

OCRRequest()

Params = {"ImageBase64": base64_data}

Req. from_json_string(json.dumps(params))

Resp = client.GeneralBasicOCR(req)

# Resp سوف تحتوي على إحداثيات موضع كتلة النص (Polygon) ومحتوى النص المعترف به

4. دليل تجنب الحفر في بيئة الإنتاج

عند تشغيل وظيفة OCR بالفعل على الإنترنت في بيئة الإنتاج ، هناك العديد من نقاط التحسين المهمة للغاية التي يمكن أن تساعدك على تحسين استقرار النظام وخبره بشكل كبير:

المعالجة المسبقة للصور وضغطها ، لدى Tencent Cloud API قيود على حجم الصور الواردة (عادةً ما لا يتجاوز 7 ميجابايت/10 ميجابايت بعد ترميز Base64). اقتراح: تقوم الواجهة الأمامية أو الخادم بإجراء مقياس مناسب وضغط JPEG قبل التحميل ، والذي لا يمكن أن يتجنب تجاوز الحد ، ولكنه يقلل أيضًا بشكل كبير من وقت نقل الشبكة ويحسن سرعة الاستجابة.

التوصية أولاً بنقل عنوان URL. إذا تم تخزين صورتك في تخزين الكائن (مثل Tencent Cloud COS) ، فحاول نقل عنوان URL للصورة بدلاً من سلسلة Base64 ، مما يمكن أن يقلل بشكل كبير من مساحة ذاكرة الخادم وضغط عرض النطاق الترددي للشبكة.

الاهتزاز العرضي لشبكة آلية العمل الإضافي وإعادة المحاولة أمر لا مفر منه. عند استدعاء العميل ، يوصى بتعيين وقت مهلة معقول (مثل 3 ~ 5 ثوانٍ) ، والتقاط TencentCloudSDKException في الكود ، وتنفيذ مؤشر التراجع وإعادة المحاولة.

بعد أن يحدد الامتثال الأمني للبيانات الحساسة بيانات الخصوصية الشخصية مثل بطاقات الهوية والبطاقات المصرفية ، تذكر عدم طباعة أرقام البطاقات الكاملة والحقول الحساسة في السجل ، ويوصى بإجراء معالجة إزالة الحساسية قبل الإيداع.

الخلاصة

من خلال العملية الفعلية لهذه المقالة ، يمكنك أن ترى أن تكامل واجهة برمجة تطبيقات التعرف على النص OCR السحابية من Tencent بسيط للغاية في الواقع. يمكن لعشرات الأسطر فقط من كود Python إنشاء قدرات قوية لتحديد المستندات والمستندات بسرعة.

سواء كان الأمر يتعلق ببناء نظام مكتب آلي للمؤسسة أو تطوير تطبيقات/برامج صغيرة للمستهلكين ، يمكن أن يوفر OCR Cloud Tencent دقة واستقرار عالياً للغاية. إذا كنت تستعد للوصول إلى الوظائف ذات الصلة في المشروع ، فمن المستحسن إجراء تقييم للهيكل والحساب مقدمًا ، واختيار وظيفة رسمية

شراء حساب تينسنت كلاود

مع قنوات الخدمة ، لا يمكن فقط تقليل تكاليف التشغيل والصيانة الأولية ، ولكن أيضًا ضمان التوسع العالي المتاح لأعمال المتابعة!

1
← 返回新闻中心