Gemini API: ما أحجام الملفات وطرق الإدخال المدعومة حاليًا؟

في 12 يناير 2026 نشرت Google تحديثاً للمطورين لواجهة Gemini API يغيّر طريقة إدخال الملفات إلى النموذج وحجم الملفات المسموح به. باختصار: بات Gemini يجلب الملفات مباشرة من الروابط الخارجية ومخازن السحابة (لست مضطراً دائماً لرفعها)، وتم رفع حد حجم الملفات المضمّنة بشكل كبير. تُزيل هذه التحديثات الاحتكاك عن التطبيقات الواقعية التي تخزّن الوسائط أو المستندات في حاويات سحابية، وتجعل مسارات النمذجة السريعة والإنتاج أسرع وأقل تكلفة.

توفر CometAPI واجهات Gemini API مثل Gemini 3 Pro وgemini 3 flash، وبأسعار جذابة.

التحديثات الرئيسية — ما الجديد في Gemini API؟

1. قراءة الروابط الخارجية للملفات مباشرة — يستطيع Gemini جلب الملفات من:
   • عناوين HTTPS العامة والعناوين الموقّعة (عناوين S3 الموقّعة مسبقاً، Azure SAS، وغيرها).
   • تسجيل كائنات Google Cloud Storage (GCS) (سجّل كائناً في GCS مرة واحدة وأعد استخدامه).
2. زيادة حجم الملفات المضمّنة — ارتفع حد الحمولة المضمّنة داخل الطلب من 20 MB → 100 MB (ملاحظة: قد تختلف الحدود الفعلية قليلاً لبعض أنواع الملفات مثل PDF وفق ما هو مذكور في الوثائق).
3. Files API وإرشادات الدُّفعات غير متغيرة للملفات الكبيرة جداً — للملفات التي تنوي إعادة استخدامها أو التي تتجاوز حدود المضمن/الخارجي، استمر في استخدام Files API (الحد الأقصى لكل ملف 2 GB، ويمكن للمشاريع الاحتفاظ بما يصل إلى 20 GB من مساحة تخزين Files API؛ تُخزّن الملفات المرفوعة لمدة 48 ساعة افتراضياً). يدعم تسجيل GCS أيضاً الملفات الكبيرة (2 GB لكل ملف) ويمكن تسجيلها لإعادة الاستخدام.
4. ملاحظات توافق النماذج — قد تختلف بعض العائلات الأقدم أو النكهات المتخصصة في الدعم (تشير الوثائق إلى استثناءات مثل نماذج معينة من عائلة Gemini 2.0 لبعض مسارات file-URI). أكّد دائماً في وثائق النموذج المحددة قبل إرسال أصول كبيرة.

لماذا يهمّ تغيّر قدرات التعامل مع الملفات في Gemini API؟

قبل هذا التحديث، إذا أردت أن يحلل Gemini API (نموذج الذكاء الاصطناعي من Google) ملفات مثل: تقرير PDF؛ فيديو؛ ملف صوتي؛ أو بعض الصور؛ كان عليك أولاً رفع الملفات إلى التخزين المؤقت الخاص بـ Gemini.

وأيضاً:

• تُحذف الملفات المرفوعة بعد 48 ساعة؛
• لا يمكن أن تكون الملفات كبيرة جداً (الحد الأقصى 20MB)؛
• إذا كانت ملفاتك مستضافة بالفعل في السحابة (مثل GCS أو S3 أو Azure)، كان عليك إعادة رفعها — أمر غير عملي.

كان ذلك يضاعف جهد المطوّر، ويزيد تكاليف النطاق الترددي، ويُدخل زمناً إضافياً، وأحياناً يجعل حالات الاستخدام الواقعية (تسجيلات طويلة، كتيبات متعددة الصفحات، صور عالية الدقة) غير عملية. يجمع هذا التحديث بين حمولة مضمّنة أكبر وإمكانية توجيه Gemini إلى التخزين القائم (عبر عناوين عامة أو موقّعة، أو كائنات GCS المسجلة) ليقصر كثيراً المسافة من “البيانات” إلى “ناتج نموذجي مفيد”:

