تحليل فيديوهات العمارة باستخدام Gemini API: دليل خطوة بخطوة

ما الذي ستتعلمونه في هذا الدليل؟

يمكن استخدام Gemini API لمعرفة المساحات الظاهرة في فيديو مشروع، أو تحويل تسجيل عرض تقديمي إلى ملخص موجز، أو السؤال عمّا يحدث عند ثانية محددة. ويوثّق دليل Google لفهم الفيديو استخدامات مثل وصف الفيديو واستخراج المعلومات من محتواه والإجابة عن الأسئلة استنادًا إلى الطوابع الزمنية.

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

المتطلبات واختيار الفيديو

تشمل الأمثلة الواردة في وثائق Google لـ Gemini API استخدام Python وJavaScript وJava وGo وREST. وتستخدم أمثلة Python مكتبة google-genai، لكن الدليل لا يحدد إصدارًا مطلوبًا لهذه الأمثلة. لذلك لا نذكر رقم إصدار هنا. للوصول إلى API والمصادقة، استخدموا إعدادات API الخاصة ببيئة التطوير لديكم؛ فالمصدر لا يشرح بالتفصيل خطوات إنشاء الحساب.

قبل إرسال الفيديو، قيّموا حجم الملف وطريقة استخدامه:

• يحدّد جدول المقارنة لدى Google الحد الأقصى لـ Files API عند 20 GB للاستخدام المدفوع و2 GB للاستخدام المجاني. وتناسب هذه الطريقة الملفات الكبيرة والفيديوهات الطويلة والملفات التي ستُستخدم مجددًا.

• يُدرج Cloud Storage Registration بحد أقصى يبلغ 2 GB لكل ملف، مع الإشارة إلى عدم وجود حد إجمالي للتخزين. ويُطرح بوصفه خيارًا للملفات الدائمة القابلة لإعادة الاستخدام.

• يذكر الجدول أن Inline Data مخصص للملفات التي يقل حجمها عن 100 MB. لكن الدليل نفسه يرى أن إرفاق الفيديوهات القصيرة مباشرةً بالطلب مناسب عندما يكون إجمالي حجم الطلب أقل من 20 MB. لذا احسبوا حجم الطلب بالكامل، لا ملف الفيديو وحده، عند اختيار الطريقة.

• تُدرج فيديوهات YouTube المتاحة للجميع أيضًا ضمن طرق الإدخال.

توصي Google باستخدام Files API في معظم الحالات، ولا سيما للفيديوهات التي يزيد حجمها على 100 MB أو التي ستُستخدم مجددًا في طلبات مختلفة. كما يوصي الدليل باستخدام Files API إذا تجاوز إجمالي الطلب 20 MB، أو كانت مدة الفيديو طويلة، أو استُخدم الملف نفسه في أكثر من طلب.

تحليل الفيديو خطوة بخطوة

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

2. اختاروا طريقة النقل. يمكن استخدام البيانات المضمنة لمقطع صغير يُستخدم مرة واحدة؛ أما الفيديو الكبير أو الطويل أو الذي سيُستخدم مجددًا، فالأفضل نقله عبر Files API. لا تتجاوزوا خطوة تحميل الملف وانتظار اكتمال معالجته: تتحقق أمثلة Google من حالة الملف إلى أن تصبح ACTIVE. كما تتناول الأمثلة احتمال فشل معالجة الملف.

3. أضيفوا الفيديو والنص إلى الطلب معًا. في أمثلة الدليل، يُمرّر إدخال الفيديو عبر URI للملف ونوع MIME، فيما يُمرّر إدخال النص على هيئة تعليمات للتحليل. ويستخدم أحد الأمثلة gemini-3.8-flash اسمًا للنموذج. تحقّقوا من معلومات النماذج وإمكانية الوصول إليها في وثائق API بما يناسب تطبيقكم؛ ولا نفترض هنا إصدارًا أو ضمانًا لإمكانية الوصول، باستثناء الاسم الوارد في المثال.

يمكنكم استخدام النص التالي بوصفه تعليمات نصية إلى جانب إدخال الفيديو:

