xAI: Grok Imagine Image 2.0

Grok Imagine Image 2.0 mencipta imej daripada arahan bertulis dan menyunting imej sedia ada melalui arahan bahasa semula jadi. xAI mendokumenkan kualiti, resolusi dan komposisi boleh konfigurasi, rujukan berbilang imej, pemindahan gaya serta penambahbaikan berulang.

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

Tentang model

Huraian ini merangkumi keupayaan model. Input, output dan pilihan yang tersedia di Ailoot disenaraikan di bawah untuk kaedah yang dipilih.

Grok Imagine Image 2.0 ialah model penjanaan dan penyuntingan imej xAI. Ia menerima penerangan bertulis, atau penerangan bersama imej sumber, dan mengembalikan hasil imej. Profil 2.0 bernama pengeluar merangkumi penciptaan adegan, pengubahan imej sedia ada, penggabungan subjek daripada rujukan dan transformasi gaya visual. Mulakan dengan memilih sama ada anda memerlukan komposisi baharu atau perubahan khusus pada bahan yang sudah dimiliki.

Mencipta imej daripada arahan

Huraikan subjek utama, latarnya, komposisi, pencahayaan dan olahan visual. Kenal pasti perkara yang penonton perlu perhatikan dahulu serta tempat imej akan digunakan. Untuk konsep produk, contoh arahan boleh menerangkan lampu meja seramik di atas meja batu pucat, cahaya tingkap lembut, pandangan dekat bahan dan ruang terbuka untuk tajuk berasingan. Untuk ilustrasi, tetapkan watak, tindakan dan estetika dimaksudkan tanpa menjangkakan satu perkataan gaya menentukan keseluruhan adegan.

Pengeluar mendokumenkan satu hingga sepuluh imej output daripada satu permintaan penjanaan, dengan satu sebagai lalai. Beberapa hasil daripada arahan sama memberikan alternatif untuk disemak; ia tidak menjamin subjek serupa dalam setiap variasi. Semak subjek, komposisi dan butiran penting, kemudian simpan versi paling sesuai dengan arahan. Simpan arahan bersama variasi pilihan supaya suntingan kemudian menggunakan komposisi dimaksudkan.

Komposisi, resolusi dan kualiti

Panduan penjanaan mendokumenkan pemilihan nisbah bidang automatik atau nisbah eksplisit. Pilihan disenaraikan termasuk 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 mengikut tempat penggunaan dimaksudkan: segi empat sama untuk jubin padat, potret untuk komposisi menegak atau landskap untuk adegan lebar. Tetapkan subjek sensitif pemotongan dan ruang diperlukan susun atur tanpa bergantung pada nisbah bidang sahaja.

Tetapan resolusi penjanaan yang didokumenkan ialah 1k dan 2k, dengan 1k sebagai lalai. Kualiti ialah kawalan berasingan dengan pilihan low, medium dan auto. Dalam panduan xAI semasa, auto ialah lalai dan menggunakan low untuk penjanaan serta medium untuk penyuntingan; tetapan low atau medium eksplisit menetapkan pilihan itu. Maka resolusi dan kualiti menerangkan kawalan berbeza. Nyatakan butiran visual penting dan periksanya dalam imej dikembalikan tanpa menganggap mana-mana tetapan sebagai jaminan tulisan, geometri atau pemeliharaan subjek tepat.

Menyunting dan memindahkan gaya visual

Berikan imej untuk diubah dan huraikan perubahan diminta berhubung dengan kandungan kelihatannya. Suntingan terarah boleh meminta dinding gelap diganti dengan permukaan plaster cerah sambil mengekalkan susunan perabot, sudut pandangan kamera dan pencahayaan hangat. Jika niatnya transformasi gaya, tetapkan olahan dikehendaki: pengeluar menunjukkan gaya fotografi, anime, lukisan minyak, cat air, seni pop dan lakaran pensel. Kenal pasti unsur yang perlu mengekalkan rupa serta yang boleh berubah mengikut olahan.

