model

xAI: Grok Imagine Image 2.0

Markdown · JSON

xAI: Grok Imagine Image 2.0

Grok Imagine Image 2.0 membuat gambar dari brief tertulis dan mengedit gambar yang ada melalui instruksi bahasa alami. xAI mendokumentasikan pengaturan kualitas, resolusi dan komposisi, referensi beberapa gambar, transfer gaya serta penyempurnaan berulang.

Tentang model

Deskripsi ini mencakup kemampuan model. Masukan, keluaran, dan opsi yang tersedia di Ailoot tercantum di bawah untuk metode yang dipilih.

Grok Imagine Image 2.0 adalah model pembuatan dan pengeditan gambar dari xAI. Model ini menerima deskripsi tertulis, atau deskripsi beserta gambar sumber, lalu mengembalikan hasil gambar. Profil 2.0 yang diberi nama oleh pembuatnya mencakup pembuatan adegan, perubahan gambar yang ada, penggabungan subjek dari referensi dan transformasi gaya visual. Mulailah dengan memilih apakah Anda memerlukan komposisi baru atau perubahan tertentu pada materi yang sudah Anda miliki.

Membuat gambar dari brief

Jelaskan subjek utama, latar, komposisi, pencahayaan dan perlakuan visualnya. Tentukan apa yang harus pertama kali diperhatikan penonton dan di mana gambar akan digunakan. Untuk konsep produk, contoh brief dapat menggambarkan lampu meja keramik di atas meja batu berwarna pucat, cahaya lembut dari jendela, tampilan dekat material dan ruang kosong untuk judul terpisah. Untuk ilustrasi, tentukan karakter, aksi dan estetika yang diinginkan, alih-alih mengharapkan satu kata gaya menentukan seluruh adegan.

Pembuatnya mendokumentasikan satu hingga sepuluh gambar keluaran dari satu permintaan pembuatan, dengan satu gambar sebagai pengaturan bawaan. Beberapa hasil dari brief yang sama memberikan alternatif untuk ditinjau; hasil tersebut tidak menjamin subjek yang identik pada setiap variasi. Periksa subjek, komposisi dan detail penting, lalu simpan versi yang paling sesuai dengan brief. Simpan brief bersama variasi yang dipilih agar pengeditan berikutnya menggunakan komposisi yang dimaksud.

Komposisi, resolusi dan kualitas

Panduan pembuatan mendokumentasikan pemilihan rasio aspek otomatis atau rasio eksplisit. Pilihan yang tercantum meliputi 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 2:1, 1:2, 19.5:9, 9:19.5, 20:9, 9:20, 21:9 dan 5:2. Pilih bentuk sesuai penempatan yang dituju: persegi untuk ubin ringkas, potret untuk komposisi vertikal, atau lanskap untuk adegan lebar. Tentukan subjek yang perlu diperhatikan saat pemotongan dan ruang yang dibutuhkan tata letak, alih-alih hanya mengandalkan rasio aspek.

Pengaturan resolusi pembuatan yang didokumentasikan adalah 1k dan 2k, dengan 1k sebagai pengaturan bawaan. Kualitas merupakan kontrol terpisah dengan pilihan low, medium dan auto. Dalam panduan xAI saat ini, auto adalah pengaturan bawaan dan menggunakan low untuk pembuatan serta medium untuk pengeditan; pengaturan low atau medium secara eksplisit menetapkan pilihan tersebut. Karena itu, resolusi dan kualitas menggambarkan kontrol yang berbeda. Nyatakan detail visual yang penting dan periksalah dalam gambar yang dikembalikan, alih-alih menganggap salah satu pengaturan menjamin ketepatan tulisan, geometri atau pelestarian subjek.

Mengedit dan mentransfer gaya visual

Sertakan gambar yang akan diubah dan jelaskan perubahan yang diminta berdasarkan konten yang terlihat. Pengeditan terarah dapat meminta penggantian dinding gelap dengan permukaan plester terang sambil mempertahankan susunan furnitur, sudut pandang kamera dan pencahayaan hangat. Jika tujuannya adalah transformasi gaya, tentukan perlakuan yang diinginkan: pembuatnya mencontohkan gaya fotografi, anime, lukisan minyak, cat air, pop art dan sketsa pensil. Tentukan elemen mana yang harus mempertahankan tampilannya dan mana yang boleh berubah mengikuti perlakuan tersebut.

