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.0Mulai
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
| Kolom | Jenis | Persyaratan | Nilai & batasan | Bawaan |
|---|---|---|---|---|
Kolommodel | Jenisstring | PersyaratanWajib | Nilai & batasan x-ai/grok-imagine-image-2.0 | Bawaan— |
Kolomprompt | Jenisstring | PersyaratanWajib | Nilai & batasan Panjang minimum: 1 | Bawaan— |
Kolomresolution | Jenisstring | PersyaratanOpsional | Nilai & batasan 1K, 2K | Bawaan— |
Kolomaspect_ratio | Jenisstring | PersyaratanOpsional | Nilai & 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— |
Kolomquality | Jenisstring | PersyaratanOpsional | Nilai & batasan low, medium | Bawaan— |
Kolomn | Jenisinteger | PersyaratanOpsional | Nilai & batasan Minimum: 1 Maksimum: 1 | Bawaan— |
Kolominput_references | Jenisarray | PersyaratanOpsional | Nilai & batasan Item minimum: 0 Item maksimum: 3 | Bawaan— |
Kolomprovider | Jenisobject | PersyaratanOpsional | Nilai & batasan | Bawaan— |
Parameter metode dan siklus hidup
| Parameter | Kontrak |
|---|---|
Parametercontent_type | Kontrakapplication/json |
Parameterrequired | Kontrakmodel, prompt |
Parametermaterial_types | Kontraktext, 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.
| Konfigurasi | Jadwal tarif | Jumlah perkiraan | Satuan penagihan | Biaya |
|---|---|---|---|---|
| KonfigurasiTarif dasar token | Jadwal tarifTarif dasar | Jumlah 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 masukan | Jadwal tarif— | Jumlah perkiraan— | Satuan penagihanper gambar masukan | Biaya Masukan · gambar masukan · Perkiraan hanya untuk perbandingan $0.02 per gambar masukan |
| KonfigurasiPerkiraan biaya pembuatan | Jadwal tarif— | Jumlah perkiraanestimasi satu kali pembuatan | Satuan 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
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}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Pembacaan konten lain
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
| Kolom | Jenis |
|---|---|
Kolomcreated | Jenis |
Kolomdata[].url | Jenis |
Kolomdata[].b64_json | Jenis |
Kolomusage | Jenis |
Alias
Alias model
Ailoot Ultra x-ai/grok-imagine-image-2.0
Alias jalur metode
/v1/images
ID pemanggil terkait
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