Aliran penyuntingan pengeluar menerima rujukan imej sumber, data imej berkod atau pengecam fail. Untuk rujukan tersimpan, gunakan imej PNG, JPEG atau WebP yang telah dimuat naik sepenuhnya. Panduannya turut mendokumenkan suntingan berturutan: gunakan hasil satu suntingan sebagai input berikutnya. Ini boleh menukar komposisi asas menjadi hasil lebih khusus melalui perubahan perabot diikuti pelarasan pencahayaan. Kekalkan imej asal dan imej perantaraan pilihan berkait dengan setiap arahan supaya penambahbaikan kemudian dapat diperiksa terhadap komposisi dimaksudkan.

Menggabungkan berbilang rujukan

Panduan berbilang imej semasa membenarkan sehingga lima imej sumber dalam satu suntingan. Rujuknya mengikut urutan diberikan dan berikan setiap satu peranan jelas, seperti subjek daripada imej pertama dan persekitaran daripada imej kedua. Nisbah output mengikuti imej input pertama secara lalai, dengan nisbah eksplisit tersedia untuk mengatasinya. Untuk konsep produk dalam bilik, huraikan kedudukan, saiz dan sentuhan produk dengan permukaan bilik, kemudian minta butiran pengenalannya dikekalkan. Semak cara sumber digabungkan tanpa menganggap setiap unsur disalin tanpa perubahan.

Menerima dan menyimpan imej

Pengeluar mengembalikan alamat imej sementara secara lalai dan turut mendokumenkan output imej berkod. Simpan imej sebenar segera apabila diperlukan sebagai aset. Aliran tertunda pilihannya memisahkan pengakuan penerimaan permintaan daripada penyelesaian: pengecam permintaan diikuti status pending, done atau failed, dan hasil tertunda menggunakan format respons alamat dengan tempoh pengekalan 24 jam yang didokumenkan. Permintaan dihantar atau status pending bukan imej siap. Simpan imej siap bersama arahan serta tetapan pilihan untuk kegunaan semula kemudian.

Aset akhir berguna ialah imej yang sesuai dengan arahan adegan, susun atur atau suntingan ditetapkan. Periksa keseluruhan komposisi dan butiran kecilnya, khususnya subjek sumber, sempadan objek, perkadaran serta sebarang tulisan yang membawa makna. Untuk kerja berulang, ubah arahan berkait dengan isu kelihatan dan gunakan hasil pilihan sebagai rujukan seterusnya. Pastikan arahan pengubahsuaian dikehendaki serta pemeliharaan konkrit supaya setiap hasil dapat dinilai berdasarkan tujuan kreatif khusus.

Ailoot Ultra · Imej 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

Pengenalan

Input yang diterima: Teks · Imej
Hasil: Imej

Tersedia di Ailoot · input & kaedah

Ailoot Ultra · Imej POST /v1/images/generations

Input: text, image
Output: image

Medan	Jenis	Keperluan	Nilai & had	Lalai
Medan`model`	Jenis`string`	KeperluanDiperlukan	Nilai & had x-ai/grok-imagine-image-2.0	Lalai—
Medan`prompt`	Jenis`string`	KeperluanDiperlukan	Nilai & had Panjang minimum: 1	Lalai—
Medan`resolution`	Jenis`string`	KeperluanPilihan	Nilai & had 1K, 2K	Lalai—
Medan`aspect_ratio`	Jenis`string`	KeperluanPilihan	Nilai & had 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	Lalai—
Medan`quality`	Jenis`string`	KeperluanPilihan	Nilai & had low, medium	Lalai—
Medan`n`	Jenis`integer`	KeperluanPilihan	Nilai & had Minimum: 1 Maksimum: 1	Lalai—
Medan`input_references`	Jenis`array`	KeperluanPilihan	Nilai & had Item minimum: 0 Item maksimum: 3	Lalai—
Medan`provider`	Jenis`object`	KeperluanPilihan	Nilai & had	Lalai—

Parameter kaedah dan kitar hayat

Parameter	Kontrak
Parameter`content_type`	Kontrakapplication/json
Parameter`required`	Kontrakmodel, prompt
Parameter`material_types`	Kontraktext, image

Kitar hayat: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · task_id sebenar yang dikembalikan atau rekod pustaka media

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

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Pelan harga

Cara caj akhir dikira

