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

Metin istemi ve isteğe bağlı görsel/video kaynağı içeren 'grok-imagine-video' modeliyle bir POST isteği gönderirsiniz; bir görev kimliği döndürür, ardından video durumu 'done' olana kadar bu kimliği yoklarsınız.

What input formats does grok-imagine-video accept?

Animasyon için doğal dilde bir istem ve isteğe bağlı görsel URL'lerini (veya base64 görselleri) kabul eder; düzenleme için bir video URL'si sağlanır.

What are the maximum video duration and resolution options?

Model, 15 saniyeye kadar video üretimini ve 720p'ye kadar çözünürlükleri destekler; 16:9 veya 1:1 gibi yapılandırılabilir en-boy oranlarını destekler.

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

Evet, isteğinizde görsel URL'leri veya kodlanmış görseller kullanarak, isteminize göre durağan bir görseli harekete dönüştürebilirsiniz.

Does grok-imagine-video support editing existing videos?

Evet — kaynak video URL'sini ve düzenleme talimatlarınızı sağlayın; çıktı, orijinal videonun süresini ve çözünürlüğünü korur.

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

Oluşturulan videolar içerik denetimine tabidir; işaretlenen içerik oluşturma sırasında filtrelenebilir veya engellenebilir.

Is the video generation asynchronous?

Evet, API, videonun indirmeye hazır olup olmadığını kontrol etmek için yoklayacağınız bir istek kimliği döndürür.

How should I handle expired video URLs?

İndirilen videolar hızlıca kaydedilmelidir; geçici URL'ler üretimden sonra süresi dolabilir ve erişilemez hale gelebilir.

Uygun Fiyatlı Grok Imagine Video API | image-to-video

📘 Grok Imagine Video'nun Teknik Özellikleri

Özellik	Ayrıntılar
Model Kimliği	grok-imagine-video
Sağlayıcı	xAI
Tür	Video üretimi ve düzenleme yapay zekası
Girdi Türleri	Metin (komut); isteğe bağlı görüntü veya video. Metin komutları (doğal dil); isteğe bağlı görüntü girişi (görüntü→video); mevcut klipleri düzenlemek için isteğe bağlı video_url. Düzenleme girişi video maksimum süreleri uç noktaya göre değişir — bazı düzenleme akışları için ~8.7 sn raporlanmıştır.
Çıktı Türleri	Geçici URL üzerinden .mp4 video
Süre Aralığı (oluşturma)	1–15 saniye
Çözünürlük	480p, 720p (yapılandırılabilir)
En-Boy Oranları	1:1, 16:9, 9:16
Düzenleme Desteği	Evet — videoları 8.7 sn'ye kadar canlandırır ve değiştirir
Moderasyon	İçerik moderasyonu dahildir
Fiyatlandırma	Saniye başına ücretlendirme, çözünürlüğe göre değişir

🚀 Grok Imagine Video nedir?

Grok Imagine Video, CometAPI üzerinden sunulan xAI’nin gelişmiş video üretim ve düzenleme yapay zekası modelidir. Geliştiricilerin doğal dil komutlarından kısa, özel videolar üretmesini ve isteğe bağlı olarak durağan görüntüleri canlandırmasını veya mevcut klipleri düzenlemesini sağlar. Model, çıktının uzunluğu, çözünürlüğü ve en-boy oranı için yapılandırma desteği sunar ve yerleşik içerik moderasyonu ile politika uyumluluğunu gözetir.

