Grok Imagine Video API: Python ile metinden videoya

Grok Imagine Video API eşzamansızdır: bir istem gönderip iş oluşturursunuz, iş kimliğini tamamlanana kadar sorgularsınız ve sonunda MP4'ü indirirsiniz. Güncel model grok-imagine-video-1.5. 24 Ekim 2026'da 6 saniyelik 720p klibimiz istekten 46 saniye sonra hazırdı ve içinde ses kanalı vardı.

Aşağıda olduğu gibi çalışan betik, sonucu belirleyen parametreler, bir klipin maliyeti ve süresi, bir de karşılaşacağınız hatalar var.

Kısa cevap

• Model: grok-imagine-video-1.5. xAI, 1.5'in önizlemeden çıkıp 16 Haziran 2026'da genel kullanıma açıldığını söylüyor (xAI).
• Ayarlar: duration 4–15 saniye, resolution "720p", ratio ise "16:9" gibi bir değer.
• Maliyet: xAI listesine göre 720p'de saniyesi 0,14 USD, yani 6 saniyelik klip 0,84 USD (xAI model sayfası, 24 Ekim 2026'da kontrol edildi).
• Süre: 6 saniyelik 720p işimiz 46 saniye sürdü. Aynı görev kimliğini sorgulayıp dosyayı bir saat içinde indirin.

Grok Imagine Video API nasıl çalışır?