Kadar yang dipaparkan menganggarkan kos sebelum penjanaan. Caj akhir dikira berdasarkan kos yang direkodkan untuk penjanaan asal. Tempoh output yang diukur dan kuantiti ramalan bukan kuantiti akhir yang boleh dibilkan.

Rujukan tarif tidak menambah pilihan permintaan. Parameter yang disokong disenaraikan untuk kaedah yang dipilih.

Mod pantas: Tidak dinyatakan Apabila mod pantas dipilih
Mod flex: Tidak dinyatakan Apabila mod flex dipilih
Usaha penaakulan maksimum: Tidak dinyatakan Apabila usaha penaakulan maksimum menggunakan pelarasan default

Anggaran kadar untuk perbandingan

Harga mengikut konfigurasi

Padankan setiap caj dengan syarat yang dipaparkan. Gunakan satu kadar bagi setiap set konfigurasi alternatif.

Konfigurasi	Jadual kadar	Kuantiti ramalan	Unit pengebilan	Caj
KonfigurasiKadar asas token	Jadual kadarKadar asas	Kuantiti ramalan—	Unit pengebilan—	Caj Input · Token input · Anggaran untuk perbandingan sahaja — / 1K token Output · Token output · Anggaran untuk perbandingan sahaja — / 1K token Input · Bacaan cache · Anggaran untuk perbandingan sahaja — / 1K token Input · Penulisan cache · Anggaran untuk perbandingan sahaja — / 1K token Input · Penulisan cache, 1 jam · Anggaran untuk perbandingan sahaja — / 1K token
Konfigurasiimej input	Jadual kadar—	Kuantiti ramalan—	Unit pengebilanbagi setiap imej masukan	Caj Input · imej input · Anggaran untuk perbandingan sahaja $0.02 bagi setiap imej masukan
KonfigurasiAnggaran kos penjanaan	Jadual kadar—	Kuantiti ramalananggaran untuk satu penjanaan	Unit pengebilan—	Caj Output · Anggaran kos penjanaan · Anggaran untuk perbandingan sahaja $0.08 anggaran sebelum penjanaan Anggaran ini bukan caj tambahan atau kadar tetap bagi penjanaan yang telah selesai.

Ailoot merizabkan anggaran amaun sebelum permintaan. Selepas hasil diterima, caj akhir diselesaikan berdasarkan penggunaan terukur. Penyelesaian caj penstriman menggunakan rekod penggunaan akhir. Cara rizab dan penyelesaian caj berfungsi →

Contoh permintaan

Ailoot Ultra · Imej

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 · Imej

Muat turun setiap imej yang dikembalikan atau simpan kandungan 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 kandungan lain

Baca aset sedia ada yang 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 imej yang selesai; dapatkan setiap URL yang dikembalikan atau nyahkod kandungan Base64-nya.

Simpan respons dan pengepala yang lengkap, setiap output sebenar, pengecam asal yang dikembalikan serta semua medan penggunaan. Pulihkan operasi asal tanpa menghantar permintaan penciptaan sekali lagi.

Jika respons asal perlu disemak

Simpan X-Client-Request-ID yang dikembalikan untuk penyelarasan rekod. Baca hanya nilai task_id/asset_id sebenar yang dikembalikan atau pustaka media milik anda; jangan sekali-kali bina URL tugas daripada ID operasi atau hantar semula permintaan penciptaan.

Medan respons

Medan	Jenis
Medan`created`	Jenis
Medan`data[].url`	Jenis
Medan`data[].b64_json`	Jenis
Medan`usage`	Jenis

Alias

Alias model

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

Alias laluan kaedah

/v1/images

ID pemanggil berkaitan

x-ai/grok-imagine-image-2.0

FAQ · xAI: Grok Imagine Image 2.0

Apakah input dan hasil yang tersedia?: POST /v1/images/generations · x-ai/grok-imagine-image-2.0: text, image → image
Apakah medan yang digunakan oleh permintaan?: POST /v1/images/generations · x-ai/grok-imagine-image-2.0: model, prompt, resolution, aspect_ratio, quality, n, input_references, provider
Apakah had yang terpakai?: POST /v1/images/generations · x-ai/grok-imagine-image-2.0: n.minimum: 1; n.maximum: 1

xAI: Grok Imagine Image 2.0