grok-imagine-video
ينشئ Grok Imagine Video مقاطع قصيرة من وصف نصي مع اختيار المدة وشكل الإطار. ويدعم نموذج xAI نفسه أيضًا تحريك الصور والتحرير الموجّه للفيديو.
عن النموذج
يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة.
من الوصف إلى المقطع
ينشئ Grok Imagine Video فيديو من النص. ولدى نموذج xAI نفسه أيضًا أنماط تعمل بصورة وفيديو أصليين. وفي طريقة التوليد المنشورة في Ailoot تكون المدخلات وصفًا نصيًا، والنتيجة مقطع فيديو.
يُنفذ التوليد بصورة غير متزامنة: تُنشأ المهمة أولًا، ثم تُسترجع حالتها والنتيجة الجاهزة بمعرّفها. ووفقًا لـxAI، قد يستغرق إنشاء المقطع عدة دقائق؛ ويعتمد الوقت على تعقيد المشهد والمدة والدقة والنمط المختار.
المدة والإطار
تتوفر مدة من 1 إلى 15 ثانية لإنشاء المقطع. وتشمل أشكال الإطار 1:1 و16:9 و9:16 و4:3 و3:4 و3:2 و2:3؛ والشكل القياسي هو 16:9. ويوفر هذا الإصدار 480p و720p، بينما تخص 1080p الإصدار 1.5.
تحريك الصورة الأصلية
في نمط xAI الذي يستخدم صورة، تصبح الصورة الإطار الأول وتحدد التعليمات النصية الحركة. ويطابق شكل المقطع افتراضيًا نسب الصورة الأصلية. ويغير تحديد نسبة أبعاد صراحةً هذا الشكل وقد يمدد الصورة.
التحرير الموجّه
عند العمل بفيديو جاهز، يطبق النموذج التعديلات الموصوفة مع الحفاظ على بقية محتوى المشهد. ويساعد هذا النمط على تغيير العنصر المطلوب مع الحفاظ على تكوين المقطع الأصلي. وتُورث المدة والنسب من الأصل؛ ولا تُحدد مدة أو هيئة إطار جديدة.
تُحد مدة المقطع الأصلي للتحرير بـ8,7 ثانية، وتُحد النتيجة بدقة لا تتجاوز 720p. وتُخفض المواد بدقة 1080p إلى 720p. ولا تنطبق إعدادات التوليد من النص على التحرير تلقائيًا.
تمديد المقطع الجاهز
في نمط مستقل لدى xAI، يمدد هذا الإصدار المقطع الأصلي من إطاره الأخير. ويجب أن تكون مدة MP4 الأصلي من 2 إلى 15 ثانية؛ والجزء المضاف من 2 إلى 10 ثوانٍ، وافتراضيًا 6. وتجمع النتيجة الفيديو الأصلي والامتداد. وتُورث النسب والدقة من الأصل، بحد 720p؛ ولا يمكن تغييرهما بصورة مستقلة في هذا النمط. وتختلف هذه الإمكانية لدى المصنّع عن توليد Ailoot المنشور من النص.
الصور المرجعية وحدود الإصدار
توفر xAI استخدام مراجع بصرية لتوجيه مظهر الأشخاص والملابس والأشياء في المشهد. ويحدد المرجع السمات المرئية، لا صورة الإطار الأول الدقيقة. ولا يمكن في Grok Imagine Video التقليدي الجمع بين الإطار الأول والمراجع.
لا يقبل هذا الإصدار تثبيتًا دقيقًا للإطار الأخير أو الإطارات الرئيسية الوسيطة. وتخص هذه الإمكانات Grok Imagine Video 1.5. والتوليد وتحريك الصورة الأصلية وتعديل المقطع الجاهز أنماط مختلفة؛ وتصف طريقة Ailoot المنشورة هنا التوليد من النص.
Ailoot · فيديو POST /v1/videos/generations grok-imagine-video
grok-imagine-videoالبداية
ينشئ Grok Imagine Video مقاطع قصيرة من وصف نصي مع اختيار المدة وشكل الإطار. ويدعم نموذج xAI نفسه أيضًا تحريك الصور والتحرير الموجّه للفيديو.
- المدخلات المقبولة
- النص
- النتائج
- فيديو
متاح في Ailoot · المدخلات والطرائق
Ailoot · فيديو POST /v1/videos/generations
- الإدخال
text- الإخراج
video- صيغة الإخراج
- mp4
| الحقل | النوع | المتطلب | القيم والحدود | القيمة الافتراضية |
|---|---|---|---|---|
الحقلmodel | النوعstring | المتطلبمطلوب | القيم والحدود grok-imagine-video | القيمة الافتراضية— |
الحقلprompt | النوعstring | المتطلباختياري | القيم والحدود الحد الأدنى للطول: 1 | القيمة الافتراضية— |
الحقلduration | النوعinteger | المتطلباختياري | القيم والحدود الحد الأدنى: 1 الحد الأقصى: 15 الشروط: لا تقدّم duration وseconds معاً الوحدة: ثوانٍ | القيمة الافتراضية1 |
الحقلseconds | النوعinteger|integer_string | المتطلباختياري | القيم والحدود الحد الأدنى: 1 الحد الأقصى: 15 بديل: duration | القيمة الافتراضية— |
الحقلresolution | النوعstring | المتطلباختياري | القيم والحدود 480p, 720p | القيمة الافتراضية480p |
الحقلaspect_ratio | النوعstring | المتطلباختياري | القيم والحدود 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3 الشروط: عند تقديم صورة إدخال وحذف نسبة الأبعاد، يرث المزوّد نسبة أبعاد الصورة | القيمة الافتراضية16:9 |
الحقلsize | النوعstring | المتطلباختياري | القيم والحدود 1280x720, 720x1280, 1920x1080, 1080x1920 الشروط: يجب أن يطابق resolution/aspect_ratio عند تحديد كليهما | القيمة الافتراضية— |
الحقلimage | النوعobject | المتطلباختياري | القيم والحدود الشروط: صورة إدخال فعلية مدعومة؛ تسمح بحذف الموجّه النصي | القيمة الافتراضية— |
تركيبات مواد الإدخال
تحويل النص إلى فيديو · مطلوب: prompt
تحويل الصورة إلى فيديو · مطلوب: image
معلمات الطريقة ودورة حياتها
| المعلمة | المواصفات |
|---|---|
المعلمةmaterial_types | المواصفاتtext |
المعلمةrequired | المواصفاتnull |
المعلمةoptional_controls | المواصفاتnull |
دورة الحياة: 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
بُنى الطرق ومعرّفاتها دقيقة؛ قدرة المورد منفصلة عن السماح بالطلب.
الباقات
تعرفات طرائق Ailoot
POST /v1/videos/generations- الإدخال
- 0.002 US$ لكل صورة مُدخلة
- الإدخال
- 0.01 US$ لكل ثانية من فيديو الإدخال
- الإخراج
- 0.05 US$ لكل ثانية بدقة 480p
- الإخراج
- 0.07 US$ لكل ثانية بدقة 720p
تحجز Ailoot مبلغًا تقديريًا قبل الطلب. وبعد ظهور النتيجة، تُسوّي الرسوم النهائية بناءً على الاستخدام المقاس. وتستخدم تسوية البث سجل الاستخدام النهائي. كيفية عمل حجز المبلغ وتسوية الرسوم →
أمثلة للطلبات
Ailoot · فيديو
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl https://api.ailoot.ai/v1/videos/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "grok-imagine-video", "prompt": "A person walks slowly through a quiet garden as the camera tracks from the side."}'استلام النتائج وحفظها
Ailoot · فيديو
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_VIDEO_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_VIDEO_ID
video_id=$(python3 -c 'import os, urllib.parse; print(urllib.parse.quote(os.environ["AILOOT_VIDEO_ID"], safe=""))') || exit 1
curl "https://api.ailoot.ai/v1/videos/generations/$video_id" \
-H "Authorization: Bearer $AILOOT_API_KEY"عمليات أخرى لقراءة المحتوى
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_VIDEO_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_VIDEO_ID
video_id=$(python3 -c 'import os, urllib.parse; print(urllib.parse.quote(os.environ["AILOOT_VIDEO_ID"], safe=""))') || exit 1
curl "https://api.ailoot.ai/v1/videos/generations/$video_id/content" \
-H "Authorization: Bearer $AILOOT_API_KEY" \
--output video.mp4الاحتفاظ بكل النتائج المكتملة
احفظ كل فيديو مكتمل أو ملف مُرجع؛ ونزّل كل أصل من URL الخاص به الذي تم إرجاعه فعليًا.
احتفظ بـJSON الحالة كاملاً وبقيمة request_id الفعلية. تحتوي الاستجابة المكتملة ذات status=done على video.url بعنوان URL لمحتوى مملوك لك. حافظ على المدة المذكورة وكل حقل نتيجة مُعاد.
عند الحاجة إلى التحقق من الاستجابة الأصلية
اقرأ المهمة الأصلية الموجودة؛ ولا تعِد إرسال طلب مجهول النتيجة مطلقاً.
حقول الاستجابة
| الحقل | النوع |
|---|---|
الحقلrequest_id | النوعstring |
الحقلid | النوعstring |
الحقلstatus | النوعstring |
الحقلvideo.url | النوعowned signed content URL |
الحقلvideo.duration | النوعnumber |
الحقلvideo.respect_moderation | النوعboolean |
الأخطاء والخطوات التالية
| الاستجابة | الشرط | الخطوة التالية |
|---|---|---|
الاستجابة400 · invalid_request_error | الشرطحقول مطلوبة أو تمثيل مادة أو قيمة معلمة غير صحيحة | الخطوة التاليةصحّح الحقول المحددة قبل طلب إنشاء جديد. |
الاستجابة409 · video_not_ready | الشرطمحتوى النتيجة الأصلية غير متاح بعد | الخطوة التاليةاستعلم دورياً باستخدام المعرّف الأصلي المُعاد والتزم بـRetry-After. |
الاستجابةserver_error | الشرطتشير الاستجابة المُعادة إلى أن العملية أو النتيجة تتطلب التحقق | الخطوة التاليةاحتفظ بمعرّف العملية أو المهمة الأصلي المُعاد، وبترويسات الطلب وبالاستجابة؛ وواصل عمليات القراءة المدعومة لتلك العملية الأصلية. لا تُعِد إرسال طلب الإنشاء. |
الأسماء البديلة
الأسماء البديلة للنموذج
Ailoot grok-imagine-video
الأسماء البديلة لمسارات الطرائق
استخدم مسارات الطرائق المعروضة أعلاه.
معرّفات النماذج ذات الصلة IDs
FAQ · grok-imagine-video
- ما المدخلات والنتائج المتاحة؟
POST /v1/videos/generations·grok-imagine-video:text→video- ما الحقول التي يستخدمها الطلب؟
POST /v1/videos/generations·grok-imagine-video:model,prompt,duration,seconds,resolution,aspect_ratio,size,image- ما الحدود المطبقة؟
POST /v1/videos/generations·grok-imagine-video:duration.minimum:1;duration.maximum:15;seconds.minimum:1;seconds.maximum:15