---
title: "استخراج بيانات الفواتير العربية عبر API نموذج رؤية | BroadRouter"
description: "أرسل صورة فاتورة أو إيصال إلى نموذج رؤية على BroadNet Inference واحصل على الإجمالي والتاريخ واسم المورّد بصيغة JSON، مع أسئلة بالعربية أو الإنجليزية."
url: https://broadrouter.com/ar/guides/read-arabic-invoices-with-vision/
lang: ar
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

تُرجمت هذه الصفحة من الإنجليزية بمساعدة الذكاء الاصطناعي. [اقرأ الأصل الإنجليزي](https://broadrouter.com/guides/read-arabic-invoices-with-vision/) (حُدّث في 2026-11-16).

# قراءة الفواتير والإيصالات العربية بنموذج رؤية

آخر تحديث 2026-11-16

أرسل الصورة كعنوان data URL بترميز base64 داخل محتوى الرسالة إلى نموذج رؤية مثل broadnet/qwen3.8-27b أو broadnet/gemma-4-26b-a4b، واطلب الحقول التي تحتاجها بصيغة JSON. احرص على دقة نوع MIME. وفي الدفع حسب الاستخدام تُحتسب الصورة رموز إدخال؛ والصور الأكبر تستهلك رموزًا أكثر.

ثلاثة نماذج محادثة على BroadNet Inference تقبل الصور: DeepSeek V4.1 Flash وQwen3.8 27B وBroadNet Gemma 4 VL 26B. أما GLM 5.3 فنصّي فقط. وللمستندات العربية، فإن Qwen3.8 27B هو النموذج الذي اختبره BroadNet بالعربية: كتابة سلسة، وفهم للهجتين الخليجية والمصرية، وترجمة دقيقة بين العربية والإنجليزية. ونموذج Gemma 4 VL 26B هو الأرخص بين الثلاثة على BroadNet ويعمل بالرصيد المجاني.

## اسأل سؤالًا عن فاتورة واحدة

```python
import base64, os
from openai import OpenAI

client = OpenAI(base_url="https://inference.broadnet.ai/v1", api_key=os.environ["BROADNET_API_KEY"])
invoice = base64.b64encode(open("invoice.jpg", "rb").read()).decode()

response = client.chat.completions.create(
    model="broadnet/gemma-4-26b-a4b",
    messages=[{"role": "user", "content": [
        {"type": "text", "text": "ما هو المبلغ الإجمالي في هذه الفاتورة؟"},
        {"type": "image_url", "image_url": {"url": "data:image/jpeg;base64," + invoice}},
    ]}],
)
print(response.choices[0].message.content)
```

السؤال في المثال مكتوب بالعربية: «ما هو المبلغ الإجمالي في هذه الفاتورة؟». استخدم `image/png` في عنوان data URL لملفات PNG: يجب أن يطابق نوع MIME نوع الملف. ولضبطه من اسم الملف:

```python
import mimetypes
mime = mimetypes.guess_type("invoice.png")[0]   # "image/png"
url = f"data:{mime};base64," + base64.b64encode(open("invoice.png", "rb").read()).decode()
```

## احصل على الحقول بصيغة منظَّمة

اطلب JSON وحدّد بالضبط المفاتيح التي تريدها:

```python
prompt = (
    "Read this invoice. Reply with JSON only, keys: vendor, date (YYYY-MM-DD), "
    "currency, total (number), vat (number or null). Keep the vendor name in Arabic if it is written in Arabic."
)
response = client.chat.completions.create(
    model="broadnet/qwen3.8-27b",
    max_tokens=2000,  # Qwen3.8 27B reasons first
    messages=[{"role": "user", "content": [
        {"type": "text", "text": prompt},
        {"type": "image_url", "image_url": {"url": "data:image/jpeg;base64," + invoice}},
    ]}],
)
```

يُجري Qwen3.8 27B استدلالًا منطقيًا قبل أن يجيب، فامنحه مساحة كافية. راجع [لماذا تُرجع نماذج الاستدلال إجابات فارغة](https://broadrouter.com/ar/guides/reasoning-tokens-empty-response/). تدرج وثائق BroadNet المخرجات المنظَّمة لنموذج Qwen3.8 27B؛ وراجع [المخرجات المنظَّمة](https://broadrouter.com/ar/glossary/structured-output/) لمعرفة كيف تعمل مخططات JSON عمومًا. حلّل الرد بـ `json.loads` وتحقّق من الحقول قبل تخزينها.

## التكلفة

في الدفع حسب الاستخدام، تُحتسب الصورة رموز إدخال بسعر الإدخال للنموذج، لذا صغّر الصور الكبيرة جدًا أولًا؛ وتبيّن [حاسبة رموز الصور](https://broadrouter.com/tools/image-token-calculator/) عدد الرموز التي يكلّفها حجم معيّن. أما في [خطة DeepSeek V4.1 Flash غير المحدودة](https://broadrouter.com/ar/guides/unlimited-llm-api-sessions/)، فالصور جزء من الاستخدام غير المحدود.

[قارن أسعار نماذج الرؤية](https://broadrouter.com/ar/pricing/)، أو اطّلع على كيفية مقارنة نموذج رؤية بخدمات Google وAzure وTextract وMistral OCR في [مقارنة واجهات API للتعرّف الضوئي على النصوص العربية (OCR)](https://broadrouter.com/ar/blog/arabic-ocr-api-comparison/).

## حل المشكلات

-   **إجابة فارغة من Qwen3.8 27B أو DeepSeek V4.1 Flash.** استهلك الاستدلال المنطقي `max_tokens` كاملًا. ارفعه أو اضبط `reasoning_effort` على `low`.
-   **400 أو 422 على الصورة.** تأكّد من أن عنوان data URL يبدأ بـ `data:image/jpeg;base64,` أو `data:image/png;base64,` وأن نوع MIME يطابق الملف.
-   **403 أو خطأ في النموذج.** لا يقبل GLM 5.3 الصور، ويحتاج Qwen3.8 27B وDeepSeek V4.1 Flash إلى شحن الرصيد. استخدم BroadNet Gemma 4 VL 26B بالرصيد المجاني.
-   **الطلب كبير جدًا أو أخطاء في السياق.** تستهلك الصورة الكبيرة رموزًا كثيرة، ولنموذج Gemma 4 VL 26B أصغر نافذة سياق بين الثلاثة (مدرجة في pricing.json). صغّر الصورة إلى عرض معقول أو اقتصّ منطقة الإجماليات.
-   **إجماليات خاطئة أو أرقام مبدّلة.** قد تظهر الأرقام العربية الهندية (٠١٢٣) والأرقام اللاتينية معًا في إيصال واحد. اطلب من النموذج إعادة الأرقام بالأرقام اللاتينية، وتحقّق من الإجماليات مقابل بنود الفاتورة في شيفرتك.
-   **JSON غير صالح.** اطلب «JSON فقط»، وأزل أي أسوار شيفرة (code fences) قبل التحليل، وأعد المحاولة مرة واحدة إذا فشل التحليل.

_[image: An Arabic and English invoice beside a phone showing the JSON {"total":125.00,"currency":"AED"}, with the text "From documents to structured data."]_

Illustrative example; the figures are not real output.

## مصطلحات في هذا الدليل

[الرمز (التوكن، Token)](https://broadrouter.com/ar/glossary/token/)

الرمز (التوكن) هو وحدة النص التي يقرؤها نموذج اللغة ويكتبها: كلمة، أو جزء من كلمة، أو علامة ترقيم، أو تسلسل بايتات ينتجه مجزّئ النموذج (tokenizer). وتَعُدّ واجهات LLM API الاستهلاك بالرموز، وتضع حدودها بها، وتحتسب تكلفتها بها عادةً.

[التعرّف الضوئي على الحروف (OCR)](https://broadrouter.com/ar/glossary/ocr/)

التعرّف الضوئي على الحروف (OCR) تقنية تكتشف النص المطبوع أو المكتوب بخط اليد في صورة أو مستند ممسوح أو ملف PDF وتحوّله إلى حروف قابلة للقراءة آليًا. يُخرج OCR التقليدي النص وموضعه في الصفحة، أما النماذج اللغوية البصرية فتقرأ النص وتجيب عن أسئلة حوله مباشرة.

[استدعاء الأدوات (Tool calling)](https://broadrouter.com/ar/glossary/tool-calling/)

استدعاء الأدوات، ويُسمّى أيضًا استدعاء الدوال (function calling)، ميزة في واجهات LLM API يُرجع فيها النموذج طلبًا منظَّمًا لتشغيل دالة عرّفها المطوّر، مع معاملات بصيغة JSON. ويشغّل التطبيق الدالة ويعيد النتيجة؛ فالنموذج لا يشغّل الشيفرة بنفسه أبدًا.

[الدفع حسب الاستخدام (Pay-as-you-go)](https://broadrouter.com/ar/glossary/pay-as-you-go/)

الدفع حسب الاستخدام هو نموذج تسعير تدفع فيه مقابل ما تستخدمه فقط، مقيسًا بوحدات مثل الرموز (التوكنات) أو الطلبات أو دقائق الصوت، دون اشتراك أو حد أدنى للالتزام. وتحتسب معظم واجهات LLM API تكلفتها بهذه الطريقة، من رصيد مدفوع مسبقًا أو بفاتورة دورية.

[الرصيد المدفوع مسبقًا (Prepaid credit)](https://broadrouter.com/ar/glossary/prepaid-credit/)

الرصيد المدفوع مسبقًا هو مال يُضاف إلى حساب API قبل الاستخدام. يُخصم من الرصيد ثمن كل طلب، وعندما ينفد الرصيد تتوقف الطلبات المحتسبة بالاستهلاك حتى تشحن رصيدك. وهو يحصر الإنفاق في حدود ما دفعته.

[رموز الصور (Image tokens)](https://broadrouter.com/ar/glossary/image-tokens/)

رموز الصور (image tokens) هي رموز الإدخال التي يستخدمها نموذج لغة بصري لتمثيل صورة في الطلب. يحسبها المزوّدون من حجم الصورة، غالبًا بتقسيمها إلى رقع أو مربعات ثابتة الحجم بعد تغيير مقاسها، ويحاسبون عليها كرموز إدخال النص، فتكلّف الصور الأكبر أكثر.

[نموذج الرؤية واللغة (Vision-language model)](https://broadrouter.com/ar/glossary/vision-language-model/)

نموذج الرؤية واللغة (VLM) نموذج يستقبل الصور والنص معًا مدخلاتٍ ويُنتج نصًا، فيستطيع وصف الصور والإجابة عن أسئلة حولها وقراءة المستندات والرسوم البيانية ولقطات الشاشة. وتُسمّى هذه النماذج أيضًا نماذج image-text-to-text أو النماذج متعددة الوسائط.

## أسئلة شائعة

### أي نماذج BroadNet تستطيع قراءة الصور؟

تقبل DeepSeek V4.1 Flash وQwen3.8 27B وBroadNet Gemma 4 VL 26B الصور عبر إكمال المحادثات. أما GLM 5.3 فنصّي فقط، ونماذج التفريغ الصوتي تستقبل الصوت.

### كيف أرسل ملف صورة محليًا إلى API نموذج رؤية؟

اقرأ الملف، ورمّزه بـ base64، وضعه في جزء محتوى image\_url كعنوان data URL، مثل data:image/jpeg;base64, متبوعًا بالبايتات المرمّزة. ويجب أن يطابق نوع MIME في العنوان نوع الملف.

### هل يمكنني استخراج بيانات الفواتير بالرصيد المجاني؟

نعم، باستخدام BroadNet Gemma 4 VL 26B الذي يعمل بالرصيد المبدئي المجاني. أما Qwen3.8 27B وDeepSeek V4.1 Flash فيتاحان بعد شحن الرصيد.

### هل يمكنني إرسال فاتورة بصيغة PDF؟

تصف وثائق BroadNet صورًا تُرسَل كعناوين data URL، لا ملفات PDF. حوّل كل صفحة من ملف PDF إلى JPEG أو PNG أولًا، مثلًا باستخدام pdftoppm، ثم أرسل الصفحات كصور.

## أدلة ذات صلة

-   [API لتحويل الصوت العربي إلى نص خطوة بخطوة](https://broadrouter.com/ar/guides/arabic-speech-to-text-api/)
-   [استخدام OpenAI Python SDK مع BroadNet Inference](https://broadrouter.com/ar/guides/openai-python-sdk/)
-   [لماذا يعيد نموذج الاستدلال إجابة فارغة؟](https://broadrouter.com/ar/guides/reasoning-tokens-empty-response/)

جرّبه على مهامك الفعلية. تبدأ الحسابات الجديدة برصيد قدره $5 لاستخدام Gemma والتفريغ الصوتي. أما DeepSeek وGLM وQwen3.8 فتتطلب شحن الرصيد.

[ابدأ الآن](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-guides-read-arabic-invoices-with-vision&utm_content=page-cta) ·

**المصادر**

-   [المرجع التقني لـ BroadNet Inference API، محادثة مع صورة (بالإنجليزية)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-guides-read-arabic-invoices-with-vision&utm_content=sources#requests)
-   [أسعار BroadNet Inference (ملاحظات اختبار Qwen3.8 27B بالعربية)](https://inference.broadnet.ai/ar/pricing?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-guides-read-arabic-invoices-with-vision&utm_content=sources)
-   [قائمة النماذج المقروءة آليًا مع الوسائط وطول السياق (pricing.json) (بالإنجليزية)](https://inference.broadnet.ai/pricing.json?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-guides-read-arabic-invoices-with-vision&utm_content=sources)
