Grok Imagine API: Panduan Python dan 3 Model Diuji Berdampingan

Grok Imagine API adalah API gambar dan video milik xAI, dan ada tiga model gambar yang bisa Anda panggil sekarang: grok-imagine-image, grok-imagine-image-quality, dan grok-imagine-image-2.0. Kami menjalankan empat prompt yang sama di ketiganya pada 18 Oktober 2026, dan Grok Imagine 2.0 menang di tiga dari empat uji.

Berikut: model mana yang dipilih, skrip Python yang langsung jalan, tarif xAI per gambar, dan hal yang perlu Anda perhatikan.

Jawaban singkat

• Pakai Grok Imagine 2.0 (grok-imagine-image-2.0) sebagai default. Model ini memberi tipografi poster, foto produk, dan foto terbaik dalam uji kami, dan xAI mencantumkannya mulai US$0,04 per gambar.
• Simpan grok-imagine-image yang asli untuk draf murah: US$0,02 per gambar di xAI, dan teks poster kami juga benar.
• Lewati grok-imagine-image-quality: xAI menghentikannya pada 2 November 2026, dan model itu menambahkan alamat karangan ke poster kami.
• Setiap gambar kembali dalam 7 sampai 18 detik.

Apa itu Grok Imagine API?

Ini API gambar dan video xAI, dibuka pada 28 Januari 2026 (xAI). Image 2.0 menyusul pada 7 Agustus 2026, dan menurut xAI model itu peringkat kedua dunia untuk pembuatan maupun penyuntingan gambar (xAI).

Ketiganya ada di OmniaKey: Grok Imagine, Grok Imagine Quality, dan Grok Imagine 2.0. OmniaKey menjual akses API ke model-model ini, jadi uji kami lewat OmniaKey; semua harga di sini adalah harga xAI sendiri.

Model Grok Imagine mana yang sebaiknya dipakai?

Grok Imagine 2.0, kecuali Anda hanya butuh draf murah. Kami memberi tiap model empat prompt yang sama satu kali, tanpa pengaturan ukuran atau rasio, lalu menilai gambarnya pada ukuran penuh.

Uji 1: teks poster

Prompt:

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.

Ketiganya menulis kedua baris dengan benar (poster di atas). Grok Imagine 2.0 punya tata letak paling dirancang, dengan garis tipis di sekitar tanggal. Quality menambahkan baris yang tidak diminta siapa pun:

Putusan: 2.0 untuk tampilan, yang asli kalau Anda hanya butuh teksnya benar. Hindari Quality untuk cetak: teks karangan adalah hal terakhir yang Anda mau di selebaran.

Uji 2: foto realistis

Prompt:

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: cahaya keemasan yang indah dan suasana yang masuk akal, tetapi seluruh dermaga tajam.
• Quality: subjek dan latar benar, namun nelayannya kecil di dalam bingkai dan detailnya lebih lembut.
• Grok Imagine 2.0: bidikan dekat dengan latar buram, satu-satunya yang jelas membuat "depth of field dangkal".

Putusan: 2.0.

Uji 3: foto produk

Prompt:

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.

Ketiganya benar di setiap detail: tutup terbuka, dua earbud, latar putih, tanpa logo. Yang asli membiarkan wadahnya kecil di dalam bingkai, dan Quality memotretnya dari sudut. Grok Imagine 2.0 memenuhi bingkai dengan detail tajam, siap untuk halaman toko.

Putusan: 2.0.

Uji 4: menghitung objek

Prompt:

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.

Ketiganya menaruh tepat tiga apel di kiri dan dua pir di kanan, tanpa apa pun lagi di meja. Yang asli menampilkan pir berdiri, bukan dari atas, dan pir 2.0 keluar lebih kuning daripada hijau.

Putusan: seri untuk hitungan; Quality punya bidikan dari atas paling bersih.

Bagaimana memanggilnya dari Python?

Tiga langkah: buat tugas, periksa sampai selesai, lalu unduh gambarnya. Taruh kunci Anda di variabel lingkungan lalu jalankan:

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. Buat tugas. Pakai Idempotency-Key yang sama hanya saat mencoba ulang permintaan ini.
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. Periksa status sampai tugas selesai.
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. Unduh sekarang: tautan bertanda tangan hanya berlaku sebentar.
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")

Saat kami menjalankannya pada 18 Oktober 2026, skrip mencetak ini dan menyimpan JPEG 1248 × 832 pada detik ke-16 setelah mulai:

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

Untuk mencoba model lain, ubah hanya nilai model.

Berapa biaya Grok Imagine API?

xAI menagih per gambar, dan harganya bergantung pada model, resolusi, dan untuk 2.0, tingkat kualitasnya. Ini tarif xAI sendiri dari halaman harga, dicek 18 Oktober 2026:

2.0 memakai kualitas rendah untuk gambar baru kecuali Anda meminta lain, jadi gambar 1K biayanya US$0,04 di xAI. Di API xAI sendiri, permintaan yang melanggar pedoman penggunaan tetap ditagih. Lewat OmniaKey Anda membayar harga tetap per gambar (lihat tarif terbaru di halaman model), dan tugas yang gagal dananya dikembalikan.

Apa yang perlu Anda perhatikan?

• Tidak ada penyuntingan lewat OmniaKey. API xAI sendiri memungkinkan 2.0 menyunting gambar dengan sampai lima gambar referensi, tetapi lewat OmniaKey Grok hanya membuat gambar baru. Untuk menyunting, pakai model yang mendukungnya, misalnya Nano Banana 2.1.
• Bentuknya dipilih model. Tanpa pengaturan rasio, Grok memilih potret untuk poster kami dan lanskap untuk pemandangan, semuanya sekitar satu megapiksel (832 × 1248 sampai 1280 × 720).
• Quality hilang pada 2 November. Setelah itu xAI melayani permintaan grok-imagine-image-quality dengan 2.0 kualitas rendah, jadi pindah sekarang.
• Coba ulang sekali saat 400. Satu dari 14 tugas kami gagal dengan 400 dan dananya dikembalikan; percobaan ulang yang identik berhasil.

Kesimpulan

Untuk sebagian besar pekerjaan, panggil grok-imagine-image-2.0: model ini menang di tiga dari empat uji kami dan biayanya US$0,04 per gambar 1K di xAI. Pakai model asli saat Anda butuh banyak draf murah, dan tinggalkan Quality sebelum 2 November.

Pertanyaan umum

Apakah Grok Imagine API gratis?

Tidak. xAI mencantumkan harga per gambar untuk setiap model gambar Grok, mulai US$0,02 untuk model asli.

Bisakah Grok Imagine membuat video lewat API?

Bisa. xAI menagih model videonya per detik, misalnya US$0,08 per detik pada 480p untuk Grok Imagine Video 1.5. Di OmniaKey, lihat Grok Imagine Video 1.5.

Berapa ukuran gambar yang saya dapat?

Sekitar satu megapiksel sebagai default. Panduan xAI mencantumkan 1K sebagai default dan 2K sebagai opsi, dan model memilih rasio aspek kecuali Anda menetapkannya.

Apa yang terjadi pada grok-imagine-image-quality setelah 2 November?

xAI tetap menjawabnya, tetapi dengan Grok Imagine 2.0 kualitas rendah dan harga 2.0. grok-imagine-image yang asli tidak terpengaruh.