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 اجرا میکند. هزینه یک درخواست با تنظیمات پیشفرض ۳۷۵ Gem (حدود ۰٫۳۷۵ دلار) است، بدون اشتراک. Grok Video کاراکترها و مرجعهای ذخیرهشده را با @handle در پرامپت میگیرد.
- ویدیوخروجی
- 1نسخه
- 375Gems برای هر کلیپ، پیشفرض
- $0.375حدود، به دلار
نگاه کلی
Grok Video API چه کاری انجام میدهد
مدل Grok Imagine از xAI برای ساخت ویدیو، از روی متن، حداکثر ۵ مرجع یا یک کلیپ کوتاه مبدأ. از ۱ تا ۱۵ ثانیه با کیفیت تا 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 میپذیرد
هرکدام را بهصورت URL با https، data URL یا آپلود تا 100 MB بفرستید.
| فیلد | نقش |
|---|---|
| image | تصویر مرجع. |
| additional_images | تصاویر مرجع اضافی. |
| video | ویدیوی مبدأ. |
قوانین
محدودیتهایی که Grok Video API اعمال میکند
- ویدیوی مبدأ باید حداکثر ۸٫۷ ثانیه باشد و نمیتوان آن را با تصاویر مرجع ترکیب کرد.
- حداکثر 5 تصویر مرجع که طول کلیپ را به 10 ثانیه محدود میکند.
مدلهای ویدیویی بیشتر
سایر APIهای ساخت ویدیو در Mage
Kiwi API
ویدیوی روزمره، بدون هیچ راهاندازی
Lemon API
همهی قابلیتهای ویدیو با قیمتی مناسبتر
LTX Video API
ویدیوی سریع با وزنهای باز برای آزمون و خطا
Melon API
انیمه در حرکت، با صدای اختیاری
MiniMax-H3 API
ویدیوی متنباز سریع با صدای استریو
Plum API
صدا برای هر کلیپ، تا 2K
سؤالات متداول
سؤالات متداول
هزینه Grok Video API چقدر است؟
اندپوینت Grok Video API چیست؟
کدام مدلهای Grok Video را میتوانم فراخوانی کنم؟
آیا Grok Video از تصویر مرجع یا کاراکتر پشتیبانی میکند؟
آیا میتوانم از Claude یا ChatGPT از Grok Video استفاده کنم؟
نتیجههای Grok Video تا چه مدت نگهداری میشوند؟
ساختن با Mage را شروع کن
یک حساب، یک موجودی Gems، همهٔ مدلها. فقط برای چیزی که تولید میکنی هزینه بپرداز.