Grok Imagine Video 1.5

ولّد مقاطع Grok Imagine Video 1.5 مدتها 6–15 ثانية مع صوت من موجّه أو صورة واحدة، بدقة 480p أو 720p، تُحتسب لكل ثانية وتُسلَّم عبر مهمة.

Grok Imagine Video 1.5 هو نموذج الفيديو من xAI. ينتج الطلب الواحد مقطعًا مدته 6–15 ثانية مع صوت من موجّه، أو من موجّه وصورة واحدة، بدقة 480p أو 720p وبنسبة ⁦16:9⁩ أو ⁦9:16⁩ أو ⁦1:1⁩. أرسل الطلب، واحتفظ بمعرّف المهمة المُعاد، واقرأ الفيديو المكتمل من المهمة. تُرسل الصور كروابط URL.

معرّفات النماذج

معرّف النموذج	المدخلات	الدقات	الطول
`grok-imagine-video-1-5`	نص، صورة واحدة	`480p`، `720p`	6–15 ثانية

راجع صفحة النموذج للاطلاع على الأسعار الحالية.

مثال سريع

curl https://api.seedrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-video-1-5",
    "prompt": "A red paper boat drifting on a calm pond at sunrise, soft mist, slow push-in, birdsong. No text, no logos.",
    "resolution": "480p",
    "duration": 8,
    "aspect_ratio": "16:9"
  }'

نقطة النهاية

POST https://api.seedrouter.ai/v1/videos/generations

الترويسة	القيمة
Authorization	`Bearer YOUR_API_KEY`
Content-Type	`application/json`

الاستجابة مهمة ({"id": "task_...", "status": "processing"}) لا الفيديو المكتمل. استعلم GET /v1/tasks/{task_id} للحصول على النتيجة. واحتفظ بمفاتيح API في شفرة تعمل على الخادم.

المعاملات

الحقل	النوع	القيمة الافتراضية	ملاحظات
`model`	string	مطلوب	`grok-imagine-video-1-5`
`prompt`	string	مطلوب	حتى 10,000 حرف. مطلوب مع الصورة أيضًا.
`image_urls`	قائمة روابط URL	لا يوجد	صورة واحدة كحد أقصى. معها يكون المقطع من صورة إلى فيديو؛ ومن دونها، من نص إلى فيديو.
`resolution`	enum	`480p`	`480p` أو `720p`.
`duration`	integer	`8`	6–15 ثانية.
`aspect_ratio`	enum	`16:9`	`16:9` أو `9:16` أو `1:1`. مع الصورة، يتبع المقطع شكل الصورة.
`audio`	boolean	`true`	يُقبل للتوافق. كل مقطع يأتي بالصوت: `false` لا ينتج مقطعًا صامتًا.
`fallback`	object	لا يوجد	`{"enabled": true}` أو `{"enabled": false}`. يُقبل للتوافق ويُتجاهل.

المخطط صارم: تُرفض الحقول غير المعروفة بدلًا من تجاهلها. وcallback_url غير متاح؛ استعلم عن المهمة بدلًا منه.

من صورة إلى فيديو

مرّر صورة واحدة في image_urls وصِف ما يحدث بعدها في prompt. يبدأ المقطع بالصورة ويحافظ على شكلها، لذا تعطي الصورة العمودية مقطعًا عموديًا مهما كانت قيمة aspect_ratio.

{
  "model": "grok-imagine-video-1-5",
  "prompt": "The subject slowly turns toward the camera, soft natural light, gentle breeze, quiet room tone.",
  "image_urls": ["https://example.com/start.png"],
  "resolution": "720p",
  "duration": 6
}

مدخلات الوسائط

الصورة رابط ⁦HTTP(S)⁩ عام. ولا تُقبل روابط data URI بصيغة base64: ارفع الملف إلى تخزينك الخاص ومرّر رابطه. استخدم صورة JPG أو PNG لا يتجاوز حجمها 10 MB.

عوامل التكلفة

راجع قسم أسعار النموذج للاطلاع على الأسعار الحالية. يُحتسب Grok Imagine Video 1.5 لكل ثانية من الفيديو، بسعر تحدّده الدقة:

cost = duration × rate per second for the resolution

يكلّف التحويل من نص إلى فيديو والتحويل من صورة إلى فيديو المبلغ نفسه. تُعرف المدة عند قبول الطلب، لذا فالمبلغ المحجوز هو المبلغ المحتسب. اطّلع على الرسوم النهائية في سجل استخدام حسابك. والمهام الفاشلة لا تُحتسب.

بنية المخرجات

يعيد الإرسال المهمة:

{"id": "task_...", "model": "grok-imagine-video-1-5", "status": "processing", "created_at": 1789689600}

جلب المهمة

GET https://api.seedrouter.ai/v1/tasks/{task_id}

استعلم كل 10–20 ثانية حتى تصبح status بقيمة completed أو failed. انتهاء مهلة الشبكة أثناء الاستعلام لا يعني فشل التوليد: احتفظ بمعرّف المهمة وتابع التحقق منها. ولا تنشئ مهمة أخرى للتحقق من التقدّم.

المهمة المكتملة

{
  "id": "task_...",
  "model": "grok-imagine-video-1-5",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689720,
  "output": {
    "video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4"
  }
}

في اختباراتنا، عادت مقاطع 720p مدتها 8 ثوانٍ بصيغة ⁦MP4 (H.264)⁩ مع مسار صوتي AAC بأبعاد ⁦1280 × 720⁩ لنسبة 16:9، و⁦720 × 1280⁩ لنسبة 9:16، و⁦720 × 720⁩ لنسبة 1:1، بعد 111–133 ثانية من الإرسال. وعادت مقاطع 480p خلال 45–84 ثانية.

الأخطاء

الطلبات المرفوضة قبل إنشاء المهمة تعيد خطأ HTTP مع كائن error ولا تُحتسب. أما المهمة التي تفشل بعد قبولها فتعيد HTTP 200 عند الاستعلام عنها، مع status: "failed" وكائن error.

راجع فهرس الأخطاء المشترك للاطلاع على الرموز وحالات HTTP وإرشادات إعادة المحاولة.

{
  "id": "task_...",
  "model": "grok-imagine-video-1-5",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "The request was rejected by the content policy. Please revise the prompt or input images."
  }
}

إذا انتهت مهلة الإرسال نفسه، فراجع مهامك قبل الإرسال مجددًا: فربما قُبل الطلب الأول.

نصائح

صِف الموضوع والمكان وحركة الكاميرا والإضاءة، واذكر الأصوات التي تريدها؛ فالصوت يُولَّد مع الصورة.
أعدّ مسودة بدقة 480p، ثم ولّد اللقطة النهائية بدقة 720p بالطلب نفسه.
للفيديو العمودي، أرسل aspect_ratio: "9:16" أو صورة عمودية.
أضف no text, no logos لإبعاد العلامات المختلقة.