اسم Veo 3.1 في API: معرّفات النماذج لنماذج Veo 3.1 و Fast و Lite

تلصق اسم النموذج في النص البرمجي، وتشغّله، فتحصل على خطأ بدلًا من فيديو. مع Veo 3.1 يحدث ذلك أكثر مما ينبغي، لأن الاسم الوارد في منشور الإطلاق واسم Gemini API والاسم على منصة تابعة لطرف ثالث ثلاث سلاسل مختلفة. تسرد هذه الصفحة المعرّفات الدقيقة لـ Veo 3.1 وVeo 3.1 Fast وVeo 3.1 Lite، وما يستطيع كل منها، وتكلفة كل منها للثانية، وكيفية استدعائها دون تخمين.

الخلاصة المختصرة: في Gemini API تكون الأسماء الثلاثة veo-3.1-generate-preview وveo-3.1-fast-generate-preview وveo-3.1-lite-generate-preview. يشرح ما يلي سبب شكلها، وأيها يناسب عملك، وكيفية تشغيل النماذج نفسها على PicassoIA إذا كنت تفضّل النقر على البرمجة. إذا فشل طلب فورًا، فقارن سلسلتك بالجدول أدناه قبل أي شيء آخر، لأن خطأ حرف واحد سهل الوقوع ويصعب ملاحظته في نص برمجي طويل.

معرّفات النماذج الثلاثة

توثيق Gemini API من Google يسرد هذه الرموز لعائلة Veo 3.1. انسخها كما هي تمامًا، بما في ذلك النهاية -preview.

💡 نصيحة: المعرّفات سلاسل حرفية. veo-3.1 وveo3.1 وveo-3-1-fast ليست أيًّا من الرموز الثلاثة أعلاه، لذا فالطلب الذي يستخدمها يطلب نموذجًا غير موجود في قائمة Google.

Veo 3.1 القياسي

veo-3.1-generate-preview يتصدّر العائلة. وفق جدول خصائص Google يقبل نصًا أو صورة كمدخل، ويعيد فيديو مع صوت مولَّد أصليًا، ويوفّر مخرجات بدقة 720p و1080p و4k. تمتد المقاطع 4 أو 6 أو 8 ثوانٍ، وتقتصر دقتا 1080p و4k على 8 ثوانٍ. اختره عندما يكون المقطع هو المخرج النهائي ويسمح الميزانية بذلك.

Veo 3.1 Fast

veo-3.1-fast-generate-preview يشارك النموذج القياسي صفوف المدخلات والمخرجات والدقة والمدة نفسها في جدول Google. ما يتغيّر هو ما تتنازل عنه: سعر أقل للثانية وانتظار أقصر. في أمثلة التوليد المنشورة على صفحته في PicassoIA، انتهت مقاطع Fast خلال نحو 45 إلى 59 ثانية، مقابل 72 إلى 114 ثانية لأمثلة صفحة Veo 3.1 القياسي.

Veo 3.1 Lite

veo-3.1-lite-generate-preview هو الفئة الأرخص. يدعم 720p و1080p (لمدة 8 ثوانٍ فقط)، ولا يوفّر مخرجات 4k، ويقول توثيق Google إن تمديد الفيديو غير متاح له. انتهت أمثلة صفحة Veo 3.1 Lite خلال نحو 37 إلى 42 ثانية. فكّر فيه كفئة الكميات: عشرات المسودات ومقاطع التواصل الاجتماعي والحلقات الخلفية.

من أين تأتي الأسماء

قراءة النمط

كل معرّف يتبع شكلًا واحدًا: الإصدار، ثم الفئة الاختيارية، ثم كلمة generate، ثم مرحلة الإصدار. لذلك يُقرأ veo-3.1-fast-generate-preview على أنه Veo 3.1، وفئة Fast، وgenerate، ومرحلة preview.

