How do I generate a video using grok-imagine-video API?

ترسل طلب POST مع النموذج 'grok-imagine-video' متضمناً مطالبة نصية ومصدر صورة/فيديو اختياري؛ يعيد مُعرّف مهمة، ثم قم بالاستعلام عن هذا المعرّف حتى تصبح حالة الفيديو 'done'.

What input formats does grok-imagine-video accept?

يقبل مطالبة باللغة الطبيعية وروابط صور اختيارية (أو صوراً بصيغة base64) بغرض التحريك؛ وللتحرير يتم تقديم رابط فيديو.

What are the maximum video duration and resolution options?

يدعم النموذج إنشاء فيديو لمدة تصل إلى 15 ثانية وبدقات تصل إلى 720p مع نسب أبعاد قابلة للتهيئة مثل 16:9 أو 1:1.

Can I animate a still image into a video with this model?

نعم، يمكنك تحويل صورة ثابتة إلى حركة استناداً إلى مطالبتك، وذلك باستخدام روابط الصور أو الصور المشفّرة ضمن الطلب.

Does grok-imagine-video support editing existing videos?

نعم — قدّم رابط الفيديو المصدر وتعليمات التحرير الخاصة بك؛ يحافظ الناتج على مدة الفيديو الأصلية ودقته.

How does moderation work in grok-imagine-video outputs?

تخضع الفيديوهات المولدة لمراجعة المحتوى؛ قد يتم تصفية المحتوى المعلّم أو حظره أثناء عملية التوليد.

Is the video generation asynchronous?

نعم، تُرجِع واجهة البرمجة مُعرّف طلب يمكنك الاستعلام عنه للتحقق من جاهزية الفيديو للتنزيل.

How should I handle expired video URLs?

يُفضَّل حفظ الفيديوهات المُنزَّلة بسرعة؛ قد تنتهي صلاحية الروابط المؤقتة وتصبح غير قابلة للوصول بعد التوليد.

واجهة برمجة تطبيقات Grok Imagine Video بأسعار معقولة | image-to-video

📘 المواصفات التقنية لـ Grok Imagine Video

المواصفة	التفاصيل
معرف النموذج	grok-imagine-video
المزود	xAI
النوع	ذكاء اصطناعي لتوليد الفيديو وتحريره
أنواع الإدخال	نص (مُحفِّز)؛ صورة أو فيديو اختياري. مطالبات نصية (لغة طبيعية)؛ إدخال صورة اختياري (صورة→فيديو)؛ video_url اختياري لتحرير المقاطع الموجودة. تختلف الحدود القصوى لمدة فيديو الإدخال للتحرير حسب المنفذ — المُبلّغ عنها ~8.7s لبعض مسارات التحرير.
أنواع الإخراج	فيديو .mp4 عبر عنوان URL مؤقت
نطاق المدة (توليد)	1–15 ثانية
الدقة	480p، 720p (قابلة للضبط)
نسب الأبعاد	1:1، 16:9، 9:16
دعم التحرير	نعم — يُحرك ويُعدِّل مقاطع حتى 8.7s
ضبط المحتوى	يشمل ضبط المحتوى
التسعير	محسوب بالثانية، يختلف حسب الدقة

🚀 ما هو Grok Imagine Video؟

Grok Imagine Video هو نموذج xAI المتقدم لتوليد وتحرير الفيديو والمكشوف عبر CometAPI. يتيح للمطورين توليد مقاطع فيديو قصيرة ومخصصة من مطالبات باللغة الطبيعية، مع إمكانية تحريك الصور الثابتة أو تحرير المقاطع القائمة. يدعم النموذج ضبط طول الإخراج، والدقة، ونسبة الأبعاد، مع ضبط محتوى مدمج لضمان الامتثال للسياسات.

🧠 الميزات الرئيسية (ما يميز Grok Imagine)

صوت مدمج + مزامنة حركة الشفاه: يُولّد صوتًا بيئيًا متزامنًا، وتأثيرات، وخطابًا/سردًا قصيرًا مع مزامنة تقريبية لحركة الشفاه.
صورة→فيديو / تحرير بالمطالبة: تحريك صورة ثابتة أو تحرير لقطات قائمة عبر مطالبات نصية (إزالة/استبدال عناصر، إعادة توقيت، إعادة أسلوب).
تكرار سريع وزمن استجابة منخفض: مُصمم لدورات تغذية راجعة سريعة مناسبة لسير عمل إبداعي ونماذج أولية للمنتجات.
واجهة إنتاجية: Imagine API تُوفّر نقاط نهاية برمجية للتوليد الدفعي، والاندماج ضمن مسارات التحرير، وضوابط مؤسسية.
عدّة “أوضاع” / أنماط: أوضاع مواجهة للمستخدم (أمثلة مُبلّغ عنها: Normal / Fun / Spicy أو إعدادات مشابهة) لتوجيه المخرجات نحو أسلوب أو درجة سماح معينة (ملاحظة: وضع “Spicy” تاريخيًا مكّن NSFW).