İş üç adımdır: oluştur, sorgula, indir (xAI video üretim rehberi, 24 Ekim 2026'da kontrol edildi).

xAI'nin kendi API'sinde model kimliğini ve istemi https://api.x.ai/v1/videos/generations adresine POST ile gönderip request_id alırsınız. Sonra iş done olana kadar https://api.x.ai/v1/videos/{request_id} adresini GET ile sorgular ve video.url alanını okursunuz (aynı rehber).

xAI basit videolar için grok-imagine-video-1.5-lite, referans, ses, sabit kare veya yerel 1080p gerektiğinde grok-imagine-video-1.5 öneriyor (video genel bakış, 24 Ekim 2026'da kontrol edildi). Durağan görseller için Grok Imagine görsel API rehberi xAI'nin üç görsel modelini anlatıyor; Grok'u başka video API'leriyle karşılaştırmak için video model karşılaştırmamıza bakın.

OmniaKey Grok Imagine Video 1.5 için API erişimi satıyor, bu yüzden örneği onun üzerinden çalıştırdık. Çağrılar Idempotency-Key başlığıyla POST https://api.omniakey.com/v1/media/tasks adresine gidiyor ve 202 ile id dönüyor; durum için GET /v1/media/tasks/{id} kullanılıyor (OmniaKey medya genel bakış, 24 Ekim 2026'da kontrol edildi). Aynı oluştur, sorgula, indir akışı video API belgelerindeki diğer modeller için de geçerli: Kling 3.0, Seedance, Wan 3.0, MiniMax H3 ve HappyHorse. Aşağıdaki fiyatların hepsi xAI'nin kendi fiyatları.

xAI alan adları Videos API başvurusundan, OmniaKey alan adları video API belgelerinden geliyor; ikisi de 24 Ekim 2026'da kontrol edildi.

Hangi parametreleri ayarlayabilirsiniz?

İstem ve üç ayar ne alacağınızı belirler.

• duration OmniaKey'de zorunlu ve fiyatı belirliyor (OmniaKey video belgeleri). Bu model için OmniaKey'in alt sınırı 4 saniye, xAI'nin üst sınırı 15 (video üretim rehberi), yani 4–15 aralığında kalın.
• resolution: küçük harfle "720p" gönderin. OmniaKey Grok videosunu en fazla 720p sunuyor (OmniaKey medya genel bakış). xAI'nin kendi API'sinde ayrıca varsayılan 480p ve yerel 1080p var (üretim rehberi).
• ratio dokuz değer alıyor: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9 ve 5:2; varsayılanı 16:9 (video üretim rehberi). Biz 16:9 kullandık.
• n yalnızca 1 olabilir (OmniaKey video belgeleri).
• İstem: planı, ışığı ve kamera hareketini yazın, sonra bir Sound: satırı ekleyin. Orada adını andığınız her şey görüntüde de çıkabilir: bizim ses satırımızda kaşık geçiyordu, görüntüde bir kaşık ve bir el belirdi.

Python ile metin istemini videoya nasıl çevirirsiniz?

requests kurun, anahtarı OMNIAKEY_API_KEY içine koyun ve betiği çalıştırın.

pip install requests
export OMNIAKEY_API_KEY="your-key"

Çalıştırdığımız betik, değiştirmeden:

import os
import time
import uuid

import requests

API = "https://api.omniakey.com/v1/media/tasks"
HEADERS = {"Authorization": f"Bearer {os.environ['OMNIAKEY_API_KEY']}"}

PROMPT = (
    "Close-up of a white ceramic coffee cup on a wooden café table by a window, "
    "morning sunlight, steam curling up from the coffee, the camera slowly pushes in, "
    "shallow depth of field. Sound: quiet café chatter and a spoon clinking on a saucer."
)

# 1. İşi oluştur. Aynı Idempotency-Key yalnızca bu isteği tekrar denerken kullanılır.
job = requests.post(
    API,
    headers={**HEADERS, "Idempotency-Key": str(uuid.uuid4())},
    json={
        "model": "grok-imagine-video-1.5",
        "type": "video",
        "operation": "text_to_video",
        "input": {"prompt": PROMPT},
        "parameters": {"duration": 6, "resolution": "720p", "ratio": "16:9"},
    },
    timeout=30,
)
job.raise_for_status()
task = job.json()
print("task:", task["id"], task["status"])

# 2. İş bitene kadar sorgula. Yavaş iş başarısız değildir: aynı id'yi sormaya devam et.
while True:
    task = requests.get(f"{API}/{task['id']}", headers=HEADERS, timeout=30).json()
    if task["status"] not in ("queued", "processing"):
        break
    time.sleep(5)

if task["status"] != "succeeded":
    raise SystemExit(f"job ended {task['status']}: {task.get('error')}")

# 3. Hemen indir: imzalı URL yaklaşık bir saat sonra sona erer.
asset = task["assets"][0]
with open("coffee.mp4", "wb") as f:
    f.write(requests.get(asset["url"], timeout=120).content)
print("saved coffee.mp4", asset["mime_type"], asset["byte_size"], "bytes")

24 Ekim 2026'da yazdırdığı son satır:

saved coffee.mp4 video/mp4 2659230 bytes

Betiğin ilk satırı görev kimliğini ve durumu yazdırır. Bu kimliği saklayın: betik durursa işi bununla yeniden bulursunuz.

6 saniyelik 720p iş şöyle döndü:

Klip istemi izliyor: beyaz seramik fincanda siyah kahve, beyaz tabak, pencere kenarında ahşap masa, yükselen buhar ve arkada bulanık kafe. Kamera sabit hızla yaklaşıyor ve fincan kare genişliğinin yaklaşık üçte birinden yarısına kadar büyüyor. 4,5 saniyede sağdan bir kaşık giriyor. Ses sakin bir kanal ve 4,8 saniyede tek bir keskin tepe var; kaşığın tabağa değdiği anla aynı yere düşüyor.

Bir klip ne kadar tutar ve ne kadar sürer?

xAI videoyu saniye üzerinden faturalıyor ve tarife modele ve çözünürlüğe göre değişiyor. Model sayfası (24 Ekim 2026'da kontrol edildi) fiyatı çözünürlüğe göre ayırıyor; fiyat sayfasındaki tek fiyat 0,080 USD/saniye ise 480p tarifesi.

Bu liste fiyatlarıyla:

• 1.5 ile 720p'de 6 saniye: 6 × 0,14 = 0,84 USD.
• Varsayılan uzunluk olan 8 saniye, 1.5 ile 480p'de: 8 × 0,08 = 0,64 USD.
• 1.5 ile 1080p'de 15 saniye: 15 × 0,25 = 3,75 USD.
• 1.5 Lite ile 720p'de 6 saniye: 6 × 0,03 = 0,18 USD.

xAI yalnızca saniye başına video tarifesi yayımlıyor (fiyat sayfası, 24 Ekim 2026'da kontrol edildi).

OmniaKey'de ücret, istediğiniz süre ile saniye tarifesinin çarpımı; iş oluşturulurken bakiyeden düşülüyor ve iş başarısız olursa otomatik iade ediliyor (OmniaKey video belgeleri, 24 Ekim 2026'da kontrol edildi). 6 saniye istedik, 6,04 saniyelik dosya geldi ve 6 saniye üzerinden faturalandı. Güncel tarifeler Grok Imagine Video 1.5 sayfasında.

İşimiz istekten succeeded durumuna 46 saniyede geldi. xAI üretimin "genelde birkaç dakika sürebildiğini" söylüyor ve SDK'sı 10 dakikaya kadar bekliyor (üretim rehberi). Birkaç saniyede bir sorgulayın. Döngüye süre sınırı koyacaksanız pay bırakın; sınır dolduğunda yeni istek göndermek yerine işi kimliğiyle yeniden okuyun.

İmzalı bağlantı yaklaşık bir saat yaşıyor ve bizimki iş bittikten tam bir saat sonra sona erdi. Görev kaydı 24 saat saklanıyor, yani yeniden sorgulayıp taze bir bağlantı alabilirsiniz (OmniaKey medya genel bakış, 24 Ekim 2026'da kontrol edildi).

Hangi hatalarla karşılaşırsınız?

Hataların çoğu iş oluşmadan hemen dönüyor, yani ücret doğurmuyor. Sonradan başarısız olan iş failed olarak bitiyor ve ücret iade ediliyor. OmniaKey medya belgeleri (24 Ekim 2026'da kontrol edildi) aralarında şunları sayıyor:

İlk ikisini 24 Ekim 2026'da bilerek çıkardık. Başlığı atlayınca HTTP 400 dönüyor:

{"error":{"code":"missing_idempotency_key","message":"Idempotency-Key is required and must be at most 255 characters"}}

İşin anahtarını koruyup istemi değiştirerek gönderince HTTP 409 dönüyor:

{"error":{"code":"idempotency_key_reused","message":"Idempotency-Key was already used with a different request"}}

• Yavaş bir işi hâlâ çalışıyor sayın. Aynı görev kimliğini sorgulamaya devam edin; isteği yeni bir Idempotency-Key ile tekrar göndermek ikinci bir iş başlatır ve onu da faturalar.
• Tekrarlanan istek 200 ile özgün görevi döndürür ama assets listesi olmadan. Betiğin önce görevi okuyup sonra assets almasının nedeni bu.

Sık sorulan sorular

Grok Imagine Video API ücretsiz mi?

Hayır. xAI yalnızca saniye tarifesi yayımlıyor ve en ucuzu 1.5 Lite ile 480p'de saniyede 0,02 USD (model sayfası, 24 Ekim 2026'da kontrol edildi).

Grok Imagine videosu en fazla kaç saniye olabilir?

xAI API'sinde 1 ile 15 saniye arası, varsayılanı 8 saniye (video üretim rehberi). OmniaKey üzerinden 4–15 saniye kullanın: bu model için OmniaKey'in alt sınırı 4 (OmniaKey video belgeleri, 24 Ekim 2026'da kontrol edildi), xAI'nin üst sınırı 15.

Grok Imagine Video ses üretiyor mu?

Evet, varsayılan olarak bir ses kanalı var; efektler, ortam sesi ve konuşma görüntüyle birlikte üretiliyor (video üretim rehberi; xAI duyurusu). Bizimkinde stereo AAC kanal vardı. xAI API'si sessiz klip için generate_audio: false kabul ediyor; indirdiğiniz dosyadan kanalı çıkarmak için şunu çalıştırın:

ffmpeg -i coffee.mp4 -an -c:v copy coffee-silent.mp4

Grok Imagine görselden video yapabilir mi?

Evet, xAI API'sinde: görseli image olarak verin (herkese açık URL, base64 data URI veya Files API'den file_id; JPEG, PNG ya da WebP), ilk kare o olur, istem isteğe bağlıdır ve klip görselin en-boy oranını korur (görselden videoya rehberi; Videos API başvurusu). OmniaKey üzerinden görselden videoya örneğini baştan sona doğruladığımızda buraya ekleyeceğiz.

Grok Imagine Video 1.5 ile 1.5 Lite arasındaki fark ne?

Lite saniye başına en ucuzu: metinden videoya ve görselden videoya yapıyor, dudak senkronlu ses ekliyor, 1080p'ye 720p'yi yükselterek çıkıyor; referans görsel, ses referansı ve anahtar kare kabul etmiyor (video genel bakış; Lite model sayfası). Buradaki örnekler 1.5 kullanıyor; OmniaKey'de Grok Imagine Video 1.5 olarak çağırıyorsunuz.

grok-imagine-video-1.5-preview hâlâ geçerli bir model kimliği mi?

xAI onu hâlâ takma ad olarak listeliyor ama 1.5 önizlemeden çıkıp 16 Haziran 2026'da genel kullanıma açıldı (model sayfası; xAI duyurusu). grok-imagine-video-1.5 kullanın.