Google: Veo 3.1 Lite
يولّد Veo 3.1 Lite فيديو بصوت أصلي من وصف نصي أو صورة أولية. وينتج مسار Lite الموثّق مقطعًا واحدًا بمدة 4 أو 6 أو 8 ثوانٍ وتأطير أفقي أو رأسي، وبحدود محدّدة تختلف عن Veo 3.1 وFast.
عن النموذج
يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة.
Veo 3.1 Lite عضو Lite من Google في سلسلة Veo 3 لتوليد الفيديو. يُنشئ فيديو بصوت من وصف باللغة الطبيعية أو صورة مدخلة. والناتج مقطع مولَّد، وليس تحليلًا نصيًا لتسجيل موجود. تُحيل بطاقة Lite لدى الجهة المطوّرة إلى Veo 3 فيما يخص البنية الأساسية ومواد التدريب والقيود المعروفة، بينما تحدّد وثائق Lite الخاصة ميزات التوليد وحدوده.
تستخدم البنية المشار إليها الانتشار الكامن على التمثيلات الصوتية الزمنية وتمثيلات الفيديو المكانية الزمنية. وقد دُرّب النموذج الأساسي على الصوت والفيديو والصور، مع أوصاف نصية بمستويات مختلفة من التفصيل ومواد تدريب مصفّاة ومنزوعة التكرار. وهذا يوضّح غرض توليد الصورة والصوت معًا. لكنه لا يكشف عدد معلمات خاصًا بLite ولا يثبت أن كل حركة مولَّدة تتبع الواقع الفيزيائي. ولمشهد عملي، حدّد الفعل المرئي والصوت المقابل له معًا.
تحدّد وثائق Lite الدقيقة حدًا للمدخل النصي قدره 1,024 توكن وفيديو إخراج واحدًا. ويسرد عمود Lite في دليل التوليد مدد 4 و6 و8 ثوانٍ، مع 720p افتراضيًا واشتراط مقطع من 8 ثوانٍ لدقة 1080p. ونسبة الأبعاد الافتراضية هي 16:9 أفقيًا، وتُذكر 9:16 رأسيًا أيضًا؛ وتُوثَّق المخرجات بمعدل 24 إطارًا في الثانية. الصوت الأصلي مفعّل دائمًا في هذا المسار. وتخص هذه القيم مسار Lite المسمّى لدى المنتج، لا إصدار Veo غير مرتبط أو استجابة تطبيق قِيست بصورة مستقلة.
لا يدعم Lite إخراج 4K أو تمديد الفيديو. ويشير جدول المعلمات أيضًا إلى عدم إتاحة ميزة referenceImages متعددة المراجع أو إدخال فيديو للتمديد في عمود Lite. ويمكن لصورة أولية تحديد الإطار الافتتاحي؛ ويسرد الجدول صورة lastFrame إلى جانب تلك الصورة الأولية لإنشاء انتقال. أبقِ مسار التحكّم بالإطارات هذا منفصلًا عن مزج عدة مراجع للأسلوب أو العنصر. وإعدادات توليد الأشخاص لدى المنتج خاصة بالوضع: يسرد جدول Lite القيمة allow_all لتحويل النص إلى فيديو وallow_adult لتحويل الصورة إلى فيديو والاستيفاء، بينما يمكن للقواعد الإقليمية أن تقيّد الملف الموثّق أكثر. اختر الصورة الافتتاحية لتلائم المشهد الأول الذي تريده فعليًا، مع تجهيز العنصر والتأطير والتفاصيل الظاهرة قبل طلب الحركة.
لتحويل النص إلى فيديو، صِف العنصر وفعله والبيئة والأسلوب المقصود. وأضف موضع الكاميرا وحركتها والتأطير والتركيز والضوء عندما تكون مهمة. ويمكن لمشهد مبتكر لمنتج إبقاء الجسم في المنتصف بينما تقترب الكاميرا من تفصيل في مادته وتتغيّر الإضاءة المحيطة بلطف. حدّد الحالة الأولية والفعل الرئيسي واللحظة النهائية كي ينجز المقطع القصير فكرة مترابطة واحدة. فمجموعة طويلة من أفعال غير مترابطة مهمة مختلفة عن لقطة مركّزة.
لتحويل الصورة إلى فيديو، قدّم إطارًا أوليًا واضحًا واشرح ما ينبغي أن يتحرّك وما ينبغي أن يبقى ثابتًا. حدّد حركة العنصر وأي حركة للكاميرا بصورة مستقلة. وإذا استخدمت قيدًا للإطار النهائي، فجهّز تكوينًا ختاميًا متوافقًا وصِف الانتقال بينهما. افحص النتيجة بدلًا من افتراض بقاء الهوية أو الموضع أو الشكل المطلوب مطابقًا طوال المقطع. وتعدّ بطاقة النموذج المشار إليها الاتساق الكامل في المشاهد المعقّدة والحركة المعقّدة تحديًا مستمرًا.
يدعم دليل التوجيه إشارات صريحة للحوار والمؤثرات الصوتية والأجواء. ضع الكلام الدقيق بين علامتي اقتباس، وحدّد المتحدّث، وصِف الأصوات في علاقتها بالفعل المرئي. ويجب ألّا يُخلط مؤثر صوتي أو جو خلفي بعبارة منطوقة. وتُوثَّق الإنجليزية كمدعومة بالكامل للتوجيه، بينما لم تُقيَّم اللغات الأخرى في ذلك الدليل. راجع الكلمات المسموعة والتوقيت وجودة الصوت كجزء من الملف نفسه مع الفيديو، بدلًا من التعامل مع الصوت كنسخة مضمونة الأمانة من التوجيه.
مسار المنتج غير متزامن: يعيد طلب التوليد عملية، وتُسترجع النتيجة المكتملة بعد أن تُبلغ حالتها عن الاكتمال. احتفظ بهوية العملية وافحص المقطع الناتج. يصف الدليل الاحتفاظ لدى المنتج ليومين ووضع علامة SynthID، لذا ينبغي أن يشمل الناتج المحتفَظ به الملف المنزَّل والتوجيه والصور المصدرية والإعدادات المختارة. ويمكن للبذرة تحسين قابلية التكرار، لكنها لا تضمن الحتمية. تحقّق من استمرارية العنصر والفعل والتأطير والصوت ونقطة نهاية المشهد المقصودة قبل استخدام المقطع في المونتاج؛ فاكتمال المعالجة وحده لا يثبت استيفاء المتطلبات الإبداعية.
Ailoot Ultra · فيديو POST /v1/videos google/veo-3.1-lite
google/veo-3.1-liteالبداية
حوّل وصف مشهد إلى فيديو بدقة 720p مدته 4 أو 6 أو 8 ثوانٍ.
- اعرض منتجًا وهو يتحرك
- أنشئ مشهدًا يعرّف بالمكان
- جرّب حركة قصيرة للكاميرا
- المدخلات المقبولة
- النص · الصور
- النتائج
- فيديو
متاح في Ailoot · المدخلات والطرائق
Ailoot Ultra · فيديو POST /v1/videos
- الإدخال
text,image- الإخراج
video- صيغة الإخراج
- mp4
- عدد المخرجات
- حتى 4 إخراجs
| الحقل | النوع | المتطلب | القيم والحدود | القيمة الافتراضية |
|---|---|---|---|---|
الحقلmodel | النوعstring | المتطلبمطلوب | القيم والحدود google/veo-3.1-lite | القيمة الافتراضية— |
الحقلprompt | النوعstring | المتطلبمطلوب | القيم والحدود الحد الأدنى للطول: 1 الحد الأقصى للبايتات: 10,000 الوحدة: بايتات UTF8 | القيمة الافتراضية— |
الحقلduration | النوعinteger | المتطلبمطلوب | القيم والحدود 4, 6, 8 الوحدة: ثوانٍ | القيمة الافتراضية— |
الحقلresolution | النوعstring | المتطلبمطلوب | القيم والحدود 720p | القيمة الافتراضية— |
الحقلaspect_ratio | النوعstring | المتطلبمطلوب | القيم والحدود 16:9, 9:16 | القيمة الافتراضية— |
الحقلgenerate_audio | النوعboolean | المتطلبمطلوب | القيم والحدود false | القيمة الافتراضية— |
الحقلframe_images | النوعarray | المتطلباختياري | القيم والحدود الشروط: احذف هذا الحقل عند استخدام text_to_video. عند تضمينه: عنصر واحد بالضبط بالصيغة {"type":"image_url","image_url":{"url":"<عنوان HTTPS URL فعلي>"},"frame_type":"first_frame"}؛ يحتوي العنصر على type,image_url,frame_type فقط؛ ويحتوي image_url على url فقط. لا تضف مفاتيح إضافية أو مكررة. القيم الوحيدة المسموح بها هي duration=4,resolution="720p",aspect_ratio="16:9",generate_audio=false. يجب أن يُحلَّل عنوان URL بمخطط https واسم مضيف غير فارغ، دون userinfo أو الرمز # بصورته الحرفية؛ مع الحفاظ على الاستعلام الموقّع والمسار المُرمّز. لا يتحقق المصدر من MIME المدخل أو حجم الملف أو أبعاده بالبكسل. | القيمة الافتراضية— |
تركيبات مواد الإدخال
تحويل النص إلى فيديو · مطلوب: prompt
تحويل الصورة إلى فيديو · مطلوب: prompt, frame_images
معلمات الطريقة ودورة حياتها
| المعلمة | المواصفات |
|---|---|
المعلمةcontent_type | المواصفاتapplication/json |
المعلمةrequired | المواصفاتmodel, prompt, duration, resolution, aspect_ratio, generate_audio |
المعلمةother_options | المواصفاتfalse |
المعلمةresolution | المواصفات720p |
المعلمةprompt_max_bytes | المواصفات10000 |
المعلمةduration | المواصفات4, 6, 8 |
المعلمةaspect_ratio | المواصفات16:9, 9:16 |
المعلمةgenerate_audio | المواصفاتfalse |
المعلمةmaterial_types | المواصفاتtext, image |
المعلمةparameters | المواصفات{"name":"model","type":"string","required":true,"default_known":false,"default":null,"enum_known":true,"enum":["google/veo-3.1-lite"],"availability":"source_interface"}, {"name":"prompt","type":"string","required":true,"default_known":false,"default":null,"enum_known":false,"enum":null,"availability":"source_interface","min_length":1,"maximum_bytes":10000,"maximum_length":null,"unit":"بايتات UTF8"}, {"name":"duration","type":"integer","required":true,"default_known":false,"default":null,"enum_known":true,"enum":[4,6,8],"availability":"source_interface","unit":"ثوانٍ"}, {"name":"resolution","type":"string","required":true,"default_known":false,"default":null,"enum_known":true,"enum":["720p"],"availability":"source_interface"}, {"name":"aspect_ratio","type":"string","required":true,"default_known":false,"default":null,"enum_known":true,"enum":["16:9","9:16"],"availability":"source_interface"}, {"name":"generate_audio","type":"boolean","required":true,"default_known":false,"default":null,"enum_known":true,"enum":[false],"availability":"source_interface"}, {"name":"frame_images","type":"array","required":false,"default_known":false,"default":null,"enum_known":false,"enum":null,"availability":"source_interface","conditions":"احذف هذا الحقل عند استخدام text_to_video. عند تضمينه: عنصر واحد بالضبط بالصيغة {\"type\":\"image_url\",\"image_url\":{\"url\":\"<عنوان HTTPS URL فعلي>\"},\"frame_type\":\"first_frame\"}؛ يحتوي العنصر على type,image_url,frame_type فقط؛ ويحتوي image_url على url فقط. لا تضف مفاتيح إضافية أو مكررة. القيم الوحيدة المسموح بها هي duration=4,resolution=\"720p\",aspect_ratio=\"16:9\",generate_audio=false. يجب أن يُحلَّل عنوان URL بمخطط https واسم مضيف غير فارغ، دون userinfo أو الرمز # بصورته الحرفية؛ مع الحفاظ على الاستعلام الموقّع والمسار المُرمّز. لا يتحقق المصدر من MIME المدخل أو حجم الملف أو أبعاده بالبكسل."} |
الأسماء البديلة للطريقة: /v1/videos/generations, /videos, /videos/generations
دورة الحياة: submit_once_poll_original
GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content
أنشئ مرة واحدة واحفظ المعرّف المُعاد.
استعلم دورياً عن الحالة الأصلية؛ واحتفظ بكل أصل مكتمل ومدته.
الباقات
كيفية احتساب الرسوم النهائية
تقدّر التعرفات المعروضة التكلفة قبل التوليد. تُحسب الرسوم النهائية من التكلفة المسجّلة لعملية التوليد الأصلية. مدة المخرجات المقاسة والكميات المتوقعة ليست الكمية النهائية الخاضعة للفوترة.
مراجع التسعير لا تضيف خيارات للطلب. المعلمات المدعومة مذكورة للطريقة المحددة.
- الوضع السريع
- غير محدد عند اختيار الوضع السريع
- الوضع المرن
- غير محدد عند اختيار وضع flex
- أقصى جهد للاستدلال
- غير محدد عندما يُطبَّق الضبط الافتراضي default مع أقصى جهد للاستدلال
تعرفات تقديرية للمقارنة
الأسعار حسب الإعدادات
طابق كل رسم مع الشروط المعروضة. طبّق تعرفة واحدة لكل مجموعة من الإعدادات البديلة.
| الإعدادات | جدول التعرفة | الكمية المتوقعة | إنشاء الصوت | الدقة | وحدة الفوترة | شروط الفوترة | الرسوم |
|---|---|---|---|---|---|---|---|
| الإعداداتالتعرفات الأساسية للرموز | جدول التعرفةالتعرفة الأساسية | الكمية المتوقعة— | إنشاء الصوت— | الدقة— | وحدة الفوترة— | شروط الفوترة— | الرسوم الإدخال · رموز الإدخال · تقدير للمقارنة فقط — / 1K من الرموز الإخراج · رموز الإخراج · تقدير للمقارنة فقط — / 1K من الرموز الإدخال · قراءة ذاكرة التخزين المؤقت · تقدير للمقارنة فقط — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت · تقدير للمقارنة فقط — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت، 1 ساعة · تقدير للمقارنة فقط — / 1K من الرموز |
| الإعداداتسعر الفيديو | جدول التعرفة— | الكمية المتوقعة— | إنشاء الصوت— | الدقة— | وحدة الفوترةلكل ثانية فيديو | شروط الفوترةالصوت: with_audio | الرسوم الإخراج · سعر الفيديو · تقدير للمقارنة فقط $0.16 لكل ثانية فيديو |
| الإعداداتسعر الفيديو | جدول التعرفة— | الكمية المتوقعة— | إنشاء الصوت— | الدقة— | وحدة الفوترةلكل ثانية فيديو | شروط الفوترةالصوت: with_audio؛ الدقة: 720p | الرسوم الإخراج · سعر الفيديو · تقدير للمقارنة فقط $0.1 لكل ثانية فيديو |
| الإعداداتسعر الفيديو | جدول التعرفة— | الكمية المتوقعة— | إنشاء الصوت— | الدقة— | وحدة الفوترةلكل ثانية فيديو | شروط الفوترةالصوت: without_audio | الرسوم الإخراج · سعر الفيديو · تقدير للمقارنة فقط $0.1 لكل ثانية فيديو |
| الإعداداتUltra | جدول التعرفة— | الكمية المتوقعةالإعدادات المطلوبة؛ تقدير فقط. | إنشاء الصوتمن دون صوت | الدقة720p | وحدة الفوترةلكل ثانية فيديو مُخرج | شروط الفوترة— | الرسوم الإخراج · ثانية تقديرية من الفيديو الناتج · تقدير للمقارنة فقط $0.06 لكل ثانية فيديو مُخرج يقدّر السعر المعروض التكلفة قبل التوليد. يُحسب الرسم النهائي من التكلفة المسجَّلة لعملية التوليد الأصلية. مدة الفيديو الفعلية ليست الكمية الخاضعة للفوترة. |
| الإعداداتتكلفة التوليد التقديرية | جدول التعرفة— | الكمية المتوقعةتقدير لتوليد واحد | إنشاء الصوت— | الدقة— | وحدة الفوترة— | شروط الفوترة— | الرسوم الإخراج · تكلفة التوليد التقديرية · تقدير للمقارنة فقط $0.24 تقدير قبل الإنشاء هذا التقدير ليس رسومًا إضافية ولا تعرفة ثابتة لعملية التوليد المكتملة. |
تحجز Ailoot مبلغًا تقديريًا قبل الطلب. وبعد ظهور النتيجة، تُسوّي الرسوم النهائية بناءً على الاستخدام المقاس. وتستخدم تسوية البث سجل الاستخدام النهائي. كيفية عمل حجز المبلغ وتسوية الرسوم →
تفاصيل التعرفة المرجعية
لا تغيّر جداول التعرفة المرجعية على مستوى النموذج اختيار الطريقة أو عروض الأسعار أو الرسوم. وتستخدم الرسوم الفعلية تعرفات طريقة Ailoot المحددة.
مراجع أسعار إعدادات الفيديو
الأسعار حسب الإعدادات
طابق كل رسم مع الشروط المعروضة. طبّق تعرفة واحدة لكل مجموعة من الإعدادات البديلة.
| الإعدادات | شروط الفوترة | الرسوم |
|---|---|---|
| الإعداداتسعر الفيديو | شروط الفوترةالصوت: with_audio | الرسوم الإخراج · سعر الفيديو $0.16 لكل ثانية فيديو مرجع السعر المنشور للإعداد المعروض. تتبع الرسوم النهائية الإعداد الفعلي الذي تمت فوترته. |
| الإعداداتسعر الفيديو | شروط الفوترةالصوت: without_audio | الرسوم الإخراج · سعر الفيديو $0.1 لكل ثانية فيديو مرجع السعر المنشور للإعداد المعروض. تتبع الرسوم النهائية الإعداد الفعلي الذي تمت فوترته. |
| الإعداداتسعر الفيديو | شروط الفوترةالصوت: with_audio؛ الدقة: 720p | الرسوم الإخراج · سعر الفيديو $0.1 لكل ثانية فيديو مرجع السعر المنشور للإعداد المعروض. تتبع الرسوم النهائية الإعداد الفعلي الذي تمت فوترته. |
| الإعداداتسعر الفيديو | شروط الفوترةالصوت: without_audio؛ الدقة: 720p | الرسوم الإخراج · سعر الفيديو $0.06 لكل ثانية فيديو مرجع السعر المنشور للإعداد المعروض. تتبع الرسوم النهائية الإعداد الفعلي الذي تمت فوترته. |
أمثلة للطلبات
Ailoot Ultra · فيديو
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "google/veo-3.1-lite", "prompt": "A cat in a spacesuit walking on the Moon", "duration": 4, "resolution": "720p", "aspect_ratio": "16:9", "generate_audio": false}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_IMAGE_URL:?Set the actual HTTPS URL of your first-frame image}"
export AILOOT_IMAGE_URL
python3 - <<'PY_REQUEST'
import json,os,re
from pathlib import Path
from urllib.parse import urlsplit
image=os.environ["AILOOT_IMAGE_URL"]
try:
parsed=urlsplit(image)
valid=(image.startswith("https://") and parsed.scheme=="https" and bool(parsed.hostname)
and parsed.username is None and parsed.password is None and "#" not in image
and not any(ord(c)<32 or ord(c)==127 for c in image)
and re.search(r"%(?![0-9A-Fa-f]{2})",image) is None)
except ValueError:
valid=False
if not valid:
raise SystemExit("Use your actual HTTPS image URL with a hostname, no userinfo and no fragment")
p={"model":"google/veo-3.1-lite","prompt":"The subject makes a slow, natural movement. Keep the opening composition.","duration":4,"resolution":"720p","aspect_ratio":"16:9","generate_audio":False,"frame_images":[{"type":"image_url","image_url":{"url":image},"frame_type":"first_frame"}]}
Path("request.json").write_text(json.dumps(p,ensure_ascii=False),encoding="utf-8")
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path("result.json").read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print("Keep the complete JSON, headers and original returned id. Use the existing GET status tab for that original operation, then save every completed owned output. Never resubmit an unknown generation.")
PY_RESULT
استلام النتائج وحفظها
Ailoot Ultra · فيديو
mp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/content
التحقق من حالة المهمة
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_OPERATION_ID
operation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')
curl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/$operation_id" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o status.json
python3 - <<'PY_STATUS'
import json
from pathlib import Path
r=json.loads(Path("status.json").read_text())
print(json.dumps(r))
if r.get("status")=="completed":
for x in r.get("data",[]):print(x)
PY_STATUS
حفظ جميع الأصول المكتملة
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_STATUS_FILE:?Set the actual completed status JSON file}"
export AILOOT_STATUS_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
from urllib.parse import urlsplit,urljoin
f=Path(os.environ["AILOOT_STATUS_FILE"])
if not f.is_file():raise SystemExit("Choose the actual completed status file")
r=json.loads(f.read_text())
if r.get("status")!="completed" or not isinstance(r.get("data"),list) or not r["data"]:raise SystemExit("Wait for a completed status with asset paths")
urls=[]
for x in r["data"]:
if not isinstance(x,str) or "\n" in x or "\r" in x:raise SystemExit("Invalid asset path")
u=urljoin("https://api.ailoot.ai",x)
z=urlsplit(u)
if z.scheme!="https" or z.netloc!="api.ailoot.ai" or z.username or z.password:raise SystemExit("Use the actual Ailoot asset paths from status")
urls.append(u)
Path("asset-urls.txt").write_text("\n".join(urls)+"\n")
PY_REQUEST
index=0
while IFS= read -r asset_url; do
curl --fail-with-body --silent --show-error "$asset_url" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o "video-${index}.mp4"
index=$((index + 1))
done < asset-urls.txt
عمليات أخرى لقراءة المحتوى
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_OPERATION_ID
operation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')
curl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/$operation_id/content" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o video.mp4
الاحتفاظ بكل النتائج المكتملة
احفظ كل فيديو مكتمل أو ملف مُرجع؛ ونزّل كل أصل من URL الخاص به الذي تم إرجاعه فعليًا.
تحتوي data[] المكتملة على جميع عناوين URL الموقّعة للمحتوى المملوك لك. اجلب كل عنوان URL مُعاد، أو استخدم نقطة نهاية المحتوى مع ضبط index على فهرس مخرج فعلي. قد تُعيد المهمة الأصلية الفاشلة charge_pending_check؛ تحقق من تلك المهمة الأصلية بدلاً من إنشائها مرة أخرى. قد يوجد مسار صوتي AAC صالح حتى مع generate_audio=false؛ احتفظ بملف MP4 الأصلي كاملاً، بما فيه ذلك الصوت.
عند الحاجة إلى التحقق من الاستجابة الأصلية
اقرأ المهمة الأصلية الموجودة؛ ولا تعِد إرسال طلب مجهول النتيجة مطلقاً.
الحد الأقصى للمخرجات: 4.
حقول الاستجابة
| الحقل | النوع | المعنى |
|---|---|---|
الحقلid | النوعstring | المعنى— |
الحقلobject | النوعstring | المعنى— |
الحقلmodel | النوعstring | المعنى— |
الحقلstatus | النوعstring | المعنى— |
الحقلdata[] | النوعsigned content URL | المعنى— |
الحقلcharge_pending_check | النوعboolean | المعنى— |
الحقلerror.code | النوعstring | المعنى— |
الحقلerror.message | النوعstring | المعنى— |
الحقلoperation_id | النوعstring | المعنىاستجابة الحالة أو المحتوى الأصليين عند HTTP503 result_pending_check: المعرّف العام للفيديو الأصلي نفسه في الحقل id. |
الحقلerror.type | النوعstring | المعنىserver_error عند HTTP503 result_pending_check. |
الأخطاء والخطوات التالية
| الاستجابة | الشرط | الخطوة التالية |
|---|---|---|
الاستجابة400 · invalid_request_error | الشرطحقول مطلوبة أو تمثيل مادة أو قيمة معلمة غير صحيحة | الخطوة التاليةصحّح الحقول المحددة قبل طلب إنشاء جديد. |
الاستجابة409 · video_not_ready | الشرطمحتوى النتيجة الأصلية غير متاح بعد | الخطوة التاليةاستعلم دورياً باستخدام المعرّف الأصلي المُعاد والتزم بـRetry-After. |
الاستجابةserver_error | الشرطتشير الاستجابة المُعادة إلى أن العملية أو النتيجة تتطلب التحقق | الخطوة التاليةاحتفظ بمعرّف العملية أو المهمة الأصلي المُعاد، وبترويسات الطلب وبالاستجابة؛ وواصل عمليات القراءة المدعومة لتلك العملية الأصلية. لا تُعِد إرسال طلب الإنشاء. |
الاستجابة503 · result_pending_check | الشرطGET للحالة أو المحتوى الأصليين: المهمة غير منشورة، والمهمة الأصلية ليست في حالة failed/cancelled/expired، والحالة المحلية unknown أو حالة المهمة الأصلية completed. | الخطوة التاليةاحتفظ بـid وoperation_id الأصليين (المعرّف العام نفسه للفيديو)، وبالاستجابة والترويسات؛ واقرأ الحالة أو المحتوى الأصليين فقط. لا ترسل طلب توليد جديداً مطلقاً. |
الاستجابة422 · price_unavailable | الشرطيتعذر تحليل كائن frame_images المقدَّم أو ملف إعداده المشروط، أو لا تتوفر بطاقة سعر دقيقة وجاهزة لملف الإعداد الكامل بعد تحليله. | الخطوة التاليةاحتفظ بـmodel وprompt وduration وresolution وaspect_ratio وgenerate_audio. أضف frame_images بحيث يحتوي على عنصر first_frame واحد بالضبط وفق صيغة الكائن المحددة. اضبط duration=4, resolution="720p", aspect_ratio="16:9" وgenerate_audio=false. يُنفَّذ هذا التحقق قبل إرسال الطلب. |
الأسماء البديلة
الأسماء البديلة للنموذج
Ailoot Ultra google/veo-3.1-lite
الأسماء البديلة لمسارات الطرائق
/v1/videos/generations, /videos, /videos/generations
معرّفات النماذج ذات الصلة IDs
FAQ · Google: Veo 3.1 Lite
- ما المدخلات والنتائج المتاحة؟
POST /v1/videos·google/veo-3.1-lite:text,image→video- ما الحقول التي يستخدمها الطلب؟
POST /v1/videos·google/veo-3.1-lite:model,prompt,duration,resolution,aspect_ratio,generate_audio,frame_images