Google: Veo 3.1
Veo 3.1 نموذج الفيديو من Google لمشاهد تنطلق من النص والصورة بصوت مولَّد وإطارات حدود موجّهة ومراجع للعناصر. يوفّر ملفه الإنتاجي مقاطع مدتها أربع أو ست أو ثماني ثوانٍ بمعدل 24 إطارًا في الثانية، بخيارات إخراج تشمل 720p و1080p و4K.
عن النموذج
يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة.
Veo 3.1 نموذج Google لتوليد الفيديو لإنشاء مشهد سمعي بصري قصير من نص أو توجيه ينطلق من صورة. يدعم ملفه الإنتاجي تحويل النص إلى فيديو والصورة إلى فيديو والإنشاء الموجّه بالإطارين الأول والأخير، مع صوت مولَّد ومراجع للعناصر ومسار مستقل للاستكمال. استخدمه لتطوير مفهوم سينمائي أو سرد قصير عن منتج أو مقطع بصري بمشهد وفعل وتجربة استماع محدّدة.
صِف العنصر والحدث المرئي أولًا. حدّد المحيط ووقت اليوم والضوء، ثم زاوية الكاميرا أو حركتها والأسلوب البصري المقصود. ويمكن لتوجيه مبتكر لمشهد أن يعرض إناءً زجاجيًا على سطح استوديو داكن، مع حركة جانبية بطيئة تكشف انعكاسًا بينما يصاحب الكشف صوت بيئي ناعم. تمنح كل تعليمة سمة مرئية أو مسموعة يمكن تقييمها في النتيجة المكتملة.
يتعامل إطار Google للتوجيه مع العنصر والفعل والمشهد والكاميرا والجماليات كأجزاء منفصلة من الوصف. استخدم الأجزاء التي تخدم اللقطة بدلًا من إضافة كل وصف ممكن. اكتب التعليمات بالإنجليزية لملف التوجيه الموثّق. وإذا تضمّن المشهد عدة أفعال، فاذكر علاقتها وأبقِها متناسبة مع مقطع قصير، ليظل الكشف أو رد الفعل واضحًا.
تحدّد الصورة الافتتاحية المظهر والتكوين في البداية. استخدمها عندما تكون الشخصية أو المنتج أو المكان موجودة بالفعل كصورة، وصِف الحركة التي ينبغي أن تتطور منها. ويضيف الإطار الأخير تكوينًا مستهدفًا للنهاية. جهّز إطارات الحدود بما يعبّر عن انتقال معقول ويحافظ على التفاصيل التي تعرّف العنصر الرئيسي، ثم افحص الحركة بين تلك الإطارات بعد التوليد.
تخدم مراجع العناصر غرضًا آخر: فهي توجّه مظهر شخصية أو جسم في مشهد جديد مولَّد، بينما تحدّد إطارات الحدود لحظات بعينها في ذلك المشهد. اختر مراجع تُظهر السمات البصرية المهمة واجعل دور كل مرجع واضحًا في التوجيه. وتستخدم مواصفات تحويل الصور المرجعية إلى فيديو في النموذج الإنتاجي مخرجات من ثماني ثوانٍ لمسار المراجع هذا، بصورة مستقلة عن اختيار المدة المعتاد في التوليد النصي.
يولّد الملف الإنتاجي المعتاد لدى الجهة المطوّرة مقاطع مدتها أربع أو ست أو ثماني ثوانٍ بمعدل 24 إطارًا في الثانية. ويسرد تأطير 16:9 أفقيًا و9:16 رأسيًا، وما يصل إلى أربعة فيديوهات لكل توجيه، ودقات إخراج 720p و1080p و4K. وصيغة فيديو الإخراج MP4. تقبل مواصفات الصور JPEG أو PNG، وتسرد حدًا أقصى للصورة المدخلة قدره 20 MB، وتدعم إعدادات إدخال 720p/1080p. اختر ملف الإخراج لموضع الاستخدام المقصود واجعل تكوين الإطار واضحًا بهذا الحجم.
يمكن للصوت الأصلي مرافقة المشهد المرئي. حدّد العبارات المنطوقة والأجواء والمؤثرات الصوتية كأجزاء من التوجيه نفسه، مع تسمية العنصر أو الحدث الذي يُنتج كلًا منها. تجيب تعليمة الحوار وتعليمة الكاميرا عن سؤالين مختلفين: تحدّد الأولى الأداء، وتحدّد الثانية كيف يراه المشاهد. أبقِ الكلمات ضمن وقت الكلام المفيد في المقطع وراجع الصوت من حيث الوضوح وعلاقته بالفعل.
للاستكمال، توفّر الجهة المطوّرة مسارًا مستقلًا لتمديد الفيديو. ابدأ بمقطع مصدري مولَّد مناسب وصِف الحدث المرئي التالي أو التغيير في المشهد. احتفظ بالجزء الأصلي والمستكمَل كي يمكن مراجعة نقطة الوصل من حيث المظهر والحركة والصوت. ولا ينبغي التعامل مع خيارات المدة والدقة المعتادة للتوليد الجديد كعقد عام لكل عملية تمديد.
يمكن لوصف سلبي تركيز الاستبعادات على المتطلبات البصرية للمهمة. وفي سلسلة تنويعات لمنتج، أبقِ العنصر والتكوين ثابتين مع تغيير اتجاه إبداعي واحد، مثل الإضاءة أو مسافة الكاميرا. سجّل التوجيه والمراجع والإعدادات المختارة مع النتيجة. ويتيح ذلك مقارنة فرق إبداعي مفيد بدلًا من مجموعة عمليات توليد غير مترابطة.
تختلف ملفات دقة الإخراج بين ملف Veo 3.1 الإنتاجي العادي وVeo 3.1 Fast. يسرد Fast دقتي 720p و1080p؛ ويسرد 3.1 العادي 4K أيضًا. احتفظ بالإصدار المختار مرتبطًا بالنتيجة، من دون استبدال معرّف نموذج إنتاجي ضمنيًا بملف Preview أقدم أو جيل Veo آخر. فمظهر العنصر والعملية المدعومة كلاهما يعتمدان على المسار المختار.
التوليد عملية توفّر نتيجتها المكتملة ملفات فيديو للتشغيل والتحرير اللاحق. احتفظ بالملفات الناتجة مع إطاراتها المصدرية ومراجعها وتوجيهها، وحافظ على معلومات منشأ المحتوى المقدَّمة. افحص كل مخرج فعلي من حيث مظهر العنصر والفعل والتأطير والصوت والتكوين النهائي. استخدم المقطع المختار كوحدة بناء للإنتاج، مع إضافة العناوين والانتقالات أو أعمال الإنهاء الأخرى في المونتاج المحيط.
Ailoot Ultra · فيديو POST /v1/videos google/veo-3.1
google/veo-3.1البداية
Veo 3.1 نموذج الفيديو من Google لمشاهد تنطلق من النص والصورة بصوت مولَّد وإطارات حدود موجّهة ومراجع للعناصر. يوفّر ملفه الإنتاجي مقاطع مدتها أربع أو ست أو ثماني ثوانٍ بمعدل 24 إطارًا في الثانية، بخيارات إخراج تشمل 720p و1080p و4K.
- المدخلات المقبولة
- النص
- النتائج
- فيديو
متاح في Ailoot · المدخلات والطرائق
Ailoot Ultra · فيديو POST /v1/videos
- الإدخال
text- الإخراج
video- صيغة الإخراج
- mp4
- عدد المخرجات
- حتى 4 إخراجs
| الحقل | النوع | المتطلب | القيم والحدود | القيمة الافتراضية |
|---|---|---|---|---|
الحقلmodel | النوعstring | المتطلبمطلوب | القيم والحدود google/veo-3.1 | القيمة الافتراضية— |
الحقلprompt | النوعstring | المتطلبمطلوب | القيم والحدود الحد الأقصى لبايتات UTF-8: 10,000 يجب أن يتضمن الإدخال محارف غير المسافات البيضاء: نعم | القيمة الافتراضية— |
الحقلduration | النوعinteger | المتطلبمطلوب | القيم والحدود 4, 6, 8 | القيمة الافتراضية— |
الحقلresolution | النوعstring | المتطلبمطلوب | القيم والحدود 720p | القيمة الافتراضية— |
الحقلaspect_ratio | النوعstring | المتطلبمطلوب | القيم والحدود 16:9, 9:16 | القيمة الافتراضية— |
الحقلgenerate_audio | النوعboolean | المتطلبمطلوب | القيم والحدود false, true | القيمة الافتراضية— |
تركيبات مواد الإدخال
تحويل النص إلى فيديو · مطلوب: prompt
معلمات الطريقة ودورة حياتها
| المعلمة | المواصفات |
|---|---|
المعلمةcontent_type | المواصفاتapplication/json |
المعلمةrequired | المواصفاتmodel, prompt, duration, resolution, aspect_ratio, generate_audio |
المعلمةadditional_properties | المواصفاتfalse |
المعلمةparameters | المواصفات{"name":"model","type":"string","required":true,"enum":["google/veo-3.1"]}, {"name":"prompt","type":"string","required":true,"non_whitespace":true,"max_utf8_bytes":10000}, {"name":"duration","type":"integer","required":true,"enum":[4,6,8]}, {"name":"resolution","type":"string","required":true,"enum":["720p"]}, {"name":"aspect_ratio","type":"string","required":true,"enum":["16:9","9:16"]}, {"name":"generate_audio","type":"boolean","required":true,"enum":[false,true]} |
المعلمةmaterial_types | المواصفاتtext |
الأسماء البديلة للطريقة: /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 من الرموز |
| الإعداداتUltra | جدول التعرفة— | الكمية المتوقعةالإعدادات المطلوبة؛ تقدير فقط. | إنشاء الصوتمع صوت | الدقة720p | وحدة الفوترةلكل ثانية فيديو مُخرج | شروط الفوترة— | الرسوم الإخراج · ثانية تقديرية من الفيديو الناتج · تقدير للمقارنة فقط $0.8 لكل ثانية فيديو مُخرج يقدّر السعر المعروض التكلفة قبل التوليد. يُحسب الرسم النهائي من التكلفة المسجَّلة لعملية التوليد الأصلية. مدة الفيديو الفعلية ليست الكمية الخاضعة للفوترة. |
| الإعداداتسعر الفيديو | جدول التعرفة— | الكمية المتوقعة— | إنشاء الصوت— | الدقة— | وحدة الفوترةلكل ثانية فيديو | شروط الفوترةالصوت: with_audio؛ الدقة: 4k | الرسوم الإخراج · سعر الفيديو · تقدير للمقارنة فقط $1.2 لكل ثانية فيديو |
| الإعداداتUltra | جدول التعرفة— | الكمية المتوقعةالإعدادات المطلوبة؛ تقدير فقط. | إنشاء الصوتمن دون صوت | الدقة720p | وحدة الفوترةلكل ثانية فيديو مُخرج | شروط الفوترة— | الرسوم الإخراج · ثانية تقديرية من الفيديو الناتج · تقدير للمقارنة فقط $0.4 لكل ثانية فيديو مُخرج يقدّر السعر المعروض التكلفة قبل التوليد. يُحسب الرسم النهائي من التكلفة المسجَّلة لعملية التوليد الأصلية. مدة الفيديو الفعلية ليست الكمية الخاضعة للفوترة. |
| الإعداداتسعر الفيديو | جدول التعرفة— | الكمية المتوقعة— | إنشاء الصوت— | الدقة— | وحدة الفوترةلكل ثانية فيديو | شروط الفوترةالصوت: without_audio؛ الدقة: 4k | الرسوم الإخراج · سعر الفيديو · تقدير للمقارنة فقط $0.8 لكل ثانية فيديو |
| الإعداداتتكلفة التوليد التقديرية | جدول التعرفة— | الكمية المتوقعةتقدير لتوليد واحد | إنشاء الصوت— | الدقة— | وحدة الفوترة— | شروط الفوترة— | الرسوم الإخراج · تكلفة التوليد التقديرية · تقدير للمقارنة فقط $1.6 تقدير قبل الإنشاء هذا التقدير ليس رسومًا إضافية ولا تعرفة ثابتة لعملية التوليد المكتملة. |
تحجز Ailoot مبلغًا تقديريًا قبل الطلب. وبعد ظهور النتيجة، تُسوّي الرسوم النهائية بناءً على الاستخدام المقاس. وتستخدم تسوية البث سجل الاستخدام النهائي. كيفية عمل حجز المبلغ وتسوية الرسوم →
تفاصيل التعرفة المرجعية
لا تغيّر جداول التعرفة المرجعية على مستوى النموذج اختيار الطريقة أو عروض الأسعار أو الرسوم. وتستخدم الرسوم الفعلية تعرفات طريقة Ailoot المحددة.
مراجع أسعار إعدادات الفيديو
الأسعار حسب الإعدادات
طابق كل رسم مع الشروط المعروضة. طبّق تعرفة واحدة لكل مجموعة من الإعدادات البديلة.
| الإعدادات | شروط الفوترة | الرسوم |
|---|---|---|
| الإعداداتسعر الفيديو | شروط الفوترةالصوت: with_audio | الرسوم الإخراج · سعر الفيديو $0.8 لكل ثانية فيديو مرجع السعر المنشور للإعداد المعروض. تتبع الرسوم النهائية الإعداد الفعلي الذي تمت فوترته. |
| الإعداداتسعر الفيديو | شروط الفوترةالصوت: with_audio؛ الدقة: 4k | الرسوم الإخراج · سعر الفيديو $1.2 لكل ثانية فيديو مرجع السعر المنشور للإعداد المعروض. تتبع الرسوم النهائية الإعداد الفعلي الذي تمت فوترته. |
| الإعداداتسعر الفيديو | شروط الفوترةالصوت: without_audio | الرسوم الإخراج · سعر الفيديو $0.4 لكل ثانية فيديو مرجع السعر المنشور للإعداد المعروض. تتبع الرسوم النهائية الإعداد الفعلي الذي تمت فوترته. |
| الإعداداتسعر الفيديو | شروط الفوترةالصوت: without_audio؛ الدقة: 4k | الرسوم الإخراج · سعر الفيديو $0.8 لكل ثانية فيديو مرجع السعر المنشور للإعداد المعروض. تتبع الرسوم النهائية الإعداد الفعلي الذي تمت فوترته. |
أمثلة للطلبات
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", "prompt": "a calm greenhouse", "duration": 6, "resolution": "720p", "aspect_ratio": "16:9", "generate_audio": true}')
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
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 and response headers; do not resubmit an unknown creation.')
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}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
-H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
عمليات أخرى لقراءة المحتوى
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path('status.json').read_text())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
urls.append((str(i),u))
for label,path in urls:
u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')
target=Path('owned-'+label+'.bin')
subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS
الاحتفاظ بكل النتائج المكتملة
احفظ كل فيديو مكتمل أو ملف مُرجع؛ ونزّل كل أصل من URL الخاص به الذي تم إرجاعه فعليًا.
احتفظ بكل عنوان URL موقّع ومملوك لك في data[] المكتملة، وبالبيانات الوصفية الكاملة للحالة. احفظ كل مخرج، بما فيه صوته المولَّد. قد يوجد مسار صوتي 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 | الشرطتفشل قراءة متن الطلب الخام قبل تحليل ملف إعداد الفيديو | الخطوة التاليةاحتفظ بالاستجابة المُعادة وصحّح متن الطلب الذي تعذرت قراءته. |
الاستجابة422 · price_unavailable | الشرطيتعذر تحليل ملف إعداد الفيديو الدقيق، أو لا تتوفر بطاقة سعر دقيقة وجاهزة لملف الإعداد الكامل بعد تحليله | الخطوة التاليةاحتفظ بالاستجابة؛ واستخدم ملف الإعداد الدقيق المسموح به كاملاً وبطاقة سعره المنشورة. يُنفَّذ هذا الفرع قبل الإرسال إلى المزوّد. |
الاستجابة409 · video_not_ready | الشرطمحتوى النتيجة الأصلية غير متاح بعد | الخطوة التاليةاستعلم دورياً باستخدام المعرّف الأصلي المُعاد والتزم بـRetry-After. |
الاستجابةserver_error | الشرطتشير الاستجابة المُعادة إلى أن العملية أو النتيجة تتطلب التحقق | الخطوة التاليةاحتفظ بمعرّف العملية أو المهمة الأصلي المُعاد، وبترويسات الطلب وبالاستجابة؛ وواصل عمليات القراءة المدعومة لتلك العملية الأصلية. لا تُعِد إرسال طلب الإنشاء. |
الاستجابة503 · result_pending_check | الشرطGET للحالة أو المحتوى الأصليين: المهمة غير منشورة، والمهمة الأصلية ليست في حالة failed/cancelled/expired، والحالة المحلية unknown أو حالة المهمة الأصلية completed. | الخطوة التاليةاحتفظ بـid وoperation_id الأصليين (المعرّف العام نفسه للفيديو)، وبالاستجابة والترويسات؛ واقرأ الحالة أو المحتوى الأصليين فقط. لا ترسل طلب توليد جديداً مطلقاً. |
الأسماء البديلة
الأسماء البديلة للنموذج
Ailoot Ultra google/veo-3.1
الأسماء البديلة لمسارات الطرائق
/v1/videos/generations, /videos, /videos/generations
معرّفات النماذج ذات الصلة IDs
FAQ · Google: Veo 3.1
- ما المدخلات والنتائج المتاحة؟
POST /v1/videos·google/veo-3.1:text→video- ما الحقول التي يستخدمها الطلب؟
POST /v1/videos·google/veo-3.1:model,prompt,duration,resolution,aspect_ratio,generate_audio