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

Сіз мәтіндік промптты және қосымша кескін/видео көзін қоса отырып, 'grok-imagine-video' моделіне POST сұрауын жібересіз; ол тапсырма идентификаторын қайтарады, содан кейін видео күйі 'done' болғанша осы идентификаторды тексеріп отырасыз.

What input formats does grok-imagine-video accept?

Ол табиғи тілдегі промптты және анимация үшін қосымша кескін URL мекенжайларын (немесе base64 кескіндерін) қабылдайды; өңдеу үшін видео URL мекенжайы беріледі.

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?

Иә, сұрауыңызға негізделе отырып, сұрауда кескін URL мекенжайларын немесе кодталған кескіндерді пайдаланып, қозғалмайтын кескінді қозғалыстағы видеоға айналдыра аласыз.

Does grok-imagine-video support editing existing videos?

Иә — бастапқы видеоның URL мекенжайын және өңдеу нұсқауларыңызды беріңіз; шығыс нәтиже бастапқы видеоның ұзақтығы мен ажыратымдылығын сақтайды.

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

Жасалған видеолар мазмұнды модерациялауға жатады; белгіленген мазмұн генерация кезінде сүзгіден өткізілуі немесе бұғатталуы мүмкін.

Is the video generation asynchronous?

Иә, API сұрау идентификаторын қайтарады, оны видео жүктеп алуға дайын болғанын тексеру үшін сұратып отырасыз.

How should I handle expired video URLs?

Жүктеп алынған видеоларды тез сақтап қою керек; уақытша URL мекенжайларының мерзімі өтіп, генерациядан кейін қолжетімсіз болып қалуы мүмкін.

Қолжетімді Grok Imagine Video API | image-to-video

📘 Grok Imagine Video техникалық сипаттамалары

Specification	Details
Model ID	grok-imagine-video
Provider	xAI
Type	Бейне генерациялау және өңдеу AI
Input Types	Мәтін (prompt); қосымша сурет немесе бейне Мәтіндік prompt-тар (табиғи тіл); қосымша сурет кірісі (image→video); бар клиптерді өңдеу үшін қосымша video_url. Өңдеуге арналған кіріс бейненің ең көп ұзақтығы endpoint-ке қарай өзгереді — кейбір өңдеу ағындары үшін ~8.7s деп хабарланған.
Output Types	Уақытша URL арқылы .mp4 бейне
Duration Range (generate)	1–15 секунд
Resolution	480p, 720p (бапталатын)
Aspect Ratios	1:1, 16:9, 9:16
Edit Support	Иә — 8.7s дейінгі бейнелерді жандандырады және өзгертеді
Moderation	Контент модерациясы қамтылған
Pricing	Секунд бойынша алынады, ажыратымдылыққа қарай өзгереді

🚀 Grok Imagine Video дегеніміз не?

Grok Imagine Video — бұл CometAPI арқылы қолжетімді xAI-дың жетілдірілген бейне генерациялау және өңдеу AI моделі. Ол әзірлеушілерге табиғи тілдегі prompt-тардан қысқа, теңшелетін бейнелерді жасауға және қажет болса, статикалық суреттерді жандандыруға немесе бар клиптерді өңдеуге мүмкіндік береді. Модельде шығыс ұзындығын, ажыратымдылықты және кадр қатынасын баптау қолдауы бар, сондай-ақ саясат талаптарына сәйкестікті қамтамасыз ету үшін кірістірілген контент модерациясы қолданылады.

🧠Негізгі мүмкіндіктері (Grok Imagine-ді ерекшелендіретін тұстар)

