انتقل إلى المحتوى

Mage API · نموذج فيديو

Grok Video API

Grok Imagine في حالة حركة

POST https://api.mage.space/v1/grok_video/generate

لمحة سريعة

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

  • فيديوالمخرجات
  • 1النسخة
  • 375Gems لكل مقطع، افتراضيًا
  • $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 إلى أن يكتمل الطلب.

cURL
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"
TypeScript
// 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);
Python
# 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 لاختيار إصدار. الطلب الذي لا يتضمنه يستخدم الإصدار الافتراضي.

model_idالاسمافتراضي
grok-imagine-videoGrok Videoنعم

الخيارات

معلمات Grok Video

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

الحقلالقيم
aspect_ratio1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3
resolution480p, 720p
duration1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15

المدخلات

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

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

الحقلالدور
imageالصورة المرجعية.
additional_imagesصور مرجعية إضافية.
videoالفيديو المصدر.

القواعد

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

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

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

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

  • فيديو · من 270 Gems

    Kiwi API

    فيديو للاستخدام اليومي دون أي إعداد

  • فيديو · من 245 Gems

    واجهة Lemon API

    كل ميزات الفيديو بسعر أنسب

  • فيديو · من 20 Gems

    LTX Video API

    فيديو سريع بأوزان مفتوحة للتجارب المتكررة

  • فيديو · من 1,856 Gem

    Magejutsu API

    أعِد تمثيل أي فيديو مع الحفاظ على حركته

  • فيديو · من 147 Gems

    Melon API

    أنمي متحرك، مع صوت اختياري

  • فيديو · من 45 Gems

    MiniMax-H3 API

    فيديو مفتوح سريع بصوت ستيريو

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

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

كم تبلغ تكلفة Grok Video API؟
يكلّف طلب Grok Video بالإعدادات الافتراضية (Grok Video) ‏375 Gem، أي نحو 0.375 دولار. تؤثر الدقة والمدة والإصدارات الأخرى في السعر، وتوضّح الاستجابة المبلغ الدقيق. يُعاد المبلغ عند فشل التوليد، أما التوليد الذي تحظره سياسة المحتوى في Mage فلا يُعاد مبلغه.
ما نقطة نهاية Grok Video API؟
أرسل طلب POST إلى https://api.mage.space/v1/grok_video/generate مع ترويسة Authorization: Bearer تحمل مفتاح Mage API الخاص بك. تتضمن الاستجابة status_url للاستعلام عنه بشكل متكرر إلى أن تصل النتيجة.
ما نماذج Grok Video التي يمكنني استدعاؤها؟
grok-imagine-video (Grok Video). النموذج الافتراضي هو Grok Video.
هل يدعم Grok Video الصور المرجعية أو الشخصيات؟
يقبل Grok Video المدخلات image وadditional_images وvideo. ويقبل الشخصيات والمراجع المحفوظة عبر @handle في الوصف.
هل يمكنني استخدام Grok Video من Claude أو ChatGPT؟
نعم. اربط خادم Mage MCP بـ Claude أو ChatGPT أو Claude Code أو Grok أو Cursor واطلب Grok Video بالاسم. يقرأ مساعدك خياراته عبر get_model ويذكر السعر قبل التوليد.
كم تُحفظ نتائج Grok Video؟
يُحتفظ بالنتائج والمدخلات لمدة 30 يومًا. نزّل كل ما تريد الاحتفاظ به إلى مساحة التخزين الخاصة بك.

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

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

Charactersالمجتمع