Grok Imagine API: Python ile kullanımı ve yan yana test ettiğimiz 3 model

Grok Imagine API, xAI'nin görsel ve video API'si ve bugün çağırabileceğiniz üç görsel modeli var: grok-imagine-image, grok-imagine-image-quality ve grok-imagine-image-2.0. 18 Ekim 2026'da aynı dört istemi üçünde de çalıştırdık ve Grok Imagine 2.0 dört testin üçünü kazandı.

Aşağıda: hangi modeli seçeceğiniz, olduğu gibi çalışan bir Python betiği, xAI'nin görsel başına ne aldığı ve nelere dikkat etmeniz gerektiği.

Kısa cevap

• Varsayılan olarak Grok Imagine 2.0'ı (grok-imagine-image-2.0) kullanın. Testlerimizde en iyi poster tipografisini, ürün çekimini ve fotoğrafı o verdi; xAI onu görsel başına 0,04 $'dan başlayan fiyatla listeliyor.
• Ucuz taslaklar için orijinal grok-imagine-image modelini tutun: xAI'de görsel başına 0,02 $ ve poster metnini o da doğru yazdı.
• grok-imagine-image-quality modelini atlayın: xAI onu 2 Kasım 2026'da kaldırıyor ve posterimize uydurma bir adres ekledi.
• Her görsel 7 ile 18 saniye arasında döndü.

Grok Imagine API nedir?

xAI'nin görsel ve video API'si; 28 Ocak 2026'da açıldı (xAI). Image 2.0, 7 Ağustos 2026'da geldi ve xAI'ye göre hem görsel üretiminde hem düzenlemede dünyada ikinci (xAI).

Üçü de OmniaKey'de var: Grok Imagine, Grok Imagine Quality ve Grok Imagine 2.0. OmniaKey bunlara API erişimi satıyor, testlerimizi onun üzerinden çalıştırdık; buradaki her fiyat xAI'nin kendi fiyatı.

Hangi Grok Imagine modelini kullanmalısınız?

Grok Imagine 2.0, yalnızca ucuz taslaklara ihtiyacınız yoksa. Her modele aynı dört istemi bir kez verdik, boyut ya da oran ayarı yapmadık ve görselleri tam boyutta değerlendirdik.

Test 1: poster metni

İstem:

A minimalist poster for a neighborhood coffee shop opening. Large bold headline text "GRAND OPENING", smaller text below "Saturday 9 AM", a simple line drawing of a coffee cup, cream background, dark brown ink.

Üçü de iki satırı doğru yazdı (yukarıdaki poster). En tasarlanmış düzen Grok Imagine 2.0'daydı; tarihin çevresinde ince çizgiler vardı. Quality kimsenin istemediği bir satır ekledi:

Karar: görünüm için 2.0, sadece metin doğru olsun diyorsanız orijinal. Baskı için Quality'den uzak durun: uydurma metin el ilanında en son isteyeceğiniz şey.

Test 2: gerçekçi bir fotoğraf

İstem:

A realistic photo of an elderly fisherman mending a blue net on a wooden dock at sunrise, soft golden light, gulls in the background, shallow depth of field.

• Grok Imagine: güzel altın ışık ve inandırıcı bir sahne, ama iskelenin tamamı net.
• Quality: konu ve mekân doğru, ancak balıkçı kadrajda küçük kalıyor ve detay daha yumuşak.
• Grok Imagine 2.0: arka planı bulanık bir yakın çekim; "sığ alan derinliğini" açıkça yapan tek model.

Karar: 2.0.

Test 3: ürün çekimi

İstem:

Studio product photo of a matte black wireless earbud case, lid open, both earbuds inside, on a pure white background, soft shadow, sharp focus, no text, no logo.

Üçü de her ayrıntıyı doğru yaptı: açık kapak, iki kulaklık, beyaz zemin, logo yok. Orijinal kutuyu kadrajda küçük bıraktı, Quality açılı çekti. Grok Imagine 2.0 kadrajı net ayrıntıyla doldurdu; mağaza sayfasına hazır.

Karar: 2.0.

Test 4: nesne sayma

İstem:

Top-down photo of a wooden table with exactly three red apples on the left and exactly two green pears on the right, nothing else on the table.

Üçü de sola tam üç elma, sağa tam iki armut koydu; masada başka hiçbir şey yoktu. Orijinalde armutlar tepeden değil ayakta duruyordu, 2.0'ın armutları ise yeşilden çok sarıya kaçtı.

Karar: saymada beraberlik; en temiz tepeden çekim Quality'de.

Python'dan nasıl çağırılır?

Üç adım: işi oluştur, bitene kadar kontrol et, görseli indir. Anahtarınızı bir ortam değişkenine koyun ve çalıştırın:

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']}"}

