Grok Video API

لمحة سريعة

تشغّل Grok Video API النموذج Grok Video عبر Mage على POST https://api.mage.space/v1/grok_video/generate. يكلّف الطلب بالإعدادات الافتراضية 375 Gems (حوالي 0.375$) بدون أي اشتراك. يقبل Grok Video الشخصيات والمراجع المحفوظة عبر @handle في الوصف.

• فيديو

  المخرجات

• 1

  النسخة

• 375

  Gems لكل مقطع، افتراضيًا

• $0.375

  التكلفة التقريبية بالدولار

نظرة عامة

ماذا تقدّم Grok Video API

نموذج Grok Imagine من xAI للفيديو، انطلاقًا من نص أو حتى 5 مراجع أو مقطع مصدر قصير. من ثانية واحدة إلى 15 ثانية بدقة تصل إلى 720p. ويُطبَّق مرشح الأمان من xAI.

نموذج Grok Imagine من xAI للفيديو، انطلاقًا من نص أو صور مرجعية أو فيديو مصدر لتعديله. ويُطبَّق مرشح الأمان من xAI.

تقبل المدخلات image وadditional_images وvideo.

بداية سريعة

استدعاء Grok Video API

عيّن MAGE_API_KEY، وأرسل الطلب إلى /grok_video/generate، ثم استعلم عن status_url إلى أن يكتمل الطلب.

STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/grok_video/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
  "aspect_ratio": "16:9",
  "duration": "5",
  "model_id": "grok-imagine-video"
}' | jq -r '.status_url')

# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"

// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';

const mage = new Mage(); // reads MAGE_API_KEY

const request = await mage.run('grok_video', {
  prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
  aspect_ratio: '16:9',
  duration: '5',
  model_id: 'grok-imagine-video',
});

console.log(request.result.url);

# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("grok_video", {
    "prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
    "aspect_ratio": "16:9",
    "duration": "5",
    "model_id": "grok-imagine-video",
})

print(request["result"]["url"])

النماذج

قيم model_id في Grok Video

أرسل model_id لاختيار إصدار. الطلب الذي لا يتضمنه يستخدم الإصدار الافتراضي.

الخيارات

معلمات Grok Video

القيم المسموح بها في جميع الإصدارات؛ وقد يوفّر أحد الإصدارات عددًا أقل منها. تسرد الوثائق الخيارات لكل إصدار.

المدخلات

مدخلات الوسائط التي يقبلها Grok Video

أرسل كل مدخل كرابط https أو رابط بيانات (data URL) أو ملف مرفوع بحجم يصل إلى 100 MB.

القواعد

القيود التي تفرضها Grok Video API

• يجب ألا تزيد مدة الفيديو المصدر على 8.7 ثانية، ولا يمكن دمجه مع الصور المرجعية.
• حتى 5 صور مرجعية، وهذا يحدّ مدة المقطع بـ 10 ثوانٍ.

المزيد من نماذج الفيديو

واجهات برمجة أخرى لتوليد الفيديو على Mage

الأسئلة الشائعة

الأسئلة الشائعة

ابدأ البناء مع Mage

حساب واحد، ورصيد Gems واحد، وكل النماذج. ادفع فقط مقابل ما تنشئه.

ذات صلة

• واجهة API لتوليد الفيديو بالذكاء الاصطناعي
• مرجع Grok Video API
• ساحة تجربة Grok Video
• جميع نماذج API
• خادم Mage MCP