نظرة عامة على API

استخدم FreeAIOCR API لاستخراج النصوص والجداول من الصور. اختر مرجع الواجهة المناسب أعلاه لمعرفة المدخلات والصيغ المدعومة.

البدء السريع

1. تحقق من البريد الإلكتروني لحسابك
2. أنشئ مفتاح API في إعدادات المفاتيح واحفظه بأمان؛ سيظهر مرة واحدة فقط
3. أضف $5 إلى رصيد API. تشترك مفاتيح الحساب في الرصيد، وهو منفصل عن اشتراكات الموقع ولا تنتهي صلاحيته
4. أرسل الطلب أدناه من خادمك بعد استبدال YOUR_API_KEY و document.png
5. راجع النص المستخرج واستخدام الرموز وتكلفة العملية في الاستجابة

المصادقة

Authorization: Bearer YOUR_API_KEY

استخدم Bearer عبر HTTPS واحتفظ بالمفتاح على الخادم. لا تدعم الواجهة استدعاءات المتصفح عبر النطاقات؛ لا تضع المفتاح في شفرة عامة.

إرسال أول طلب

استخدم POST ومفتاح Bearer وملفاً واحداً فقط في الحقل image. استبدل YOUR_API_KEY وdocument.png أدناه. دع cURL يضبط Content-Type وحدود multipart. يُقبل معامل الاستعلام الاختياري format فقط؛ لا تُقبل حقول نموذج إضافية أو إعدادات نموذج. اتصل من خادمك؛ لا تدعم الواجهة طلبات المتصفح عبر النطاقات. لا تنشر المفتاح.

curl --silent --show-error --include --max-time 150 \
  'https://freeaiocr.com/api/v1/image-to-text' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Idempotency-Key: example-request-0001' \
  -F 'image=@document.png'

قراءة الاستجابة

استجابة JSON التالية مثال؛ يعتمد النص وعدد الرموز الفعلي على الصورة.

{
  "request_id": "b2c8ec98-2a36-4f87-99d2-3d7839b92518",
  "text": "# Document title\n\nRecognized paragraph.\n\n| Item | Count |\n| --- | --- |\n| Books | 12 |",
  "usage": {
    "input_tokens": 2000,
    "output_tokens": 4000
  },
  "billing": {
    "currency": "USD",
    "price_version": "2026-10-26-v1",
    "base_usd": "0.002000000",
    "input_overage_usd": "0.000000000",
    "output_overage_usd": "0.002400000",
    "total_usd": "0.004400000"
  }
}

إعادة المحاولة بأمان

في أخطاء الشبكة، أعد المحاولة بمعرّف Idempotency-Key نفسه والصورة الأصلية. استخدم معرّفاً جديداً لعملية جديدة، ولا تبدأ عملية أخرى إذا كانت نتيجة الطلب السابق أو رسومه غير مؤكدة. راجع استراتيجية إعادة المحاولة للتفاصيل.

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