Түпнұсқа аудио + lip-sync: Синхрондалған қоршаған орта аудиосын, эффектілерді және шамамен ерін қимылымен сәйкестендірілген қысқа сөйлеуді / баяндауды жасайды.
Image→Video / prompt арқылы өңдеу: Мәтіндік prompt-тар арқылы статикалық суретті жандандырыңыз немесе бар түсірілімді өңдеңіз (нысандарды жою/ауыстыру, уақытын өзгерту, стилін өзгерту).
Жылдам итерация және төмен кідіріс: Шығармашылық жұмыс ағындары мен өнім прототиптеуге қолайлы жылдам кері байланыс циклдеріне арналған.
Production API: Imagine API пакеттік генерация, өңдеу құбырларына біріктіру және enterprise басқару үшін бағдарламалық endpoint-терді ұсынады.
Бірнеше “mode” / стиль: Пайдаланушыға көрінетін режимдер (хабарланған мысалдар: Normal / Fun / Spicy немесе ұқсас пресеттер) нәтижелерді стильге немесе рұқсат деңгейіне қарай ыңғайлау үшін қолданылады (ескерту: “Spicy” режимі тарихи тұрғыда NSFW-ті қосқан).

Model (company)	Max res (public)	Max clip len (public)	Native audio?	Strengths	Caveats
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 (various specialists)	1080p дейін	қысқа (әртүрлі)	Аралас	Кейбірі нишалық мүмкіндіктер ұсынады (Smart Cuts, multi-shot chaining)	Аудио қолдауы әртүрлі; API жетілу деңгейі әрқилы

⚠️ Шектеулер

Бейненің максималды ұзақтығы 15 секундпен шектелген.
Өңдеу кіріс бейненің ұзақтығын сақтайды (≤ 8.7s).
Жасалған URL-дер уақытша — тезірек жүктеп алыңыз.

Grok Imagine Video-ға қалай қол жеткізуге және интеграциялауға болады

1-қадам: API кілті үшін тіркелу

cometapi.com сайтына кіріңіз. Егер сіз әлі біздің пайдаланушымыз болмасаңыз, алдымен тіркеліңіз. CometAPI console жүйесіне кіріңіз. Интерфейстің қол жеткізу тіркелгі дерегі API кілтін алыңыз. Жеке орталықтағы API token бөлімінде “Add Token” түймесін басып, token key алыңыз: sk-xxxxx және жіберіңіз.

2-қадам: `Grok Imagine Video` API-іне сұрау жіберу

API сұрауын жіберу және request body орнату үшін “grok-imagine-video” endpoint-ін таңдаңыз. Сұрау әдісі мен request body біздің сайттағы API doc құжатынан алынады. Біздің сайт сізге ыңғайлы болу үшін Apifox тестін де ұсынады. <YOUR_API_KEY> орнын аккаунтыңыздағы нақты CometAPI кілтімен ауыстырыңыз. Қай жерде шақыруға болады: GROKVideo Generation and Video Edit.

3-қадам: `Grok Imagine Video` API-іне сұрау жіберу

Мәтін енгізіңіз немесе сурет жүктеңіз(Қажет болса, жандандыру үшін бастапқы суретті ұсына аласыз.). Grok Imagine AI API сіздің кірісіңізді талдап, контентті url үшін дайындайды. Мәтіннен бейнеге де, суреттен бейнеге түрлендіру де қолдау табады.

Бастапқы сурет келесі түрде берілуі мүмкін:

Суретке нұсқайтын жария URL
base64-пен кодталған data URI( мысалы, data:image/jpeg;base64,<YOUR_BASE64_IMAGE>)

4-қадам: Нәтижелерді алу және тексеру

Жасалған жауапты алу үшін API жауабын өңдеңіз. Өңделгеннен кейін API тапсырма күйі мен шығыс деректерін қайтарады. Ол жіберілген сәтте бірден request_id қайтарады; күйді тексеру және жасалған бейнені алу үшін GET endpoint-ін пайдаланыңыз. Бейне өңдеу асинхронды, тапсырма аяқталғанша бұл endpoint-ті бірнеше рет сұратуыңыз қажет болуы мүмкін. Тезірек жүктеп алыңыз.

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

[Модель атауы] үшін кешенді үлгі кодтары мен API ресурстарына қол жеткізіп, интеграция процесіңізді жеңілдетіңіз. Біздің толық құжаттама қадам-қадаммен нұсқаулық береді, жобаларыңызда [Модель атауы] мүмкіндіктерін толық пайдалануға көмектеседі.

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