النموذج (الشركة)	أقصى دقة (عام)	أقصى طول مقطع (عام)	صوت مدمج؟	نقاط القوة	محاذير
Grok Imagine (xAI)	720p	6–15s	نعم	تكرار سريع، تكلفة/زمن استجابة مُناسبان، تحرير مُدمج، صوت مدمج	حد 720p؛ مخاوف ضبط المحتوى؛ تباين في الواقعية
Sora (OpenAI)	720p–1080p (يعتمد على الفئة)	قصير (6–15s)	نعم	واقعية بصرية عالية؛ تكامل قوي مع حزمة OpenAI	أعلى تكلفة؛ ضوابط/ضبط أكثر تقييدًا
Veo (Google DeepMind)	حتى 1080p+	قصير (يتغير)	نعم	فوتوريالية قوية، حركة مستقرة	تكلفة أعلى؛ تجريب علني أقل
Runway Gen-4.5	1080p+	قصير (يتغير)	نعم	اعتماد صناعي لسير العمل الإبداعي، جودة عالية	أعلى كلفة؛ تركيز على أدوات الإبداع
Vidu / Kling / Pika (متخصصون مختلفون)	حتى 1080p	قصير (يتغير)	متنوع	يقدم البعض ميزات متخصصة (Smart Cuts، ربط لقطات متعددة)	دعم صوتي متفاوت؛ نضج واجهات برمجة التطبيقات يختلف

⚠️ القيود

الحد الأقصى لطول الفيديو 15 ثانية.
التحرير يحافظ على طول فيديو الإدخال (≤ 8.7s).
عناوين URL المُولدة مؤقتة — يُرجى التحميل بسرعة.

كيفية الوصول إلى ودمج Grok Imagine Video

الخطوة 1: التسجيل للحصول على مفتاح API

سجّل الدخول إلى cometapi.com. إذا لم تكن مستخدمًا لدينا بعد، يرجى التسجيل أولًا. سجّل الدخول إلى وحدة تحكم CometAPI. احصل على مفتاح واجهة برمجة التطبيقات للوصول. انقر “Add Token” عند رمز API في المركز الشخصي، واحصل على مفتاح الرمز: sk-xxxxx ثم أرسله.

الخطوة 2: إرسال الطلبات إلى واجهة `Grok Imagine Video`

اختر نقطة النهاية “grok-imagine-video” لإرسال طلب واجهة البرمجة واضبط جسم الطلب. تُستمد طريقة وجسم الطلب من وثائق واجهاتنا على الموقع. يوفر موقعنا أيضًا اختبار Apifox لراحتك. استبدل <YOUR_API_KEY> بمفتاح CometAPI الفعلي من حسابك. أين تستدعيه: GROKتوليد الفيديو و تحرير الفيديو.

الخطوة 3: إرسال الطلبات إلى واجهة `Grok Imagine Video`

أدخل نصًا أو ارفع صورة (يمكنك اختياريًا تزويد صورة مصدر لتحريكها). تحلل واجهة Grok Imagine AI مدخلاتك وتُحضّر المحتوى لعنوان URL. يدعم كلٌّ من التحويل من نص إلى فيديو ومن صورة إلى فيديو.

يمكن تقديم صورة المصدر عبر:

عنوان URL عام يشير إلى صورة
معرّف URI لبيانات مُشفرة بـ base64 (مثل: data:image/jpeg;base64,<YOUR_BASE64_IMAGE>)

الخطوة 4: استرجاع النتائج والتحقق منها

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

التسعير لـ Grok Imagine Video

استكشف الأسعار التنافسية لـ Grok Imagine Video، المصمم ليناسب الميزانيات المختلفة واحتياجات الاستخدام المتنوعة. تضمن خططنا المرنة أن تدفع فقط مقابل ما تستخدمه، مما يجعل من السهل التوسع مع نمو متطلباتك. اكتشف كيف يمكن لـ Grok Imagine Video تحسين مشاريعك مع الحفاظ على التكاليف قابلة للإدارة.

Pricing Overview

Category	Item	Price
Input Pricing	Text	N/A (Free)
	Image	$0.0016
	Video per second	$0.008
Output Pricing	480p	$0.04
(Per second by resolution)	720p	$0.056

