النماذج

Google: Veo 3.1 Lite

Markdown · JSON

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

Google /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 · فيديو

curlcurl · حرّك إطارك الأول
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}/content
  • GET /v1/videos/generations/{request_id}/content
التحقق من حالة المهمة
GET · جلب الحالة
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
حفظ جميع الأصول المكتملة
GET · جلب جميع الأصول المكتملة
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
عمليات أخرى لقراءة المحتوى
GET · جلب المحتوى
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

google/veo-3.1-lite

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

المزيد من التفاصيل

اربط Ailoot بخدمة Claude Code أوOpenCode أوHermes أوتطبيقك.

الشركة ومحفظة مشاريعها

الشركة ومحفظة مشاريعها: ملايين العملاء؛ مبيعات بالمليارات شهريًا.

اشتر الرموز بخصم.

خصم اشتراك للعمل المنتظم. الرموز الترويجية حتى 50% على شراء الرموز.

الاشتراك
اختر خطة بخصم لطلباتك المنتظمة.
رمز خصم حتى 50%
أدخل الرمز عند الشراء. يعاد حساب السعر وفق العرض الساري.
المصروفات في السجل
يحفظ النموذج والرموز والمبلغ لكل طلب.

اختر اشتراكا · اعرض أسعار النماذج

اربط API بالمنتج الذي تبيعه.

SaaS والتطبيقات والبوتات وفق العرض واتفاقية ترخيص Ailoot. لإعادة البيع، اطلب ترخيص موزع.

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

اطلب ترخيص إعادة بيع · العرض واتفاقية الترخيص