تستخدم نماذج Veo 3 الأقدم لاحقة مرحلة مختلفة. veo-3.0-generate-001 وveo-3.0-fast-generate-001 مدرجان كنسخ مستقرة، بمقاطع مدتها 8 ثوانٍ بدقة 720p أو 1080p. إذا أردت هذين النموذجين على PicassoIA، فهما Veo 3 وVeo 3 Fast.

Preview تعني أن Google ما زالت قادرة على تغيير السلوك أو الحدود أو السعر. ضع السلسلة في ثابت إعدادات واحد، حتى يكفي تعديل واحد لتحديث مشروعك كله في اليوم الذي يتغيّر فيه اسم.

مستقر أم preview؟ إذا كان منتجك لا يتحمل تغيير اسم النموذج أو سعره، فالزوج المستقر Veo 3 أأمن أساس، ما دامت مقاطع 8 ثوانٍ بدقة 720p أو 1080p كافية. إذا احتجت مدد 4 أو 6 أو 8 ثوانٍ، أو فئة Lite الأرخص، أو مخرجات 4k، فأنت في منطقة preview وعليك أن تخطّط للتغيير. سجّل سلسلة النموذج بجوار كل ملف مولَّد حتى تستطيع إعادة إنتاج النتيجة أو مراجعتها بعد شهور.

الأسماء على منصات أخرى

لا تلصق أبدًا سلسلة Gemini API في منصة أخرى. تدرج PicassoIA هذه النماذج تحت المالك google، بأسماء تُسقط كلمتي generate وpreview، وبمعرّفات صفحات تُسقط النقاط.

القاعدة العملية: الأداة التي تتعامل مع Gemini API تريد veo-3.1-generate-preview، أما الأداة أو الكتالوج الذي يعمل بأزواج المالك والاسم فيريد google/veo-3.1. الخلط بين الاثنين طريقة سهلة لطلب نموذج غير موجود.

تحتفظ Vertex AI في Google Cloud بقائمة نماذج خاصة بها. اقرأ المعرّف من تلك اللوحة بدلًا من افتراض أنه يطابق سلسلة Gemini API.

المواصفات جنبًا إلى جنب

كل الأرقام أدناه مأخوذة من توثيق Gemini API من Google الخاص بـ Veo.

قاعدة 1080p

تربط Google دقة 1080p (ودقة 4k في النماذج التي تدعمها) بمقاطع مدتها 8 ثوانٍ، ونموذج Lite على PicassoIA يكرر القاعدة نفسها: يجب أن تكون المدة 8 عند اختيار 1080p. تعامل مع الدقة والمدة كزوج واحد. المقطع بمدة 4 أو 6 ثوانٍ يعني 720p.

ما الذي يغيبه Lite

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

تكلفة كل استدعاء

تحاسب Google على Veo بالثانية من الفيديو المولَّد. هذه أسعار الصوت المدمج في صفحة التسعير لديها وقت كتابة هذا المقال، مع تكلفة مقطع واحد مدته 8 ثوانٍ.

💡 تحقّق قبل وضع الميزانية: هذه نماذج preview، والأسعار في مرحلة preview قد تتغيّر. تنص Google أيضًا على أنك لا تُحاسَب إلا عندما يُولَّد الفيديو بنجاح.

رخيص في المسودات، مكلف في النهائي

احسب الأرقام على دفعة حقيقية. عشر مسودات بطول 8 ثوانٍ على Lite بدقة 720p تكلّف 10 × $0.40 = $4.00. ثلاث تحسينات على Fast بدقة 1080p تكلّف 3 × $0.96 = $2.88. نسخة نهائية واحدة على القياسي بدقة 1080p تكلّف $3.20. المجموع: $10.08. أما توليد الأربعة عشر مقطعًا كلها على القياسي بدقة 1080p فسيكلّف 14 × $3.20 = $44.80 لعدد التوليدات نفسه.

المسودات الأقصر توفّر أكثر. مدة 4 ثوانٍ مسموح بها بدقة 720p، لذا تكلّف مسودة Lite 4 × $0.05 = $0.20، وتكلّف مسودة Fast $0.40، ومسودة القياسي $1.60. ثبّت حركة الكاميرا والصوت على مسودات 4 ثوانٍ، ثم أنفق الـ 8 ثوانٍ مرة واحدة بعد أن ينجح الأمر النصي.

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