Alur kerja pengeditan dari pembuatnya menerima referensi gambar sumber, data gambar yang dikodekan atau pengenal berkas. Untuk referensi tersimpan, gunakan gambar PNG, JPEG atau WebP yang telah diunggah sepenuhnya. Panduannya juga mendokumentasikan pengeditan berturut-turut: gunakan hasil satu pengeditan sebagai masukan pengeditan berikutnya. Cara ini dapat mengubah komposisi dasar menjadi hasil yang lebih spesifik melalui perubahan furnitur yang dilanjutkan dengan penyesuaian pencahayaan. Kaitkan gambar asli dan gambar perantara yang dipilih dengan setiap brief agar penyempurnaan berikutnya dapat diperiksa terhadap komposisi yang dimaksud.

Menggabungkan beberapa referensi

Panduan beberapa gambar saat ini mengizinkan hingga lima gambar sumber dalam satu pengeditan. Rujuk gambar sesuai urutan pemberiannya dan tetapkan peran yang jelas untuk masing-masing, misalnya subjek dari gambar pertama dan lingkungan dari gambar kedua. Secara bawaan, rasio keluaran mengikuti gambar masukan pertama, dengan rasio eksplisit tersedia untuk menggantikannya. Untuk konsep produk di dalam ruangan, jelaskan posisi, ukuran dan kontak produk dengan permukaan ruangan, lalu minta agar detail yang menjadi ciri pengenalnya dipertahankan. Tinjau cara sumber digabungkan, alih-alih menganggap setiap elemen disalin tanpa perubahan.

Menerima dan menyimpan gambar

Secara bawaan, pembuatnya mengembalikan alamat gambar sementara dan juga mendokumentasikan keluaran gambar yang dikodekan. Segera simpan gambar sebenarnya jika diperlukan sebagai aset. Alur kerja tertunda opsionalnya memisahkan pengakuan penerimaan permintaan dari penyelesaian: pengenal permintaan diikuti status pending, done atau failed, dan hasil tertunda menggunakan format respons alamat dengan masa penyimpanan 24 jam yang didokumentasikan. Permintaan yang telah dikirim atau status pending bukanlah gambar yang telah selesai. Simpan gambar yang telah selesai beserta brief dan pengaturan yang dipilih untuk digunakan kembali nanti.

Artefak akhir yang berguna adalah gambar yang sesuai dengan adegan, tata letak atau brief pengeditan yang telah ditentukan. Periksa keseluruhan komposisi dan detail kecilnya, terutama subjek sumber, batas objek, proporsi dan tulisan apa pun yang membawa makna. Untuk pekerjaan berulang, ubah instruksi yang terkait dengan masalah yang terlihat dan gunakan hasil pilihan sebagai referensi berikutnya. Buat perubahan yang diinginkan dan instruksi pelestarian tetap konkret agar setiap hasil dapat dinilai terhadap tujuan kreatif tertentu.

Ailoot Ultra · Gambar POST /v1/images/generations x-ai/grok-imagine-image-2.0

x-ai/grok-imagine-image-2.0

xAI /x-ai/grok-imagine-image-2.0

Mulai

Grok Imagine Image 2.0 membuat gambar dari brief tertulis dan mengedit gambar yang ada melalui instruksi bahasa alami. xAI mendokumentasikan pengaturan kualitas, resolusi dan komposisi, referensi beberapa gambar, transfer gaya serta penyempurnaan berulang.

Masukan yang diterima
Teks · Gambar
Hasil
Gambar

Tersedia di Ailoot · masukan & metode