• كفاءة دون نسخ (Zero-Copy): بالسماح لـ Gemini بالقراءة مباشرة من حاويات التخزين لديك (GCS) أو من عناوين خارجية (AWS S3، Azure)، تتخلص من “ضريبة ETL”. لم تعد بحاجة لتنزيل ملف إلى خادمك الخلفي ثم إعادة رفعه إلى Google. النموذج يأتي إلى البيانات، لا العكس.
• هندسة بلا حالة (Stateless): يتيح حد 100MB المضمّن طلبات “بلا حالة” أكثر قوة. لن تحتاج لإدارة دورة حياة معرّف ملف أو القلق بشأن تنظيف الرفع لكل تفاعل.
• حياد متعدد السحابات (Multi-Cloud Agnosticism): يسمح دعم العناوين الموقّعة لـ Gemini API بالعمل بسلاسة مع بحيرات بيانات مستضافة على AWS أو Azure. هذا مكسب كبير للمؤسسات ذات استراتيجيات متعددة السحابات، إذ يمكنها الاستفادة من قدرات الاستدلال لدى Gemini دون نقل كامل بنية التخزين إلى Google Cloud.
• مناسب لتطبيقات الذكاء الاصطناعي متعددة الوسائط (مثل فهم الفيديو والصوت والمستندات).

تُبسّط هذه التحديثات عملية إدخال البيانات بشكل ملحوظ، مما يمكّن المطوّرين من إتاحة الوصول المباشر إلى البيانات الموجودة في السحابة أو الشبكة لـ Gemini دون خطوات رفع إضافية.

من يستفيد أكثر؟

• فرق المنتجات التي تبني ميزات تتمحور حول المستندات (تلخيص، أسئلة/أجوبة حول الكتيبات، مراجعة العقود).
• تطبيقات الوسائط/الترفيه التي تحلل الصور أو الأصول الصوتية أو المرئية المخزّنة بالفعل في السحابة.
• المؤسسات ذات بحيرات بيانات كبيرة في GCS التي تريد للنموذج الرجوع إلى النسخ المعيارية بدلاً من تكرارها.
• الباحثون والمهندسون الذين يريدون نمذجة سريعة ببيانات واقعية أكبر دون بناء خطوط تخزين معقدة.

باختصار: الانتقال من النموذج الأولي إلى الإنتاج يصبح أسهل وأرخص.

ما حجم الملف الذي يمكنك رفعه إلى Gemini API الآن؟

الرقم الرئيسي هو زيادة فورية بخمسة أضعاف في السعة، لكن القصة الحقيقية تكمن في المرونة التي توفّرها.

ما حجم الملف الذي يمكنك رفعه الآن إلى Gemini API عبر طرق مختلفة؟

• مضمّن داخل الطلب (base64 أو Part.from_bytes): حتى 100 MB (50 MB لبعض مسارات PDF المحددة). استخدمه عندما تريد تدفقاً بسيطاً بطلب واحد والملف ≤100 MB.
• عناوين HTTP الخارجية / عناوين موقّعة يجلبها Gemini: حتى 100 MB (سيجلب Gemini العنوان أثناء المعالجة). استخدمه لتجنّب إعادة رفع المحتوى من سُحُب خارجية.
• Files API (رفع): حتى 2 GB لكل ملف، تخزين ملفات المشروع حتى 20 GB، تُخزّن الملفات لمدة 48 ساعة. استخدمه للملفات الكبيرة التي ستعيد استخدامها أو التي تتجاوز حد 100 MB للمضمن/الخارجي.
• تسجيل كائنات GCS: يدعم حتى 2 GB لكل كائن ومخصص للملفات الكبيرة المستضافة بالفعل على Google Cloud؛ يتيح التسجيل إعادة الاستخدام دون رفع متكرر. يمكن منح الوصول عبر تسجيل لمرة واحدة لفترة محدودة.

(يعتمد الاختيار الدقيق على حجم الملف، وتكرار إعادة الاستخدام، وما إذا كان الملف موجوداً بالفعل في تخزين سحابي.)

معيار 100MB الجديد

بدءاً من الآن، زادت Gemini API حد حجم البيانات المضمّنة من 20MB إلى 100MB.

كان المطوّرون الذين يعملون مع صور عالية الدقة أو عقود PDF معقدة أو مقاطع صوتية بطول متوسط يصطدمون سابقاً بسقف 20MB. اضطرهم ذلك إلى تنفيذ حلول ملتوية مثل تجزئة البيانات، أو خفض دقة الوسائط، أو إدارة تدفق رفع منفصل عبر Files API حتى للتفاعلات الصغيرة نسبياً.

مع حد 100MB الجديد، يمكنك الآن إرسال حمولة أكبر بكثير مباشرة في طلب واجهة البرمجة (مشفّرة بـ base64). وهذا تحسين بالغ الأهمية لـ:

