Source: https://ailoot.ai/models/ar/google-veo-3-1-lite/ Canonical: https://ailoot.ai/models/ar/google-veo-3-1-lite/ Language: ar # Google: Veo 3.1 Lite [Markdown](https://ailoot.ai/models/ar/google-veo-3-1-lite/index.md) · [JSON](https://ailoot.ai/models/ar/google-veo-3-1-lite/facts.json) ## [Google: Veo 3.1 Lite](https://ailoot.ai/models/ar/google-veo-3-1-lite/) يولّد Veo 3.1 Lite فيديو بصوت أصلي من وصف نصي أو صورة أولية. وينتج مسار Lite الموثّق مقطعًا واحدًا بمدة 4 أو 6 أو 8 ثوانٍ وتأطير أفقي أو رأسي، وبحدود محدّدة تختلف عن Veo 3.1 وFast. - [**Ailoot Ultra · فيديو** `POST /v1/videos` `google/veo-3.1-lite`](https://ailoot.ai/models/ar/google-veo-3-1-lite/#method-0) عن النموذج يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في 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`](https://ailoot.ai/models/ar/#m=google%2Fveo-3.1-lite&route=Ultra&caller=google%2Fveo-3.1-lite&fmt=videos) 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 مبلغًا تقديريًا قبل الطلب. وبعد ظهور النتيجة، تُسوّي الرسوم النهائية بناءً على الاستخدام المقاس. وتستخدم تسوية البث سجل الاستخدام النهائي. [كيفية عمل حجز المبلغ وتسوية الرسوم →](https://ailoot.ai/docs/ar/billing/reserve/) #### تفاصيل التعرفة المرجعية لا تغيّر جداول التعرفة المرجعية على مستوى النموذج اختيار الطريقة أو عروض الأسعار أو الرسوم. وتستخدم الرسوم الفعلية تعرفات طريقة Ailoot المحددة. مراجع أسعار إعدادات الفيديو #### الأسعار حسب الإعدادات طابق كل رسم مع الشروط المعروضة. طبّق تعرفة واحدة لكل مجموعة من الإعدادات البديلة. | الإعدادات | شروط الفوترة | الرسوم | | --- | --- | --- | | الإعداداتسعر الفيديو | شروط الفوترةالصوت: with\_audio | الرسوم الإخراج · سعر الفيديو **$0.16** لكل ثانية فيديو مرجع السعر المنشور للإعداد المعروض. تتبع الرسوم النهائية الإعداد الفعلي الذي تمت فوترته. | | الإعداداتسعر الفيديو | شروط الفوترةالصوت: without\_audio | الرسوم الإخراج · سعر الفيديو **$0.1** لكل ثانية فيديو مرجع السعر المنشور للإعداد المعروض. تتبع الرسوم النهائية الإعداد الفعلي الذي تمت فوترته. | | الإعداداتسعر الفيديو | شروط الفوترةالصوت: with\_audio؛ الدقة: 720p | الرسوم الإخراج · سعر الفيديو **$0.1** لكل ثانية فيديو مرجع السعر المنشور للإعداد المعروض. تتبع الرسوم النهائية الإعداد الفعلي الذي تمت فوترته. | | الإعداداتسعر الفيديو | شروط الفوترةالصوت: without\_audio؛ الدقة: 720p | الرسوم الإخراج · سعر الفيديو **$0.06** لكل ثانية فيديو مرجع السعر المنشور للإعداد المعروض. تتبع الرسوم النهائية الإعداد الفعلي الذي تمت فوترته. | ### أمثلة للطلبات #### Ailoot Ultra · فيديو curlcurl · حرّك إطارك الأول ```bash 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 ``` ```bash 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 · جلب الحالة ```bash 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 · جلب جميع الأصول المكتملة ```bash 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 · جلب المحتوى ```bash 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`](https://ailoot.ai/models/ar/#m=google%2Fveo-3.1-lite&route=Ultra&caller=google%2Fveo-3.1-lite&fmt=videos) #### الأسماء البديلة لمسارات الطرائق `/v1/videos/generations`, `/videos`, `/videos/generations` #### معرّفات النماذج ذات الصلة IDs [`google/veo-3.1-lite`](https://ailoot.ai/models/ar/#m=google%2Fveo-3.1-lite&route=Ultra&caller=google%2Fveo-3.1-lite&fmt=videos) 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% أدخل الرمز عند الشراء. يعاد حساب السعر وفق العرض الساري. المصروفات في السجل يحفظ النموذج والرموز والمبلغ لكل طلب. [اختر اشتراكا](https://ailoot.ai/docs/ar/billing/subscriptions/) · [اعرض أسعار النماذج](https://ailoot.ai/models/ar/) ## اربط API بالمنتج الذي تبيعه. SaaS والتطبيقات والبوتات وفق العرض واتفاقية ترخيص Ailoot. لإعادة البيع، اطلب ترخيص موزع. تطبيق تجاري أضف توليد النص والصور والفيديو والصوت إلى ميزات خدمتك المدفوعة. ترخيص إعادة البيع أرسل وصف المشروع وطريقة توفير الوصول. اطلب شروط استخدام وإعادة بيع مكتوبة. المستندات على الموقع العرض واتفاقية الترخيص وسياسة معالجة البيانات متاحة قبل الربط. [اطلب ترخيص إعادة بيع](mailto:support@ailoot.ai) · [العرض واتفاقية الترخيص](https://ailoot.ai/legal/offer?lang=ar) ## Ailoot · الشركة ومحفظة مشاريعها تستند Ailoot إلى خبرة تشغيلية متراكمة وقاعدة عملاء واسعة وخدمة مستقرة ومراقبة مستمرة لمؤشرات الأداء KPI. الشركة ومحفظة مشاريعها: ملايين العملاء؛ مبيعات بالمليارات شهريًا. توظف Ailoot هذه الخبرة التشغيلية لإتاحة الوصول عبر API إلى قدرات الذكاء الاصطناعي في منتجات العملاء ووكلائهم وتطبيقاتهم وعمليات الأتمتة.