Bu mimari proje videosunu kısa bir özette anlat. Görünen mekânları videoda izlendikleri sırayla listele. Videoda açıkça görülmeyen özellikleri tahmin etme; emin olmadığın ayrıntıları belirt.

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

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

Videoda mutfak mekânının ilk göründüğü zamanı bul. Zaman damgasını ver ve o anda görülebilen sabit donatıları, yalnızca görüntüde seçilebildikleri ölçüde açıkla.

توجّه هذه المطالبة البحث عن مساحة محددة. تحقّقوا من الطابع الزمني ضمن تسلسل المونتاج أو العرض؛ فالدليل لا يضمن خلو النتائج من الأخطاء في جميع الحالات.

1. اطلبوا ملاحظات المواد والإضاءة كلًّا على حدة. تقسيم المراجعة إلى محاور يجعل تقييم الإجابة أسهل من طلب تفاصيل كثيرة في سؤال واحد واسع:

Bu iç mekân videosunda görülebilen yüzey ve malzeme özelliklerini sıralı biçimde açıkla. Her gözlemi ilgili zaman damgasıyla eşleştir; malzeme türü kesin seçilemiyorsa bunu tahmin olarak sunma.

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

1. حوّلوا الإجابة إلى قائمة تحقق موجزة. إذا كان هناك ما ينبغي للفريق متابعته في فيديو العرض، اطلبوا من النموذج فصل المعلومات الواردة فعلًا في الفيديو:

Bu proje sunumunda açıkça belirtilen tasarım kararlarını ve çözümsüz bırakılan soruları iki ayrı listede özetle. Her maddeyi destekleyen zaman damgasını ekle; videoda yanıtı olmayan noktaları boşlukları doldurmadan belirt.

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

أخطاء شائعة

إرسال الملف بطريقة غير مناسبة لحجمه: رغم أن جدول الدليل يذكر أن Inline Data مخصص للملفات التي يقل حجمها عن 100 MB، يقصر الدليل نفسه الاستخدام المباشر لهذه الطريقة على الفيديوهات القصيرة التي يقل إجمالي حجم طلبها عن 20 MB. اتبعوا توصية استخدام Files API للملفات الكبيرة أو الفيديوهات الطويلة.

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

استخلاص معلومات غير مؤكدة من الصورة: قد لا يظهر في الفيديو نوع المادة الحقيقي أو أبعادها أو اسم المنتج. يقلل طلب الاقتصار على النتائج المرئية والتصريح بوضوح عن مواطن عدم اليقين من خطر تقديم معلومات غير مؤكدة على أنها حقائق.

الخلط بين تحليل الفيديو وإنشائه: تذكر صفحة Google لإنشاء الفيديو أن Veo 3.1 Preview أُوقف في 22 أكتوبر 2026، وتوجّه إلى Gemini Omni Flash لإنشاء الفيديو. وهذا تغيير مختلف عن الخطوات التي يشرحها هذا الدليل لتحليل فيديو موجود.

الاستخدام ضمن سير عمل العمارة والتصوير المعماري

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

حدّدوا طريقة النقل بناءً على حجم الملف ومدته والحاجة إلى إعادة استخدامه قبل إعداد سير العمل. وتُوجّه الملفات الكبيرة أو الفيديوهات الطويلة إلى Files API؛ كما تورد المصادر حدودًا مختلفة للملفات في الاستخدام المدفوع والمجاني. ولا يقدم هذا الدليل معلومات عن الأسعار أو خصوصية المشاريع أو مدة التخزين أو الأجهزة المطلوبة لمحطة عمل معينة؛ لذا قيّموا هذه الجوانب بشكل منفصل وفقًا لظروف استخدامكم.

الخطوات التالية

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

المصدر والترخيص

أُعدّ هذا الدليل بتكييف دليلي Google لـ Gemini API بعنواني “Video understanding” و“Video generation in the Gemini API” إلى اللغة التركية. ويذكر كلا المصدرين أن المحتوى مرخّص بموجب CC BY 4.0 ما لم يُذكر خلاف ذلك.