• التطبيقات الفورية: معالجة فيديو حجمه 50MB رفعه المستخدم فوراً لتحليل الانطباع دون انتظار اكتمال مهمة رفع غير متزامنة.
• النمذجة السريعة: إسقاط مجموعة بيانات معقدة أو ملف PDF لكتاب كامل في نافذة السياق لاختبار إستراتيجية التوجيه على الفور.
• تعدّد الوسائط المعقد: إرسال مزيج من صور 4K ومقاطع صوتية عالية الدقة في دورة واحدة دون القلق من الاصطدام بحد صارم.

من المهم ملاحظة أنه بينما حد البيانات المضمّنة هو 100MB، تبقى قدرة Gemini API على معالجة مجموعات بيانات هائلة (تيرابايتس) متاحة عبر Files API ودعم الروابط الخارجية الجديد، مما يزيل فعلياً الحد الأعلى للأعباء الثقيلة.

مخطط قرار موصى به

• إذا كان الملف ≤ 100 MB وتفضّل بساطة الطلب الواحد: استخدم المضمن (Part.from_bytes أو تزويد base64). مناسب للعروض السريعة أو الدوال الخالية من الخوادم.
• إذا كان الملف ≤ 100 MB وموجوداً بالفعل في مكان عام أو عبر عنوان موقّع مسبقاً: مرّر file_uri (HTTPS أو عنوان موقّع). لا حاجة للرفع.
• إذا كان الملف > 100 MB (و≤ 2 GB) أو تتوقع إعادة استخدامه: يُنصح بـ Files API أو تسجيل كائنات GCS — يقلّل الرفع المتكرر ويحسن زمن الاستجابة للتوليد المتكرر.

كيف يعمل دعم الروابط الخارجية للملفات الجديد؟

أكبر تغيير معماري هو قدرة Gemini API على “جلب” البيانات ذاتياً. هذه القدرة لقراءة الروابط الخارجية مباشرة، ودعم مصادر بيانات مدمجة.

يمكن للواجهة الآن إدخال البيانات مباشرة من عناوين URL. يغطي هذا الدعم سيناريوهين متميزين:

(1) دعم العنوان الخارجي (عام / عناوين موقّعة):

يمكنك الآن تمرير عنوان HTTPS قياسي يشير إلى ملف (مثل PDF أو صورة أو فيديو) مباشرة في طلب التوليد.

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

العناوين الموقّعة: هذا هو الجسر المؤسسي. إذا كانت بياناتك في حاوية AWS S3 خاصة أو Azure Blob Storage، يمكنك توليد عنوان موقّع مسبقاً (رابط مؤقت يمنح صلاحية القراءة). عند تمرير هذا العنوان إلى Gemini، تجلب الواجهة المحتوى بأمان أثناء المعالجة. يعني ذلك أنه يمكنك استخدام Gemini لتحليل مستندات حساسة مخزّنة في AWS دون نقلها بشكل دائم إلى خوادم Google.

يحترم أدوار IAM في Google Cloud، ما يعني أنه يمكنك التحكم بالوصول باستخدام صلاحيات "Storage Object Viewer" القياسية.

الفوائد: لا حاجة لملفات وسيطة، ما يحسن الأمان والأداء، ومناسب لجلب البيانات عبر بيئات السحابة المختلفة.

(2) اتصال مباشر بـ Google Cloud Storage (GCS):

بالنسبة للبيانات الموجودة أصلاً ضمن منظومة Google، التكامل أكثر إحكاماً. يمكنك الآن إجراء تسجيل كائن لملفات GCS.

بدلاً من الرفع، تقوم ببساطة بـ"تسجيل" عنوان gs:// للكائن.

هذه العملية شبه فورية لأن نقل بيانات فعلي لا يحدث بين عميلك والواجهة.

كيف تستخدم الميزات الجديدة؟ — أمثلة استخدام (Python SDK)

فيما يلي ثلاثة أمثلة Python عملية (متزامنة) توضّح الأنماط الشائعة: (A) بايتات مضمّنة (من ملف محلي)، (B) عنوان HTTPS خارجي أو عنوان موقّع، و(C) الإشارة إلى GCS URI (كائن مسجل). تستخدم هذه القصاصات حزمة Google الرسمية (google-genai). عدّل أسماء النماذج والمصادقة والمتغيرات البيئية لتناسب إعدادك. يمكنك استخدام مفتاح CometAPI للوصول إلى Gemini API، وهي منصة تجميع واجهات ذكاء اصطناعي تقدم أسعار مكالمات أقل لمساعدة المطوّرين.

المتطلبات المسبقة: pip install --upgrade google-genai وتعيين بيانات الاعتماد/المتغيرات البيئية (لواجهة المطورين API_KEY، ولـ Vertex AI عيّن GOOGLE_GENAI_USE_VERTEXAI، GOOGLE_CLOUD_PROJECT, GOOGLE_CLOUD_LOCATION).