Ailoot Ultra · Gambar POST /v1/images/generations
Masukan
text, image
Keluaran
image
KolomJenisPersyaratanNilai & batasanBawaan
KolommodelJenisstringPersyaratanWajibNilai & batasan
x-ai/grok-imagine-image-2.0
Bawaan—
KolompromptJenisstringPersyaratanWajibNilai & batasan
Panjang minimum: 1
Bawaan—
KolomresolutionJenisstringPersyaratanOpsionalNilai & batasan
1K, 2K
Bawaan—
Kolomaspect_ratioJenisstringPersyaratanOpsionalNilai & batasan
1:1, 3:4, 4:3, 9:16, 16:9, 2:3, 3:2, 9:19.5, 19.5:9, 9:20, 20:9, 1:2, 2:1, auto
Bawaan—
KolomqualityJenisstringPersyaratanOpsionalNilai & batasan
low, medium
Bawaan—
KolomnJenisintegerPersyaratanOpsionalNilai & batasan
Minimum: 1
Maksimum: 1
Bawaan—
Kolominput_referencesJenisarrayPersyaratanOpsionalNilai & batasan
Item minimum: 0
Item maksimum: 3
Bawaan—
KolomproviderJenisobjectPersyaratanOpsionalNilai & batasanBawaan—
Parameter metode dan siklus hidup
ParameterKontrak
Parametercontent_typeKontrakapplication/json
ParameterrequiredKontrakmodel, prompt
Parametermaterial_typesKontraktext, image

Siklus hidup: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · task_id aktual yang dikembalikan atau catatan pustaka media

GET /v1/media/assets/{asset_id}/content

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Paket

Cara menghitung biaya akhir

Tarif yang ditampilkan memperkirakan biaya sebelum pembuatan. Biaya akhir dihitung dari biaya yang tercatat untuk proses pembuatan awal. Durasi keluaran yang terukur dan kuantitas perkiraan bukanlah kuantitas akhir yang ditagihkan.

Referensi tarif tidak menambah opsi permintaan. Parameter yang didukung tercantum pada metode yang dipilih.

Mode Fast
Tidak ditentukan Saat mode fast dipilih
Mode Flex
Tidak ditentukan Saat mode flex dipilih
Upaya penalaran maksimum
Tidak ditentukan Saat upaya penalaran maksimum menggunakan penyesuaian default

Perkiraan tarif untuk perbandingan

Harga menurut konfigurasi

Cocokkan setiap biaya dengan kondisi yang ditampilkan. Gunakan satu tarif untuk setiap kelompok konfigurasi alternatif.

KonfigurasiJadwal tarifJumlah perkiraanSatuan penagihanBiaya
KonfigurasiTarif dasar tokenJadwal tarifTarif dasarJumlah perkiraan—Satuan penagihan—Biaya
Masukan · Token masukan · Perkiraan hanya untuk perbandingan — / 1K token
Keluaran · Token keluaran · Perkiraan hanya untuk perbandingan — / 1K token
Masukan · Pembacaan cache · Perkiraan hanya untuk perbandingan — / 1K token
Masukan · Penulisan cache · Perkiraan hanya untuk perbandingan — / 1K token
Masukan · Penulisan cache, 1 jam · Perkiraan hanya untuk perbandingan — / 1K token
Konfigurasigambar masukanJadwal tarif—Jumlah perkiraan—Satuan penagihanper gambar masukanBiaya
Masukan · gambar masukan · Perkiraan hanya untuk perbandingan $0.02 per gambar masukan
KonfigurasiPerkiraan biaya pembuatanJadwal tarif—Jumlah perkiraanestimasi satu kali pembuatanSatuan penagihan—Biaya
Keluaran · Perkiraan biaya pembuatan · Perkiraan hanya untuk perbandingan $0.08 estimasi sebelum pembuatan

Perkiraan ini bukan biaya tambahan maupun tarif tetap untuk proses pembuatan yang telah selesai.

Ailoot mencadangkan perkiraan dana sebelum permintaan. Setelah hasil diterima, tagihan akhir diselesaikan berdasarkan penggunaan yang terukur. Penyelesaian tagihan streaming menggunakan catatan penggunaan akhir. Cara kerja cadangan dan penyelesaian tagihan →

Contoh permintaan

Ailoot Ultra · Gambar

curl
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p={'model': 'x-ai/grok-imagine-image-2.0', 'prompt': 'a red panda astronaut floating in space, studio lighting'}

Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin

def save_images(items):
    if not items: raise SystemExit("No completed images; retain the full response")
    for index, item in enumerate(items):
        encoded=item.get("b64_json")
        uri=item.get("url", "")
        if not encoded and uri.startswith("data:image/"):
            header, separator, encoded=uri.partition(",")
            if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
        if encoded:
            raw=base64.b64decode(encoded,validate=True)
        elif uri:
            uri=urljoin("https://api.ailoot.ai",uri)
            parsed=urlsplit(uri)
            if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
                raise SystemExit("Invalid returned image URL")
            owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
            args=["curl","--fail-with-body","--silent","--show-error",uri]
            if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
            temporary=Path(f"image-{index}.bin")
            subprocess.run(args+["-o",str(temporary)],check=True)
            raw=temporary.read_bytes()
            temporary.unlink()
        else: raise SystemExit("Image has neither bytes nor URL")
        if not raw: raise SystemExit("Empty image result")
        ext="png" if raw.startswith(b"\x89PNG") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"
        Path(f"image-{index}.{ext}").write_bytes(raw)
    print("Every returned image saved; complete response metadata retained")
save_images(json.loads(Path("result.json").read_text())["data"])
PY_RESULT

Terima dan simpan hasil

Ailoot Ultra · Gambar

Unduh setiap gambar yang dikembalikan atau simpan konten Base64-nya

  • GET /v1/media/tasks/{task_id}
  • GET /v1/media/assets/{asset_id}/content
  • GET /v1/media/assets
  • GET /v1/media/assets/{asset_id}
Pembacaan konten lain
Baca aset yang sudah ada dan menjadi milik Anda
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
  -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json
# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.
Simpan semua hasil yang selesai

Simpan setiap gambar yang selesai; ambil setiap URL yang dikembalikan atau dekode konten Base64-nya.

Simpan respons dan header secara lengkap, setiap keluaran aktual, identifikator asli yang dikembalikan, dan semua kolom usage. Pulihkan operasi asli tanpa mengirim ulang permintaan pembuatan.

Jika respons asli perlu diperiksa

Simpan X-Client-Request-ID yang dikembalikan untuk rekonsiliasi. Baca hanya nilai task_id/asset_id yang benar-benar dikembalikan atau pustaka media milik Anda; jangan pernah membuat URL tugas dari ID operasi dan jangan pernah mengirim ulang permintaan pembuatan.

Kolom respons
KolomJenis
KolomcreatedJenis
Kolomdata[].urlJenis
Kolomdata[].b64_jsonJenis
KolomusageJenis

Alias

Alias model

Ailoot Ultra x-ai/grok-imagine-image-2.0

Alias jalur metode

/v1/images

ID pemanggil terkait

x-ai/grok-imagine-image-2.0

FAQ · xAI: Grok Imagine Image 2.0
Input dan hasil apa yang tersedia?

POST /v1/images/generations · x-ai/grok-imagine-image-2.0: text, image → image

Kolom apa yang digunakan permintaan?

POST /v1/images/generations · x-ai/grok-imagine-image-2.0: model, prompt, resolution, aspect_ratio, quality, n, input_references, provider

Batasan apa yang berlaku?

POST /v1/images/generations · x-ai/grok-imagine-image-2.0: n.minimum: 1; n.maximum: 1

Rincian selengkapnya

Hubungkan Ailoot ke Claude Code, OpenCode, Hermes, atau aplikasi Anda.

Perusahaan dan portofolio proyeknya

Perusahaan dan portofolio proyeknya: jutaan pelanggan; penjualan miliaran setiap bulan.

Beli token dengan diskon.

Diskon langganan untuk pekerjaan rutin. Kode promo — hingga 50% untuk pembelian token.

Langganan
Pilih paket dengan diskon untuk permintaan rutin Anda.
Kode promo hingga 50%
Masukkan kode saat membeli. Harga dihitung ulang sesuai promosi aktif.
Biaya dalam riwayat
Model, token, dan jumlah tagihan disimpan untuk setiap permintaan.

Pilih langganan · Lihat harga model

Hubungkan API ke produk yang Anda jual.

SaaS, aplikasi, dan bot — sesuai penawaran dan perjanjian lisensi Ailoot. Untuk penjualan kembali, mintalah lisensi reseller.

Aplikasi komersial
Integrasikan pembuatan teks, gambar, video, dan suara dalam fitur berbayar layanan Anda.
Lisensi reseller
Kirim deskripsi proyek dan skema akses. Mintalah ketentuan penggunaan dan penjualan kembali secara tertulis.
Dokumen di situs
Penawaran, perjanjian lisensi, dan kebijakan pemrosesan data tersedia sebelum koneksi.

Minta lisensi reseller · Penawaran dan perjanjian lisensi