استدعاء Python يعمل

يعرض توثيق Google النمط أدناه للنموذج القياسي. يستخدم حزمة SDK الخاصة بـ google-genai، ويبدأ عملية طويلة الأمد ويستعلم عنها حتى يصبح الفيديو جاهزًا. يقرأ العميل بيانات اعتمادك لـ Gemini من متغيرات البيئة، لذا جهّزها بالطريقة التي تشرحها Google AI Studio قبل التشغيل.

import time
from google import genai
from google.genai import types

client = genai.Client()

prompt = "A slow dolly shot along a rainy street at dusk, a street musician plays saxophone, rain and distant traffic in the audio"

operation = client.models.generate_videos(
    model="veo-3.1-generate-preview",
    prompt=prompt,
)

while not operation.done:
    print("Waiting for video generation to finish...")
    time.sleep(10)
    operation = client.operations.get(operation)

generated_video = operation.response.generated_videos[0]
client.files.download(file=generated_video.video, destination="output.mp4")

نسخ الأمر النصي

الانتقال بين الفئات يغيّر وسيطًا واحدًا. احفظ الأسماء الثلاثة في قاموس ومرّر الاسم الذي تحتاجه:

VEO_MODELS = {
    "standard": "veo-3.1-generate-preview",
    "fast": "veo-3.1-fast-generate-preview",
    "lite": "veo-3.1-lite-generate-preview",
}

operation = client.models.generate_videos(
    model=VEO_MODELS["fast"],
    prompt=prompt,
)

نسخ الأمر النصي

الاستعلام عن العملية

الاستدعاء يعيد عملية، لا فيديو. تتحقق حلقتك من operation.done كل 10 ثوانٍ ثم تنزّل الملف. خصّص انتظارًا من دقيقة أو دقيقتين للنموذج القياسي، وأقل لنموذجي Fast و Lite، استنادًا إلى التوقيتات الواردة أعلاه. لا تعيد الإرسال بينما تكون العملية ما زالت تعمل، وإلا فستولّد مقطعًا ثانيًا وتدفع ثمنه.

أخطاء تهدر المال

• اللاحقة الناقصة. veo-3.1-generate دون -preview ليس رمزًا مدرجًا.
• 4k على Lite. هذه الفئة لا توفّره.
• 1080p مع مقطع مدته 6 ثوانٍ. اضبط 8 ثوانٍ، أو انزل إلى 720p.
• تمديد مقطع Lite. تقول Google إن التمديد غير متاح لـ Lite.
• تشتيت السلاسل. إذا كتبت المعرّف بشكل ثابت في عشرة ملفات، فإن إعادة التسمية ستكلّفك نصف يوم.

قبل وضع دفعة في الطابور، مرّ على قائمة التحقق القصيرة هذه:

• سلسلة النموذج تطابق أحد الرموز الثلاثة في الجدول الأول حرفًا بحرف.
• الدقة والمدة زوج صالح: 1080p يعني 8 ثوانٍ.
• الفئة التي اخترتها تدعم ما تحتاجه: 4k والتمديد والصور المرجعية غير متاحة على Lite.
• سجّلت سلسلة النموذج والأمر النصي بجوار كل ملف مخرجات.
• ضربت سعر الثانية في عدد المقاطع قبل أن تضغط تشغيل.

أي نموذج يناسب عملك

Fast للتكرار

تحتاج معظم الأوامر إلى ثلاث أو أربع إعادات صياغة قبل أن تستقر حركة الكاميرا والصوت حيث تريدهما. نفّذ إعادات الصياغة على Veo 3.1 Fast، ثم رقِّ الأمر الفائز إلى النموذج القياسي.

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

القياسي للنهائيات