المثال A: بايتات مضمّنة (ملف محلي → إرسال حتى 100 MB)

# Example A: send a local file's bytes inline (suitable up to 100 MB)from google import genaifrom google.genai import types​# Create client (Developer API)client = genai.Client(api_key="YOUR_GEMINI_API_KEY")​MODEL = "gemini-2.5-flash"  # choose model; production models may differ​file_path = "large_document.pdf"  # local file <= ~100 MBmime_type = "application/pdf"​# Read bytes and create an inline Partwith open(file_path, "rb") as f:    data = f.read()​part = types.Part.from_bytes(data=data, mime_type=mime_type)​# Send the file inline with a textual promptresponse = client.models.generate_content(    model=MODEL,    contents=[        "Please summarize the attached document in one paragraph.",        part,    ],)​print(response.text)client.close()

ملاحظات: يستخدم هذا Part.from_bytes(...) لتضمين بايتات الملف. يُسمح الآن بالحمولات المضمّنة حتى ~100MB. إذا تجاوزت ذلك، استخدم نهج GCS أو Files API.

المثال B: عنوان HTTPS خارجي / عنوان موقّع (يجلب Gemini الحمولة)

# Example B: reference a public HTTPS URL or a signed URL (Gemini fetches it)from google import genaifrom google.genai import types​client = genai.Client(api_key="YOUR_API_KEY")MODEL = "gemini-2.5-flash"​# Public or signed URL to a PDF/image/audio/etc.external_url = "https://example.com/reports/quarterly_report.pdf"# or a pre-signed S3/Azure URL:# external_url = "https://s3.amazonaws.com/yourbucket/obj?X-Amz-..."​part = types.Part.from_uri(file_uri=external_url, mime_type="application/pdf")​response = client.models.generate_content(    model=MODEL,    contents=[        "Give me the three key takeaways from this report.",        part,    ],)print(response.text)client.close()

ملاحظات: سيجلب Gemini الـ external_url وقت الطلب. استخدم العناوين الموقّعة لمزوّدي التخزين السحابي الخاص (AWS/Azure). للجلب الخارجي حدود عملية للحجم/التنسيق (انظر الوثائق).

