Source: https://ailoot.ai/models/ms/x-ai-grok-imagine-image-2-0/
Canonical: https://ailoot.ai/models/ms/x-ai-grok-imagine-image-2-0/
Language: ms

# xAI: Grok Imagine Image 2.0

[Markdown](https://ailoot.ai/models/ms/x-ai-grok-imagine-image-2-0/index.md) · [JSON](https://ailoot.ai/models/ms/x-ai-grok-imagine-image-2-0/facts.json)

## [xAI: Grok Imagine Image 2.0](https://ailoot.ai/models/ms/x-ai-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`](https://ailoot.ai/models/ms/x-ai-grok-imagine-image-2-0/#method-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`](https://ailoot.ai/models/ms/#m=x-ai%2Fgrok-imagine-image-2.0&route=Ultra&caller=x-ai%2Fgrok-imagine-image-2.0&fmt=images)

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

### Pengenalan

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.

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 →](https://ailoot.ai/docs/ms/billing/reserve/)

### Contoh permintaan

#### Ailoot Ultra · Imej

curl

```bash
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

```bash
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`](https://ailoot.ai/models/ms/#m=x-ai%2Fgrok-imagine-image-2.0&route=Ultra&caller=x-ai%2Fgrok-imagine-image-2.0&fmt=images)

#### Alias laluan kaedah

`/v1/images`

#### ID pemanggil berkaitan

[`x-ai/grok-imagine-image-2.0`](https://ailoot.ai/models/ms/#m=x-ai%2Fgrok-imagine-image-2.0&route=Ultra&caller=x-ai%2Fgrok-imagine-image-2.0&fmt=images)

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`

Sambungkan Ailoot kepada Claude Code, OpenCode, Hermes atau aplikasi anda.

## Syarikat dan portfolio projeknya

Syarikat dan portfolio projeknya: jutaan pelanggan; jualan bernilai berbilion setiap bulan.

## Beli token dengan diskaun.

Diskaun langganan untuk penggunaan berkala. Kod promosi — sehingga 50% bagi pembelian token.

Langganan

Pilih pelan berdiskaun untuk permintaan berkala anda.

Kod promosi sehingga 50%

Masukkan kod semasa pembelian. Harga dikira semula mengikut promosi semasa.

Perbelanjaan dalam sejarah

Model, token dan jumlah disimpan bagi setiap permintaan.

[Pilih langganan](https://ailoot.ai/docs/ms/billing/subscriptions/) · [Lihat harga model](https://ailoot.ai/models/ms/)

## Sambungkan API kepada produk yang anda jual.

SaaS, aplikasi dan bot — di bawah tawaran rasmi serta perjanjian lesen Ailoot. Untuk jualan semula, mohon lesen penjual semula.

Aplikasi komersial

Tambahkan penjanaan teks, imej, video dan audio pada ciri berbayar perkhidmatan anda.

Lesen penjual semula

Hantar keterangan projek dan susunan akses. Minta terma penggunaan serta jualan semula secara bertulis.

Dokumen pada laman

Tawaran, perjanjian lesen dan dasar pemprosesan data tersedia sebelum sambungan.

[Mohon lesen penjual semula](mailto:support@ailoot.ai) · [Tawaran dan perjanjian lesen](https://ailoot.ai/legal/offer?lang=ms)

## Ailoot · Syarikat dan portfolio projeknya





Ailoot berteraskan pengalaman operasi yang mantap, pangkalan pelanggan yang besar, perkhidmatan yang stabil dan pemantauan KPI berterusan.





Syarikat dan portfolio projeknya: jutaan pelanggan; jualan bernilai berbilion setiap bulan.





Ailoot menggunakan pengalaman operasi ini untuk akses API kepada ciri AI dalam produk pelanggan, ejen, aplikasi dan automasi.