🧠 Başlıca özellikler (Grok Imagine'i farklı kılan)

Yerel ses + dudak senkronu: Yaklaşık dudak senkronizasyonuyla senkronize ortam sesi, efektler ve kısa konuşma/anlatım üretir.
Görüntü→Video / komut düzenleme: Durağan bir görseli canlandırın veya metin komutlarıyla mevcut görüntüyü düzenleyin (nesneleri kaldır/değiştir, yeniden zamanla, yeniden stillendir).
Hızlı yineleme ve düşük gecikme: Yaratıcı iş akışları ve ürün prototipleme için hızlı geri bildirim döngüleri.
Üretim API'si: Imagine API, toplu üretim, düzenleme hatlarına entegrasyon ve kurumsal kontroller için programatik uç noktalar sunar.
Birden çok “mod”/stil: Kullanıcıya dönük modlar (bildirilen örnekler: Normal / Fun / Spicy veya benzeri hazır ayarlar) çıktıları stil veya esneklik açısından yönlendirir (not: “Spicy” modu geçmişte NSFW’yi etkinleştirmiştir).

Model (şirket)	Maks çözünürlük (herkese açık)	Maks klip uzunluğu (herkese açık)	Yerel ses?	Güçlü yönler	Sınırlamalar
Grok Imagine (xAI)	720p	6–15 sn	Evet	Hızlı yineleme, iyi maliyet/gecikme, entegre düzenleme, yerel ses	720p sınırı; moderasyon endişeleri; gerçek dünya fidelitesi değişken
Sora (OpenAI)	720p–1080p (kata bağlı)	kısa (6–15 sn)	Evet	Yüksek görsel doğruluk; OpenAI yığınıyla güçlü entegrasyon	Daha pahalı; kısıtlı moderasyon/denetimler
Veo (Google DeepMind)	1080p+’a kadar	kısa (değişken)	Evet	Güçlü fotogerçekçilik, kararlı hareket	Daha yüksek maliyet; daha az kamuya açık deneysellik
Runway Gen-4.5	1080p+	kısa (değişken)	Evet	Yaratıcı iş akışlarında sektör benimsemesi, yüksek doğruluk	Daha maliyetli; yaratıcı araçlara odaklı
Vidu / Kling / Pika (çeşitli uzmanlar)	1080p’a kadar	kısa (değişken)	Karışık	Bazıları niş özellikler sunar (Smart Cuts, çok çekimli zincirleme)	Çeşitli ses desteği; API olgunluğu farklı

⚠️ Sınırlamalar

Maksimum video uzunluğu 15 saniye ile sınırlıdır.
Düzenleme, giriş video uzunluğunu korur (≤ 8.7 sn).
Üretilen URL’ler geçicidir — hızlıca indirin.

Grok Imagine Video'ya erişim ve entegrasyon

Adım 1: API Anahtarı için Kaydolun

cometapi.com adresine giriş yapın. Henüz kullanıcımız değilseniz lütfen önce kayıt olun. CometAPI konsolunuza giriş yapın. Arayüzün erişim kimliği API anahtarını alın. Kişisel merkezde API token bölümünde “Add Token”a tıklayın, token anahtarını alın: sk-xxxxx ve gönderin.

Adım 2: `Grok Imagine Video` API’sine İstek Gönderin

API isteği göndermek için “grok-imagine-video” uç noktasını seçin ve istek gövdesini ayarlayın. İstek yöntemi ve istek gövdesi web sitemizdeki API dokümanından alınır. Kolaylık için web sitemizde Apifox testi de sağlanır. Hesabınızdaki gerçek CometAPI anahtarınızla <YOUR_API_KEY> değerini değiştirin. Nereden çağrılır: GROK Video Oluşturma ve Video Düzenleme.

Adım 3: `Grok Imagine Video` API’sine İstek Gönderin

Metin girin veya bir görüntü yükleyin (isteğe bağlı olarak canlandırılacak bir kaynak görüntü sağlayabilirsiniz). Grok Imagine AI API, girdinizi analiz eder ve içerik için bir URL hazırlar. Hem metinden videoya hem de görüntüden videoya dönüştürme desteklenir.

Kaynak görüntü şu şekilde sağlanabilir:

Bir görsele işaret eden herkese açık URL
Base64 kodlu bir veri URI’si (ör. data:image/jpeg;base64,<YOUR_BASE64_IMAGE>)

Adım 4: Sonuçları Alın ve Doğrulayın

API yanıtını işleyerek üretilen çıktıyı alın. İşlemden sonra API, görev durumu ve çıktı verileriyle yanıt verir. Gönderim sırasında hemen bir request_id döner; durumu kontrol etmek ve üretilen videoyu almak için GET uç noktasını kullanın. Video düzenleme eşzamansızdır, görev tamamlanana kadar bu uç noktayı birden fazla kez yoklamanız gerekebilir. Lütfen hızlıca indirin.

Grok Imagine Video için Fiyatlandırma

Grok Imagine Video için çeşitli bütçelere ve kullanım ihtiyaçlarına uygun rekabetçi fiyatlandırmayı keşfedin. Esnek planlarımız sadece kullandığınız kadar ödeme yapmanızı sağlar ve ihtiyaçlarınız büyüdükçe kolayca ölçeklendirme imkanı sunar. Grok Imagine Video'in maliyetleri yönetilebilir tutarken projelerinizi nasıl geliştirebileceğini keşfedin.

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 için örnek kod ve API

Grok Imagine Video için kapsamlı örnek kodlara ve API kaynaklarına erişerek entegrasyon sürecinizi kolaylaştırın. Ayrıntılı dokümantasyonumuz adım adım rehberlik sağlayarak projelerinizde Grok Imagine Video'in tüm potansiyelinden yararlanmanıza yardımcı olur.

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