# 1. İşi oluştur. Aynı Idempotency-Key'i yalnızca bu isteği yeniden denerken kullanın.
job = requests.post(
    API,
    headers={**HEADERS, "Idempotency-Key": str(uuid.uuid4())},
    json={
        "model": "grok-imagine-image-2.0",
        "type": "image",
        "operation": "generate",
        "input": {"prompt": "A flat illustration of a red bicycle leaning on a yellow wall, morning light"},
    },
    timeout=30,
)
job.raise_for_status()
task = job.json()
print("task:", task["id"], task["status"])

# 2. İş bitene kadar status alanını yoklayın.
while task["status"] in ("queued", "processing"):
    time.sleep(2)
    task = requests.get(f"{API}/{task['id']}", headers=HEADERS, timeout=30).json()

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

# 3. Hemen indirin: imzalı bağlantı kısa ömürlüdür.
asset = task["assets"][0]
with open("bicycle.jpg", "wb") as f:
    f.write(requests.get(asset["url"], timeout=60).content)
print("saved bicycle.jpg", asset["mime_type"], asset["byte_size"], "bytes")

18 Ekim 2026'da çalıştırdığımızda şunu yazdırdı ve başladıktan 16 saniye sonra 1248 × 832 boyutunda bir JPEG kaydetti:

task: task_LBCu6Lr8hyD4RH25JfiOixJHPHi3Cd0o queued
saved bicycle.jpg image/jpeg 267732 bytes

Başka bir modeli denemek için yalnızca model değerini değiştirin.

Grok Imagine API ne kadar?

xAI görsel başına ücret alıyor; fiyat modele, çözünürlüğe ve 2.0'da kalite seviyesine göre değişiyor. Aşağıdakiler xAI'nin fiyat sayfasındaki kendi tarifeleri, 18 Ekim 2026'da kontrol edildi:

2.0, aksi söylenmedikçe yeni görseller için düşük kaliteyi kullanıyor, yani xAI'de 1K bir görsel 0,04 $ tutuyor. xAI'nin kendi API'sinde kullanım kurallarını ihlal eden bir istek yine de faturalanıyor. OmniaKey'de görsel başına sabit bir fiyat ödüyorsunuz (güncel tarifeler model sayfalarında) ve başarısız bir iş iade ediliyor.

Nelere dikkat etmelisiniz?

• OmniaKey üzerinden düzenleme yok. xAI'nin kendi API'sinde 2.0, en fazla beş referans görselle düzenleme yapabiliyor; OmniaKey üzerinden Grok yalnızca yeni görsel üretiyor. Düzenleme için bunu destekleyen bir model kullanın, örneğin Nano Banana 2.1.
• Şekli model seçiyor. Oran ayarı olmadan Grok posterimizi dikey, sahneleri yatay yaptı; hepsi bir megapiksel civarında (832 × 1248 ile 1280 × 720 arası).
• Quality 2 Kasım'da kalkıyor. Ondan sonra xAI, grok-imagine-image-quality isteklerini 2.0'ın düşük kalitesiyle yanıtlıyor, o yüzden şimdi geçin.
• 400 alırsanız bir kez tekrar deneyin. 14 işimizden biri 400 ile düştü ve iade edildi; aynı isteğin tekrarı çalıştı.

Sonuç

Çoğu iş için grok-imagine-image-2.0 modelini çağırın: dört testimizin üçünü kazandı ve xAI'de 1K görsel başına 0,04 $ tutuyor. Çok sayıda ucuz taslak gerektiğinde orijinal modeli kullanın ve Quality'den 2 Kasım'dan önce çıkın.

Sık sorulan sorular

Grok Imagine API ücretsiz mi?

Hayır. xAI her Grok görsel modeli için görsel başına fiyat listeliyor; en ucuzu orijinal model ve 0,02 $.

Grok Imagine ile API'den video yapılabilir mi?

Evet. xAI video modellerini saniye başına fiyatlıyor, örneğin Grok Imagine Video 1.5 için 480p'de saniye başına 0,08 $. OmniaKey'de Grok Imagine Video 1.5 sayfasına bakın.

Görsel hangi boyutta geliyor?

Varsayılan olarak bir megapiksel civarında. xAI'nin kılavuzunda varsayılan 1K, seçenek 2K ve oranı siz ayarlamazsanız model seçiyor.

2 Kasım'dan sonra grok-imagine-image-quality ne olacak?

xAI yanıtlamaya devam ediyor, ama Grok Imagine 2.0'ın düşük kalitesiyle ve 2.0 fiyatıyla. Orijinal grok-imagine-image bundan etkilenmiyor.