رفتن به محتوا

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-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 می‌پذیرد

هرکدام را به‌صورت URL با https، data URL یا آپلود تا 100 MB بفرستید.

فیلدنقش
imageتصویر مرجع.
additional_imagesتصاویر مرجع اضافی.
videoویدیوی مبدأ.

قوانین

محدودیت‌هایی که Grok Video API اعمال می‌کند

  • ویدیوی مبدأ باید حداکثر ۸٫۷ ثانیه باشد و نمی‌توان آن را با تصاویر مرجع ترکیب کرد.
  • حداکثر 5 تصویر مرجع که طول کلیپ را به 10 ثانیه محدود می‌کند.

مدل‌های ویدیویی بیشتر

سایر APIهای ساخت ویدیو در Mage

  • ویدیو · از 270 Gems

    Kiwi API

    ویدیوی روزمره، بدون هیچ راه‌اندازی

  • ویدیو · از ۲۴۵ Gem

    Lemon API

    همه‌ی قابلیت‌های ویدیو با قیمتی مناسب‌تر

  • ویدیو · از 20 Gems

    LTX Video API

    ویدیوی سریع با وزن‌های باز برای آزمون و خطا

  • ویدیو · از 147 Gems

    Melon API

    انیمه در حرکت، با صدای اختیاری

  • ویدیو · از ۳۰ Gem

    MiniMax-H3 API

    ویدیوی متن‌باز سریع با صدای استریو

  • ویدیو · از ۳۳۸ Gem

    Plum API

    صدا برای هر کلیپ، تا 2K

سؤالات متداول

سؤالات متداول

هزینه Grok Video API چقدر است؟
یک درخواست Grok Video با تنظیمات پیش‌فرض (Grok Video) 375 Gems هزینه دارد، حدود $0.375. رزولوشن، مدت و نسخه‌های دیگر قیمت را تغییر می‌دهند و مبلغ دقیق در پاسخ اعلام می‌شود. اگر تولید ناموفق باشد هزینه برگردانده می‌شود، اما اگر سیاست محتوایی Mage جلوی آن را بگیرد برگردانده نمی‌شود.
اندپوینت Grok Video API چیست؟
درخواست POST به https://api.mage.space/v1/grok_video/generate بفرستید و کلید API مایج خود را در هدر Authorization: Bearer قرار دهید. پاسخ شامل یک status_url است که برای گرفتن نتیجه باید آن را مرتب بررسی کنید.
کدام مدل‌های Grok Video را می‌توانم فراخوانی کنم؟
grok-imagine-video (Grok Video). مدل پیش‌فرض Grok Video است.
آیا Grok Video از تصویر مرجع یا کاراکتر پشتیبانی می‌کند؟
Grok Video این ورودی‌ها را می‌پذیرد: image، additional_images، video. کاراکترها و مرجع‌های ذخیره‌شده را هم می‌توانید با @handle در پرامپت بیاورید.
آیا می‌توانم از Claude یا ChatGPT از Grok Video استفاده کنم؟
بله. سرور MCP مایج را به Claude، ChatGPT، Claude Code، Grok یا Cursor وصل کنید و Grok Video را با نام بخواهید. دستیار شما گزینه‌های آن را با get_model می‌خواند و پیش از تولید، قیمت را اعلام می‌کند.
نتیجه‌های Grok Video تا چه مدت نگهداری می‌شوند؟
نتایج و ورودی‌ها 30 روز نگهداری می‌شوند. هر چیزی را که می‌خواهید نگه دارید، در فضای ذخیره‌سازی خودتان دانلود کنید.

ساختن با Mage را شروع کن

یک حساب، یک موجودی Gems، همهٔ مدل‌ها. فقط برای چیزی که تولید می‌کنی هزینه بپرداز.