Note: When generating video via API, you are charged per second. You will also be charged when using video or images as input.

نموذج الكود وواجهة برمجة التطبيقات لـ Grok Imagine Video

احصل على أكواد نماذجية شاملة وموارد API لـ Grok Imagine Video لتبسيط عملية التكامل الخاصة بك. توفر وثائقنا التفصيلية إرشادات خطوة بخطوة، مما يساعدك على الاستفادة من الإمكانات الكاملة لـ Grok Imagine Video في مشاريعك.

Python
JavaScript
Curl

import os
import time
import requests

# Get your CometAPI key from https://api.cometapi.com/console/token, and paste it here
COMETAPI_KEY = os.environ.get("COMETAPI_KEY") or "<YOUR_COMETAPI_KEY>"
BASE_URL = "https://api.cometapi.com/grok/v1"

headers = {
    "Authorization": f"Bearer {COMETAPI_KEY}",
    "Content-Type": "application/json",
}

# ============================================================
# Step 1: Create Video Generation Task
# ============================================================
print("Step 1: Creating video generation task...")

create_payload = {
    "model": "grok-imagine-video",
    "prompt": "A glowing crystal-powered rocket launching from the red dunes of Mars, ancient alien ruins lighting up in the background as it soars into a sky full of unfamiliar constellations",
    "duration": 10,
    "aspect_ratio": "16:9",
    "resolution": "720p",
}

create_response = requests.post(
    f"{BASE_URL}/videos/generations", headers=headers, json=create_payload
)

create_result = create_response.json()
print(f"Create response: {create_result}")

# Extract task ID from the response
task_id = create_result.get("request_id") or create_result.get("id")
if not task_id:
    print("Error: Failed to get task ID from response")
    exit(1)

print(f"Task ID: {task_id}")

# ============================================================
# Step 2: Poll for Task Status
# ============================================================
print("
Step 2: Polling task status...")

while True:
    query_response = requests.get(
        f"{BASE_URL}/videos/{task_id}", headers=headers
    )
    query_result = query_response.json()

    data = query_result.get("data", {})
    status = data.get("status", "unknown")
    progress = data.get("progress", "0%")
    print(f"Status: {status}, Progress: {progress}")

    if status in ["FAILURE", "failed"]:
        print("Video generation failed!")
        print(f"Reason: {data.get('fail_reason')}")
        exit(1)

    if status == "SUCCESS":
        video_url = data.get("data", {}).get("video", {}).get("url")
        print(f"Video generation completed!")
        print(f"Video URL: {video_url}")
        break

    time.sleep(10)

Python Code Example

import os
import time
import requests

# Get your CometAPI key from https://api.cometapi.com/console/token, and paste it here
COMETAPI_KEY = os.environ.get("COMETAPI_KEY") or "<YOUR_COMETAPI_KEY>"
BASE_URL = "https://api.cometapi.com/grok/v1"

headers = {
    "Authorization": f"Bearer {COMETAPI_KEY}",
    "Content-Type": "application/json",
}

# ============================================================
# Step 1: Create Video Generation Task
# ============================================================
print("Step 1: Creating video generation task...")

create_payload = {
    "model": "grok-imagine-video",
    "prompt": "A glowing crystal-powered rocket launching from the red dunes of Mars, ancient alien ruins lighting up in the background as it soars into a sky full of unfamiliar constellations",
    "duration": 10,
    "aspect_ratio": "16:9",
    "resolution": "720p",
}

create_response = requests.post(
    f"{BASE_URL}/videos/generations", headers=headers, json=create_payload
)

create_result = create_response.json()
print(f"Create response: {create_result}")

# Extract task ID from the response
task_id = create_result.get("request_id") or create_result.get("id")
if not task_id:
    print("Error: Failed to get task ID from response")
    exit(1)

print(f"Task ID: {task_id}")

# ============================================================
# Step 2: Poll for Task Status
# ============================================================
print("\nStep 2: Polling task status...")

while True:
    query_response = requests.get(
        f"{BASE_URL}/videos/{task_id}", headers=headers
    )
    query_result = query_response.json()

    data = query_result.get("data", {})
    status = data.get("status", "unknown")
    progress = data.get("progress", "0%")
    print(f"Status: {status}, Progress: {progress}")

    if status in ["FAILURE", "failed"]:
        print("Video generation failed!")
        print(f"Reason: {data.get('fail_reason')}")
        exit(1)

    if status == "SUCCESS":
        video_url = data.get("data", {}).get("video", {}).get("url")
        print(f"Video generation completed!")
        print(f"Video URL: {video_url}")
        break

    time.sleep(10)

JavaScript Code Example

// Get your CometAPI key from https://api.cometapi.com/console/token, and paste it here
const api_key = process.env.COMETAPI_KEY || "<YOUR_COMETAPI_KEY>";
const base_url = "https://api.cometapi.com/grok/v1";

const headers = {
  "Authorization": `Bearer ${api_key}`,
  "Content-Type": "application/json",
};

// ============================================================
// Step 1: Create Video Generation Task
// ============================================================
console.log("Step 1: Creating video generation task...");

const createPayload = {
  model: "grok-imagine-video",
  prompt: "A glowing crystal-powered rocket launching from the red dunes of Mars, ancient alien ruins lighting up in the background as it soars into a sky full of unfamiliar constellations",
  duration: 10,
  aspect_ratio: "16:9",
  resolution: "720p",
};

const createResponse = await fetch(`${base_url}/videos/generations`, {
  method: "POST",
  headers: headers,
  body: JSON.stringify(createPayload),
});

const createResult = await createResponse.json();
console.log("Create response:", JSON.stringify(createResult, null, 2));

const taskId = createResult?.request_id || createResult?.id;
if (!taskId) {
  console.log("Error: Failed to get task ID from response");
  process.exit(1);
}

console.log(`Task ID: ${taskId}`);

// ============================================================
// Step 2: Poll for Task Status
// ============================================================
console.log("\nStep 2: Polling task status...");

const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));

