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-video | Grok Video | نعم |
الخيارات
معلمات Grok Video
القيم المسموح بها في جميع الإصدارات؛ وقد يوفّر أحد الإصدارات عددًا أقل منها. تسرد الوثائق الخيارات لكل إصدار.
| الحقل | القيم |
|---|---|
| aspect_ratio | 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3 |
| resolution | 480p, 720p |
| duration | 1, 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
Kiwi API
فيديو للاستخدام اليومي دون أي إعداد
واجهة Lemon API
كل ميزات الفيديو بسعر أنسب
LTX Video API
فيديو سريع بأوزان مفتوحة للتجارب المتكررة
Magejutsu API
أعِد تمثيل أي فيديو مع الحفاظ على حركته
Melon API
أنمي متحرك، مع صوت اختياري
MiniMax-H3 API
فيديو مفتوح سريع بصوت ستيريو
الأسئلة الشائعة
الأسئلة الشائعة
كم تبلغ تكلفة Grok Video API؟
ما نقطة نهاية Grok Video API؟
ما نماذج Grok Video التي يمكنني استدعاؤها؟
هل يدعم Grok Video الصور المرجعية أو الشخصيات؟
هل يمكنني استخدام Grok Video من Claude أو ChatGPT؟
كم تُحفظ نتائج Grok Video؟
ابدأ البناء مع Mage
حساب واحد، ورصيد Gems واحد، وكل النماذج. ادفع فقط مقابل ما تنشئه.