عندما يُعرض المقطع في صفحة هبوط أو عرض للعميل أو على شاشة كبيرة، تكون التكلفة الإضافية لـ Veo 3.1 سهلة التبرير. وهو أيضًا الفئة الوحيدة في هذه العائلة التي تتوفر فيها الصور المرجعية على PicassoIA، ويشارك Fast صف 4k في جدول Google.

Lite للكميات

Veo 3.1 Lite يناسب أي سير عمل تحتاج فيه عشرات المقاطع القصيرة: حلقات المنتجات، والمنشورات العمودية، ولقطات خلفية لبودكاست. بدّل نسبة العرض إلى الارتفاع إلى 9:16 واضبط 720p للحصول على أرخص نتيجة.

كيفية استخدام Veo 3.1 على PicassoIA

لا كود، ولا بيانات اعتماد، والعائلة نفسها من النماذج. إليك الخطوات في صفحة Veo 3.1:

1. افتح صفحة النموذج. انتقل إلى Veo 3.1 على PicassoIA.
2. اكتب الأمر النصي. هذا هو الحقل الإلزامي الوحيد. صف الشخص والحركة والإضاءة والصوت الذي تريد سماعه.
3. حدّد المدة. اختر 4 أو 6 أو 8 ثوانٍ. القيمة الافتراضية هي 8.
4. حدّد الدقة والنسبة. اختر 720p أو 1080p (الافتراضي هو 1080p)، و16:9 أو 9:16.
5. أبقِ الصوت مفعّلًا. خيار الصوت مفعّل افتراضيًا. أضف أمرًا نصيًا سلبيًا لأي شيء تريد استبعاده.
6. ولّد ونزّل. انتظر المقطع ثم احفظ الملف.

الإطارات والصور المرجعية

أضف صورة إدخال لتبدأ من إطارك الأول الخاص. وأضف إطارًا أخيرًا أيضًا، وسيبني النموذج انتقالًا بين الاثنين. الصور المثالية بنسبة 16:9 أو 9:16 بدقة 1280x720 أو 720x1280، بما يطابق النسبة التي تختارها.

للحفاظ على ثبات شخص ما، ارفع من صورة إلى ثلاث صور مرجعية بدلًا من ذلك. يعمل هذا على النموذج القياسي فقط، ومع 16:9 و8 ثوانٍ فقط. إذا قدّمت صورًا مرجعية، يُتجاهل الإطار الأخير، لذا اختر أسلوبًا واحدًا لكل مقطع.

Fast وLite على PicassoIA

Veo 3.1 Fast يعتمد 1080p افتراضيًا ويحتفظ بالأمر النصي السلبي ومفتاح الصوت. Veo 3.1 Lite يعتمد 720p افتراضيًا، ويشترط 8 ثوانٍ كلما اخترت 1080p.

💡 تبرمج ضد PicassoIA؟ وقت كتابة هذا المقال، كانت PicassoIA API للمطوّرين تدرج أربعة من نماذجها الخاصة، ومنها PicassoIA Video وSeedance 2.5 Lite، بدلًا من نماذج Veo من Google. معرّفات Veo في هذا المقال تخص Gemini API، وصفحات Veo أعلاه مخصصة للمتصفح.

أنشئ أول مقطع لك اليوم

اختر أمرًا نصيًا واحدًا وشغّله ثلاث مرات: مرة على Veo 3.1، ومرة على Fast، ومرة على Lite. احتفظ بقيمة البذرة نفسها حيثما يتيحها النموذج، ثم ضع المقاطع الثلاثة جنبًا إلى جنب. سترى فرق السعر والسرعة خلال نحو خمس دقائق، وستعرف أي فئة تستحق مكانًا في سير عملك.

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

تجمع PicassoIA الثلاثة في موقع واحد، فيمكنك الاختبار قبل أن تكتب سطرًا واحدًا من كود الدمج. افتح Veo 3.1 أو Veo 3.1 Fast أو Veo 3.1 Lite، واكتب المشهد الذي تتخيله، وشاهده يتحول إلى مقطع مع صوت.