while (true) {
  const queryResponse = await fetch(`${base_url}/videos/${taskId}`, {
    method: "GET",
    headers: headers,
  });

  const queryResult = await queryResponse.json();
  const data = queryResult?.data || {};
  const status = data?.status || "unknown";
  const progress = data?.progress || "0%";
  console.log(`Status: ${status}, Progress: ${progress}`);

  if (["FAILURE", "failed"].includes(status)) {
    console.log("Video generation failed!");
    console.log(`Reason: ${data?.fail_reason}`);
    process.exit(1);
  }

  if (status === "SUCCESS") {
    const videoUrl = data?.data?.video?.url;
    console.log("Video generation completed!");
    console.log(`Video URL: ${videoUrl}`);
    break;
  }

  await sleep(10000);
}

Curl Code Example

#!/bin/bash

# Get your CometAPI key from https://api.cometapi.com/console/token
# Export it as: export COMETAPI_KEY="your-key-here"

BASE_URL="https://api.cometapi.com/grok/v1"

# ============================================================
# Step 1: Create Video Generation Task
# ============================================================
echo "Step 1: Creating video generation task..."

CREATE_RESPONSE=$(curl -s --location --request POST "${BASE_URL}/videos/generations" \
  --header "Authorization: Bearer $COMETAPI_KEY" \
  --header "Content-Type: application/json" \
  --data-raw '{
    "model": "grok-imagine-video",
    "prompt": "A glowing crystal-powered rocket launching from the red dunes of Mars, ancient alien ruins lighting up in the background as it soars into a sky full of unfamiliar constellations",
    "duration": 10,
    "aspect_ratio": "16:9",
    "resolution": "720p"
  }')

echo "Create response: $CREATE_RESPONSE"

# Extract task ID using jq (install with: brew install jq)
TASK_ID=$(echo "$CREATE_RESPONSE" | jq -r '.request_id // .id')

if [ "$TASK_ID" == "null" ] || [ -z "$TASK_ID" ]; then
  echo "Error: Failed to get task ID from response"
  exit 1
fi

echo "Task ID: $TASK_ID"

# ============================================================
# Step 2: Poll for Task Status
# ============================================================
echo ""
echo "Step 2: Polling task status..."

while true; do
  QUERY_RESPONSE=$(curl -s --location --request GET "${BASE_URL}/videos/${TASK_ID}" \
    --header "Authorization: Bearer $COMETAPI_KEY")

  STATUS=$(echo "$QUERY_RESPONSE" | jq -r '.data.status')
  PROGRESS=$(echo "$QUERY_RESPONSE" | jq -r '.data.progress')
  echo "Status: $STATUS, Progress: $PROGRESS"

  if [ "$STATUS" == "FAILURE" ] || [ "$STATUS" == "failed" ]; then
    echo "Video generation failed!"
    echo "$QUERY_RESPONSE" | jq -r '.data.fail_reason'
    exit 1
  fi

  if [ "$STATUS" == "SUCCESS" ]; then
    VIDEO_URL=$(echo "$QUERY_RESPONSE" | jq -r '.data.data.video.url')
    echo "Video generation completed!"
    echo "Video URL: $VIDEO_URL"
    break
  fi

  sleep 10
done