المثال C: الإشارة مباشرة إلى كائن GCS (gs://)

# Example C: reference a GCS file (ensure service account has storage access)from google import genaifrom google.genai import types​# For Vertex AI usage, standard practice is to use ADC (Application Default Credentials)client = genai.Client(vertexai=True, project="your-project-id", location="us-central1")MODEL = "gemini-3-pro"  # example model id​gcs_uri = "gs://my-bucket/path/to/manual.pdf"part = types.Part.from_uri(file_uri=gcs_uri, mime_type="application/pdf")​response = client.models.generate_content(    model=MODEL,    contents=[        "Extract the section titles from the attached manual and list them.",        part,    ],)print(response.text)client.close()

ملاحظات: يتطلب الوصول إلى GCS إعداد IAM صحيحاً وحساب خدمة مناسباً (صلاحيات Object Viewer، مصادقة سليمة). عند تسجيل أو الإشارة إلى كائنات GCS، تأكد من أن بيئة التشغيل (Vertex/ADC/حساب الخدمة) تمتلك الأذونات اللازمة.

القيود والاعتبارات الأمنية

قيود الحجم ونوع المحتوى

حجم الجلب الخارجي: يخضع جلب العناوين الخارجية للحدود الموثقة (100MB لكل حمولة مُجلَبة عملياً) وأنواع MIME/المحتوى المدعومة. إذا احتجت تمرير أصول كبيرة جداً (متعددة الجيجابايت)، استخدم Files API أو خط معالجة مختلف.

Files API مقابل المضمن مقابل العنوان الخارجي: متى تستخدم أيّاً منها

• المضمن (from_bytes) — الأسهل للملفات المنفردة حيث تمتلك تطبيقاتك البايتات بالفعل وحجمها ≤100MB. جيد للتجارب والخدمات الصغيرة.
• العنوان الخارجي / العنوان الموقّع — الأفضل حين يكون الملف في مكان آخر (S3، Azure، الويب العام)؛ يتجنب تحريك البايتات ويقلل النطاق الترددي. استخدم العناوين الموقّعة للأصول الخاصة.
• GCS / الكائنات المسجلة — الأفضل عندما تكون بياناتك على Google Cloud وتريد نمط إنتاجي بمراجع مستقرة وضوابط IAM.
• Files API — استخدمه للملفات الدائمة أو الكبيرة جداً التي تريد إعادة استخدامها عبر طلبات متعددة؛ راعِ حصص كل ملف والمشروع وسياسات الاحتفاظ/التلاشي.

الأمان والخصوصية

• العناوين الموقّعة: يجب توليد العناوين الموقّعة مسبقاً بعمر محدود وصلاحيات ضيقة. لا تضمّن أسراراً طويلة الأمد في الطلبات.
• IAM وOAuth: للوصول المباشر إلى GCS، اضبط حسابات الخدمة وفق مبدأ أقل صلاحية (objectViewer للقراءة). اتّبع أفضل ممارسات مؤسستك في تدوير المفاتيح والتسجيلات.
• إقامة البيانات والامتثال: عند السماح للواجهة بجلب محتوى خارجي، تأكد من توافق ذلك مع سياسات التعامل مع البيانات والمتطلبات التنظيمية (بعض البيانات الخاضعة للتنظيم يجب ألا تُرسل إلى خدمة خارجية ولو مؤقتاً). قد يحتفظ مزود النموذج ببيانات وصفية حول الطلبات ضمن السجلات — ضع ذلك بالحسبان في تحليل الخصوصية.

ملاحظات تشغيلية

• تخزين Files API المؤقت: قد تكون الملفات المرفوعة إلى Files API زائلة (تاريخياً 48 ساعة)؛ للتخزين طويل الأمد استخدم GCS أو مخازن دائمة أخرى وأشر إليها مباشرة.
• الجلب المتكرر: إذا تمت الإشارة إلى ملف عبر عنوان في كل طلب واستخدم بشكل متكرر، قد تتحمل كلفة جلب متكرر؛ فكّر في التخزين المؤقت أو تسجيل نسخة في GCS للاستخدام الثقيل.

كيف يغيّر هذا معمارية التطبيقات — أمثلة عملية

حالة استخدام — مساعد معرفة يعتمد على المستندات

إذا كنت تدير مساعداً داخلياً يقرأ كتيبات المنتجات المخزّنة في GCS، سجّل تلك الكائنات مرة (أو أشر إليها بعناوين gs://) واستعلم عنها ديناميكياً. هذا يتجنب إعادة رفع نفس ملفات PDF مراراً ويبقي الواجهة الخلفية أبسط. استخدم Files API/تسجيل GCS للكتيبات الكبيرة جداً (>100MB).

حالة استخدام — تطبيق جوّال للمستهلكين يرسل صوراً

لتطبيق جوّال يرسل صوراً لتعليق بلقطة واحدة، استخدم بايتات مضمّنة للصور الصغيرة (<100MB). هذا يُبقي تجربة المستخدم بسيطة ويتجنب خطوة رفع ثانية. إذا كان المستخدمون سيعيدون استخدام نفس الصورة أو مشاركتها كثيراً، خزّنها في GCS ومرّر gs:// أو عنواناً موقّعاً بدلاً من ذلك.

حالة استخدام — خطوط تحويل الكلام إلى نص

الملاحظات الصوتية القصيرة (<100MB / < ~دقيقة حسب الترميز) يمكن تمريرها مضمّنة أو عبر عنوان موقّع. للتسجيلات الطويلة، ارفع عبر Files API وأشر إلى الملف في مكالمات التوليد اللاحقة لإعادة استخدام فعّالة. غالباً ما تحتوي مسارات الفيديو/الصوت على ملاحظات أفضل الممارسات الإضافية في وثائق الوسائط.

الخلاصة

يُسهّل تحديث Gemini API كثيراً إدخال “البيانات الموجودة” في مسارات الذكاء التوليدي: الجلب المباشر من عناوين عامة أو موقّعة ومن تسجيل GCS يُزيل نقطة احتكاك تشغيلية شائعة، والقفزة من 20MB → 100MB للحمولات المضمّنة تمنح المهندسين مرونة أكبر لطلبات بسيطة من خطوة واحدة. للملفات طويلة الأمد، الكبيرة جداً، أو كثيرة الاستخدام، يبقى Files API (2GB لكل ملف، تخزين افتراضي 48 ساعة) خياراً مناسباً.

لبداية سلسة، استكشف Gemini API عبر CometAPI، إمكانيات Gemini 3 Pro وgemini 3 flash في ساحة التجربة وراجع دليل API للحصول على إرشادات مفصلة. قبل الوصول، يرجى التأكد من تسجيل الدخول إلى CometAPI والحصول على مفتاح API. تقدّم CometAPI سعراً أقل بكثير من السعر الرسمي لمساعدتك على الدمج.

هل أنت مستعد للانطلاق؟→ نسخة تجريبية مجانية لـ Gemini 3 Pro !