ملاحظة المؤلف: أوقفت Google في 22 أكتوبر 2026 النماذج الثلاثة ضمن سلسلة Veo 3.1 Preview. يجمع هذا المقال قائمة النماذج المتوقفة، وطرق التعرّف على رسائل الخطأ، ومستجدات إتاحة Omni، وخطة للانتقال خلال الفترة الانتقالية.
إذا بدأت مهام توليد الفيديو لديك تفشل على نطاق واسع فجأة، وظهرت الرسالة fail_to_fetch_task، فمن المرجح أن السبب هو إيقاف Veo 3.1 Preview. فقد أوقفت Google في 22 أكتوبر 2026 النماذج الثلاثة ضمن سلسلة Veo 3.1 Preview، وأوقفت APIYI القناة المقابلة بالتزامن مع ذلك.
المشكلة ليست في شفرتك، ولا في عطل مؤقت بالمنصة. فقد أكّد إعلان الإيقاف الرسمي من Google أن هذه النماذج أُخرجت من الخدمة نهائيًا. يوضح هذا المقال النماذج المتأثرة، وكيفية التحقق سريعًا من سبب الخطأ، وما يمكنك فعله للانتقال بسلاسة إلى حين إتاحة الطراز البديل الرسمي.
الفائدة الأساسية: تعرّف في 3 دقائق على أهم ما يتعلق بإيقاف Veo 3.1 Preview، واحصل على قائمة خطوات للانتقال يمكنك تنفيذها مباشرة.
لمحة سريعة عن أبرز المعلومات حول إيقاف Veo 3.1 Preview
إليك الخلاصة أولًا. يلخص الجدول التالي أهم المعلومات المتعلقة بإيقاف Veo 3.1 Preview، استنادًا إلى الإعلانات الرسمية من Google وإشعارات خدمة APIYI.
| البند | التفاصيل |
|---|---|
| موعد الإيقاف | 22 أكتوبر 2026 (تتوقف Google رسميًا عن توفيره) |
| الجهة المعلنة | Google (إشعار إيقاف Gemini API) |
| النماذج المتوقفة | veo-3.1-generate-preview، veo-3.1-fast-generate-preview، veo-3.1-lite-generate-preview |
| البديل الرسمي | gemini-omni-1.1-flash |
| حالة القناة لدى APIYI | تم إيقاف القناة المقابلة لـ Veo 3.1 Preview |
| تقدم إتاحة Omni | لا يزال ضمن خطة الإتاحة، ومن المتوقع إطلاقه في نوفمبر. يُرجى الرجوع إلى الإعلانات لمعرفة الموعد المحدد |
| الخطأ الشائع | تُرجع المهمة fail_to_fetch_task، ويتضمن خطأ 404 الداخلي العبارة is no longer available |
نبذة عن النماذج الثلاثة المتوقفة من Veo 3.1 Preview
أُوقفت ثلاثة نماذج تغطي تقريبًا جميع مواصفات Veo 3.1 Preview. النموذج veo-3.1-generate-preview هو الإصدار القياسي، وveo-3.1-fast-generate-preview هو الإصدار السريع المصمم لإعطاء الأولوية للسرعة، أما veo-3.1-lite-generate-preview فهو الإصدار الخفيف. تنتمي النماذج الثلاثة إلى الدفعة نفسها من نماذج Preview، ولذلك أُوقفت جميعها في الوقت نفسه.
نماذج Preview هي إصدارات استعراضية رسمية، والغرض منها عادةً جمع الملاحظات والتحقق من القدرات، لذا تكون دورة حياتها أقصر من دورة حياة الإصدارات الرسمية. تنشر Google خطة الإيقاف مسبقًا على صفحة الإيقاف الرسمية، ثم توقف الوصول إلى النموذج عند حلول الموعد المحدد. بعد الإيقاف، لن تتمكن من إنشاء الفيديو بنجاح عبر أي قناة استدعاء ما دامت طلباتك تشير إلى أحد أسماء النماذج الثلاثة هذه.
| اسم النموذج | الاستخدام | الحالة الحالية | البديل الرسمي |
|---|---|---|---|
veo-3.1-generate-preview |
توليد الفيديو، الإصدار القياسي | متوقف | gemini-omni-1.1-flash |
veo-3.1-fast-generate-preview |
توليد الفيديو، الإصدار السريع | متوقف | gemini-omni-1.1-flash |
veo-3.1-lite-generate-preview |
توليد الفيديو، الإصدار الخفيف | متوقف | gemini-omni-1.1-flash |
📌 التوصية الرسمية: تُحدَّث قائمة النماذج المتوقفة والبدائل الموصى بها باستمرار في صفحة «قائمة النماذج المتوقفة» بمركز توثيق APIYI. يُنصح بإضافة docs.apiyi.com إلى المفضلة والاطلاع عليها دوريًا للاستعداد للترحيل مسبقًا.
كيفية التعرّف على الأخطاء الناتجة عن إيقاف Veo 3.1 Preview
أول ما يتبادر إلى ذهن كثير من المطوّرين هو التحقق من الشفرة أو المفتاح أو الشبكة. لكن هذا النوع من الإخفاقات له سمات واضحة، ويمكنك تحديده بسرعة باتباع الخطوات التالية.
سمات أخطاء Veo 3.1 Preview
إذا أعادت نتيجة الاستعلام عن مهمة فيديو fail_to_fetch_task، وكان الخطأ الداخلي 404 يتضمن العبارة is no longer available، فيمكنك التأكد من أن الإخفاق ناتج عن إيقاف النموذج. وهذا يختلف عن أخطاء المعلمات أو نفاد الرصيد أو حظر المحتوى أثناء المراجعة؛ إذ لن تنجح إعادة المحاولة مهما كررتها.
| مظهر الخطأ | السبب المحتمل | طريقة المعالجة |
|---|---|---|
fail_to_fetch_task + ظهور is no longer available في الخطأ الداخلي 404 |
أُوقف Veo 3.1 Preview | استخدم نموذجًا آخر واتبع خطة الترحيل |
| خطأ في التحقق من المعلمات | معلمات الطلب لا تستوفي متطلبات النموذج | راجع التوثيق وصحّح المعلمات |
| خطأ في المصادقة | مفتاح API غير صالح أو لا يملك الصلاحيات الكافية | تحقّق من إعدادات المفتاح |
| خطأ متعلق بالرصيد أو الحصة | رصيد الحساب غير كافٍ | أضف رصيدًا ثم أعد المحاولة |
احتفِظ بمعلومات خطأ Veo 3.1 Preview قبل بدء التحقق
انتبه إلى نقطة مهمة: عادةً ما تظهر معلومات الخطأ من نوع fail_to_fetch_task في متن الاستجابة مرة واحدة فقط. إذا كان برنامجك يسجّل رمز الحالة دون حفظ متن الاستجابة كاملًا، فسيصعب عليك لاحقًا تحديد سبب الإخفاق. ويتناول «دليل الاحتفاظ بمعلومات أخطاء الواجهات» في مركز توثيق APIYI هذه المشكلة بالتحديد؛ لذا يُنصح بحفظ استجابة الخطأ كاملة في السجلات.
يوضح المثال التالي كيفية التعرّف على خطأ إيقاف النموذج أثناء الاستعلام عن المهمة، وحفظ الاستجابة الأصلية في السجل:
import json
import logging
# عنوان الواجهة الموحد: استخدام واجهة APIYI المتوافقة مع OpenAI
BASE_URL = "https://api.apiyi.com/v1"
DEPRECATED_VEO_MODELS = {
"veo-3.1-generate-preview",
"veo-3.1-fast-generate-preview",
"veo-3.1-lite-generate-preview",
}
def check_task_result(model: str, resp_json: dict) -> str:
"""التعرّف على إخفاق المهمة الناتج عن إيقاف Veo 3.1 Preview والاحتفاظ بمعلومات الخطأ كاملة"""
raw = json.dumps(resp_json, ensure_ascii=False)
logging.warning("task response: %s", raw) # لا تُعاد معلومات الخطأ إلا مرة واحدة؛ لذا احفظها كاملة
بعد التعرّف على MODEL_DEPRECATED، ينبغي للبرنامج التوقف عن إعادة المحاولة باستخدام النموذج الأصلي، والانتقال إلى مسار بديل أو إطلاق تنبيه. وإلا فستمتلئ قائمة انتظار المهام بطلبات محكوم عليها بالإخفاق، ما سيعيق أيضًا التحقق من المشكلات الأخرى.
خطة الانتقال بعد إيقاف Veo 3.1 Preview
لم يُطرح الطراز البديل الرسمي gemini-omni-1.1-flash على APIYI حتى الآن، وما زال قيد الدمج، ومن المتوقع إطلاقه في نوفمبر. ويظل الموعد الدقيق مرهونًا بالإعلان الرسمي. خلال هذه الفترة الانتقالية، يُنصح بالتبديل إلى أحد نماذج الفيديو الأخرى المتاحة على المنصة لضمان استمرارية أعمالك.
| خيار الانتقال | الإمكانات الرئيسية | حالة التوفر على APIYI | الحالات المناسبة |
|---|---|---|---|
| gemini-omni-1.1-flash | الطراز البديل الرسمي من Google | قيد الدمج، ومن المتوقع إطلاقه في نوفمبر | لمن يرغبون في البقاء ضمن منظومة Google على المدى الطويل |
| Seedance 2.0 | تحويل النص إلى فيديو، وإنشاء الفيديو باستخدام الإطار الأول أو الإطارين الأول والأخير | متاح | تحويل النص إلى فيديو، أو التحكم بالإطار الأول أو بالإطارين الأول والأخير |
| Wan2.7 (Tongyi Wanxiang) | تحويل النص إلى فيديو، وتحويل صورة إلى فيديو، وإنشاء فيديو استنادًا إلى صورة مرجعية | متاح | عند الحاجة إلى تحويل صورة إلى فيديو أو الاستناد إلى صورة مرجعية |
| المنصة المتاحة | — | واجهة موحدة عبر APIYI apiyi.com | التبديل بين نماذج متعددة باستخدام مفتاح API واحد |
تحليل مقارن لخيارات الانتقال من Veo 3.1 Preview
تحليل مقارن مع Seedance 2.0: يدعم Seedance 2.0 تحويل النص إلى فيديو، وإنشاء الفيديو من الإطار الأول أو من الإطارين الأول والأخير. لذلك، يمكن نقل الأعمال التي تستخدم Veo 3.1 Preview لتحويل النص إلى فيديو أو لإنشاء فيديو انطلاقًا من الإطار الأول بسلاسة نسبية. لكنه نموذج تابع لجهة خارجية، وتختلف طريقة كتابة الموجهات وخصائص المخرجات فيه عن Veo؛ لذا يُفضّل إجراء اختبار مقارن باستخدام مواد حقيقية قبل الإطلاق.
تحليل مقارن مع Wan2.7: يدعم Wan2.7 إنشاء الفيديو من النص، ومن الصور، ومن الصور المرجعية، ما يمنحك خيارات أكثر في حالات مثل الحفاظ على اتساق العنصر المرئي استنادًا إلى صورة مرجعية. إذا كان عملك يعتمد بدرجة أكبر على الصور المدخلة لضبط المشهد، فسيكون Wan2.7 خيارًا انتقاليًا أنسب. تختلف منظومة معلماته عن Veo، لذا ستحتاج إلى تكييف بنية الطلبات بشكل منفصل.
تحليل مقارن مع Omni: يُعدّ gemini-omni-1.1-flash النموذج البديل الذي تحدده Google رسميًا، وهو الأقرب على المدى الطويل إلى طريقة استخدام Veo المعتادة. لكنه لم يُطرح بعد على APIYI، لذا لا يناسب حاليًا الاستخدام في بيئة الإنتاج. يُنصح بالتخطيط للانتقال بعد صدور إعلان رسمي.
🎯 توصية بشأن الانتقال: خلال الفترة الانتقالية، يُنصح باختبار Seedance 2.0 وWan2.7 بالتوازي عبر APIYI apiyi.com، ومقارنة النتائج باستخدام المجموعة نفسها من الموجهات والصور المرجعية، ثم اختيار النموذج الأساسي. يمكنك استدعاء نماذج فيديو متعددة باستخدام مفتاح API واحد، ما يجعل الانتقال بينها سهلًا ومنخفض التكلفة.
ما يجب تعديله عند الانتقال من Veo 3.1 Preview
لا يقتصر الانتقال على تغيير اسم النموذج. فلكل نموذج فيديو معلمات وسير عمل مختلفان، لذا يُنصح بمراجعة العناصر التالية واحدًا تلو الآخر:
- اسم النموذج: استبدل أسماء نماذج Veo 3.1 Preview الثلاثة في الشفرة والإعدادات، بما في ذلك متغيرات البيئة وإعدادات قاعدة البيانات وخيارات القوائم المنسدلة في الواجهة الأمامية.
- معلمات الطلب: راجع أسماء الحقول والقيم المقبولة للمدة والدقة ونسبة العرض إلى الارتفاع والإطار الأول/الإطارين الأول والأخير والصور المرجعية، بالاستناد إلى وثائق النموذج المستهدف.
- منطق الاستعلام عن المهام: قد تختلف حقول الحالة والنتائج في المهام غير المتزامنة، لذا تحقّق من آلية الاستطلاع ومن تحليل بيانات الاستدعاءات العكسية.
- معالجة الأخطاء: احتفظ بمنطق التعرّف على إيقاف النموذج المذكور سابقًا، وأضف معالجة رموز الأخطاء الخاصة بالنموذج الجديد.
- التحقق من النتائج: قارن مخرجات النموذجين باستخدام مجموعة اختبارات ثابتة، وتأكد من أن الأسلوب والوضوح والاستقرار تلبي متطلبات العمل.
لتسهيل الانتقال عند إيقاف نموذج في المستقبل، يُنصح بجعل اختيار النموذج عنصرًا قابلًا للضبط بدلًا من تثبيته في شفرة العمل:
# إعدادات توجيه نماذج الفيديو: عند إيقاف نموذج، غيّر الإعدادات فقط دون تعديل شفرة العمل
BASE_URL = "https://api.apiyi.com/v1" # واجهة APIYI الموحدة
VIDEO_MODEL_ROUTES = {
"text_to_video": "seedance-2.0", # النموذج الأساسي خلال المرحلة الانتقالية؛ يُرجى الرجوع إلى وثائق APIYI للتحقق من اسم النموذج المحدد
"image_to_video": "wan2.7", # لمهام تحويل صورة إلى فيديو واستخدام الصور المرجعية؛ يُرجى الرجوع إلى الوثائق للتحقق من اسم النموذج المحدد
# "default": "gemini-omni-1.1-flash", # يُفعّل Omni بعد إطلاقه على APIYI
}
def pick_model(task_type: str) -> str:
return VIDEO_MODEL_ROUTES.get(task_type, VIDEO_MODEL_ROUTES["text_to_video"])
أسماء النماذج في الشفرة توضيحية فقط. عند استخدامها فعليًا، يُرجى الرجوع إلى معرّفات النماذج ومواصفاتها المنشورة في مركز وثائق APIYI.
تحليل تأثير إيقاف Veo 3.1 Preview
التأثير على المطورين
- فشل المهام الحالية مباشرةً: ستفشل جميع الطلبات التي لا تزال تستدعي أسماء النماذج الثلاثة هذه. يجب استبدالها فورًا، ولا يمكن حل المشكلة بإعادة المحاولة.
- تأثر قناة VEO 3.1 Official: تمرّر هذه القناة الطلبات إلى نقاط النهاية الرسمية من Google، لذا ستتعطل النماذج المقابلة فيها بالتزامن مع إيقاف سلسلة Preview. لمعرفة قنوات VEO التي لا تزال تعمل، راجع دليل «مقارنة اختيار VEO 3.1 Official والقناة غير الرسمية».
- الحاجة إلى التكيّف مع المعلمات الجديدة: عند الانتقال إلى Seedance 2.0 أو Wan2.7، يجب إعادة تكييف بنية الطلبات ومنطق الاستعلام عن المهام. يُنصح بتخصيص وقت للاختبار.
- استكمال معايير السجلات: كشفت هذه الحادثة أن كثيرًا من المشاريع لا تحفظ استجابات الأخطاء كاملة. اغتنموا الفرصة لتحسين السجلات، فهذا سيقلل وقت استكشاف الأخطاء مستقبلًا بوضوح.
التأثير على القطاع
- نماذج Preview غير مناسبة لتشغيل الأعمال الأساسية: دورة حياة إصدارات المعاينة قصيرة؛ لذا ينبغي إما تجهيز نموذج بديل لبيئة الإنتاج أو اختيار الإصدارات الرسمية أولًا.
- أهمية أكبر لبنية متعددة النماذج: تؤثر تغييرات النماذج لدى مزوّد واحد مباشرةً في الأعمال. ومن الأكثر أمانًا استخدام منصة تجميع تتيح الاحتفاظ بعدة نماذج فيديو والتبديل بينها.
- تواصل تطور نماذج الفيديو: يشير الانتقال من Veo 3.1 Preview إلى Omni إلى أن Google تعيد ضبط خط منتجات توليد الفيديو. وقد تطرأ تغييرات جديدة على الإصدارات لاحقًا، لذا يجدر متابعتها باستمرار.
الأسئلة الشائعة
س1: ماذا يعني إيقاف Veo 3.1 Preview؟
أوقفت Google في 22 أكتوبر 2026 توفير النماذج الثلاثة `veo-3.1-generate-preview` و`veo-3.1-fast-generate-preview` و`veo-3.1-lite-generate-preview`. بعد إيقافها، لن يعود بالإمكان توليد الفيديو باستخدام أسماء هذه النماذج، وسيتأثر بذلك الاستدعاء عبر جميع القنوات.
س2: تظهر لي المهمة الخطأ fail_to_fetch_task. هل المشكلة في الكود؟
إذا تضمّن الخطأ الداخلي 404 العبارة `is no longer available`، وكان الطلب موجّهًا إلى أحد النماذج الثلاثة المذكورة أعلاه، فالمشكلة ليست في الكود، بل في إيقاف النموذج. لن يفيد تكرار المحاولة في هذه الحالة، لذا عليك استخدام نموذج آخر. يُنصح بحفظ نص الاستجابة كاملًا قبل بدء استكشاف المشكلة، لأن رسالة الخطأ هذه لا تظهر إلا مرة واحدة.
س3: متى سيتوفر البديل الرسمي gemini-omni-1.1-flash على APIYI؟
لم تطلق APIYI نموذج Omni بعد، وما زال ضمن خطة التكامل. ومن المتوقع إطلاقه في نوفمبر، لكن الموعد المحدد رهنًا بإعلانات المنصة. ستُحدَّث الوثائق عند إطلاقه، ويمكنك متابعة إشعارات الخدمة على apiyi.com.
س4: ما نموذج الفيديو الأنسب خلال الفترة الانتقالية؟
يعتمد ذلك على حالة الاستخدام:
– **تحويل النص إلى فيديو، أو التحكم في الإطار الأول أو الإطارين الأول والأخير**: يُنصح باستخدام Seedance 2.0
– **تحويل صورة إلى فيديو، مع الحفاظ على اتساق العنصر في الصورة المرجعية**: يُنصح باستخدام Wan2.7
– **إذا كنت ترغب في البقاء ضمن منظومة Google على المدى الطويل**: استخدم النموذجين المذكورين أعلاه مؤقتًا، ثم انتقل إلى Omni عند إطلاقه
س5: كيف أختبر أداء النماذج البديلة بسرعة؟
يُنصح باستخدام منصة تجميع API تدعم نماذج متعددة لإجراء اختبارات مقارنة:
1. سجّل حسابًا على APIYI عبر apiyi.com
2. احصل على مفتاح API؛ ويمكن للمستخدمين الجدد الحصول على رصيد مجاني للاختبار
3. اضبط `base_url` على `https://api.apiyi.com/v1`، ثم استدعِ Seedance 2.0 وWan2.7 وفقًا للوثائق وقارن بينهما
يمكنك استخدام مفتاح API نفسه لاستدعاء عدة نماذج فيديو، ما يسهّل إجراء مقارنة مباشرة باستخدام مجموعة المواد نفسها.
س6: كيف يمكنني معرفة أن نموذجًا ما سيتوقف عن العمل مسبقًا؟
يمكنك متابعة مصدرين: صفحة Google الرسمية الخاصة بإيقاف واجهة Gemini API، وقسم «قائمة النماذج المتوقفة» في مركز وثائق APIYI. يجمع المصدر الثاني النماذج التي سيُوقف العمل بها والبدائل المقترحة، ما يوفر الوقت مقارنةً بمراجعة الإعلانات الرسمية واحدًا تلو الآخر. يُفضّل فحص مشاريع الإنتاج شهريًا، وإتاحة تغيير النموذج من خلال الإعدادات في الكود.
أهم النقاط حول إيقاف Veo 3.1 Preview
- الإيقاف: أوقفت Google في 22 أكتوبر 2026 ثلاثة نماذج من سلسلة Veo 3.1 Preview.
- التعرّف على الخطأ: يشير الخطأ
fail_to_fetch_task، مع ظهورis no longer availableداخل استجابة 404، إلى أن النموذج قد أُوقف. - البديل الرسمي: النموذج البديل هو
gemini-omni-1.1-flash، ومن المتوقع أن تتيحه APIYI في نوفمبر. - حلول مؤقتة: اختر Seedance 2.0 لتحويل النص إلى فيديو وإنشاء الفيديو من الإطارين الأول والأخير، وWan2.7 لتحويل صورة إلى فيديو والسيناريوهات التي تستخدم صورًا مرجعية.
- ممارسة مفيدة لاستكشاف الأخطاء: لا تُعرض رسالة الخطأ إلا مرة واحدة، لذا احرص على حفظ نص الاستجابة كاملًا في السجلات.
- طريقة البدء: يمكنك مقارنة نماذج فيديو متعددة باستخدام مفتاح API واحد عبر APIYI apiyi.com.
الخلاصة
أهم النقاط حول إيقاف Veo 3.1 Preview:
- أُوقفت النماذج الثلاثة: أُوقفت الإصدارات القياسي والسريع والخفيف جميعها، وأوقفت قناة APIYI المقابلة استخدامها أيضًا.
- يمكن التعرّف على الخطأ بسرعة: عند ظهور
fail_to_fetch_taskمعis no longer available، ابدأ مباشرةً إجراءات الانتقال إلى نموذج آخر، بدلًا من مواصلة البحث عن المشكلة في الشفرة. - تتوفر بدائل خلال الفترة الانتقالية: إلى أن يُطرح Omni، يمكن لـ Seedance 2.0 وWan2.7 تلبية معظم احتياجات توليد الفيديو.
ننصحك باستبدال أسماء النماذج القديمة في الشفرة قريبًا، وجعل اختيار النموذج قابلًا للضبط من الإعدادات، وتحسين سجلات الأخطاء استعدادًا للانتقال إلى Omni لاحقًا. يمكنك اختبار أداء النماذج البديلة بسرعة عبر APIYI apiyi.com؛ إذ توفر المنصة واجهة متوافقة مع OpenAI ورصيدًا مجانيًا للاختبار للمستخدمين الجدد، كما تتيح الانتقال بسلاسة إلى Omni عبر الواجهة نفسها عند إطلاقه.
📚 مراجع
- إعلان Google Gemini API عن إيقاف النماذج: التوضيح الرسمي بشأن إيقاف سلسلة Veo 3.1 Preview
- الرابط:
ai.google.dev/gemini-api/docs/deprecations -
التفاصيل: اطّلع على قائمة النماذج التي سيُوقف دعمها، وتواريخ الإيقاف، والبدائل الرسمية المقترحة
-
مركز توثيق APIYI: قائمة النماذج المهجورة، وإرشادات الاحتفاظ برسائل أخطاء الواجهات، ووثائق استدعاء نماذج الفيديو
- الرابط:
docs.apiyi.com - التفاصيل: تحديثات مستمرة بشأن النماذج التي سيُوقف دعمها والبدائل الموصى بها، إلى جانب شرح إعدادات Seedance 2.0 وWan2.7
المؤلف: الفريق التقني في APIYI
للتواصل التقني: إذا واجهت أي مشكلات أثناء الترحيل، يُسعدنا تواصلك معنا عبر الصفحة الرئيسية لموقع APIYI على apiyi.com. ولمزيد من المعلومات، تفضّل بزيارة مركز التوثيق على docs.apiyi.com
