Source: https://ailoot.ai/models/ms/qwen-qwen-image-3/
Canonical: https://ailoot.ai/models/ms/qwen-qwen-image-3/
Language: ms

# Qwen: Qwen Image 3

[Markdown](https://ailoot.ai/models/ms/qwen-qwen-image-3/index.md) · [JSON](https://ailoot.ai/models/ms/qwen-qwen-image-3/facts.json)

## [Qwen: Qwen Image 3](https://ailoot.ai/models/ms/qwen-qwen-image-3/)

Qwen-Image-3.0 menggabungkan penjanaan dan penyuntingan imej untuk susun atur yang sarat maklumat, adegan terperinci dan tipografi berbilang bahasa. Edisi standard mengimbangi kualiti dan kelajuan, serta menerima arahan teks atau sehingga tiga imej bersama arahan penyuntingan.

- [**Ailoot Ultra · Imej** `POST /v1/images/generations` `qwen/qwen-image-3`](https://ailoot.ai/models/ms/qwen-qwen-image-3/#method-0)

Tentang model

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

Qwen-Image-3.0 ialah model imej generasi ketiga Qwen yang menggabungkan penciptaan teks-ke-imej dan penyuntingan berasaskan rujukan dalam satu model. Edisi standard mengimbangi kualiti imej dan kelajuan respons, manakala Qwen-Image-3.0 Pro ialah model sekeluarga bertaraf perdana yang berorientasikan kualiti. Satu permintaan menghasilkan imej: poster, penerangan berilustrasi, adegan produk, papan cerita atau foto yang disemak semula, bukannya dokumen yang boleh disunting atau antara muka yang berfungsi.

Keupayaannya menghasilkan kandungan kaya sesuai untuk kanvas dengan beberapa bahagian yang berkaitan atau susun atur visual bersarang. Sediakan tajuk, perkataan yang tepat, hierarki dan hubungan antara panel sebelum menambah butiran gaya. Untuk perbandingan produk, arahan yang berguna menetapkan pandangan utama produk, atribut yang perlu dilabel dan urutan bacaan panel sokongan. Untuk papan cerita, huraikan subjek, aksi dan kapsyen setiap panel secara berasingan. Panjang maksimum prom yang disyorkan ialah 4,500 token; gunakan ruang itu untuk kandungan dan susun atur yang benar-benar diperlukan oleh imej.

Model ini menyokong tekstur terperinci, tipografi hingga teks kecil yang ditunjukkan pada saiz 10 piksel, serta perenderan natif merentas 12 bahasa dengan pelbagai fon dan gaya artistik. Keupayaan tersebut boleh menggabungkan objek realistik dengan grafik yang sarat maklumat, bukannya memaksa pilihan antara foto dengan susun atur yang banyak teks. Berikan perkataan dan angka tepat yang perlu dipaparkan, bahasa yang dimaksudkan serta tempatnya. Anggap antara muka yang dijana sebagai mockup visual: butang, carta dan label dalam imej tidak melaksanakan tingkah laku aplikasi.

Penyuntingan boleh mengubah teks, menambah atau membuang objek, memindahkan elemen, melaraskan aksi subjek, memindahkan gaya atau mempertingkat butiran imej yang rosak. Berikan satu hingga tiga imej dan satu arahan penyuntingan yang jelas. Penomboran imej mengikut urutan yang diberikan, jadi kenal pasti imej yang menyumbangkan subjek, imej yang menyediakan pakaian atau objek dan imej yang menyediakan latar. Untuk adegan produk, minta objek daripada imej 1 diletakkan dalam persekitaran daripada imej 2 sambil mengekalkan ciri yang membezakan produk itu. Nyatakan perubahan dan perkara yang perlu dikekalkan dengan jelas.

Aliran kerja input imej yang khusus ini menerima JPG, JPEG, PNG, BMP, TIFF, WebP dan GIF; hanya bingkai pertama GIF beranimasi diproses. Setiap imej boleh bersaiz sehingga 10 MB. API semasa menerima dimensi dari 1 hingga 8,000 piksel dengan nisbah sisi panjang kepada sisi pendek tidak melebihi 10:1, dan mengesyorkan 384–2,048 piksel untuk hasil yang baik. Pilih input yang jelas menunjukkan butiran yang akan dipindahkan atau disunting. Rujukan yang dipangkas terlalu rapat boleh menyembunyikan struktur sekeliling yang diperlukan untuk meletakkan objek secara semula jadi.

Output ialah PNG, dengan satu hingga enam imej bagi setiap permintaan dan satu imej sebagai tetapan lalai. Luas piksel output berjulat dari 512 × 512 hingga 2,048 × 2,048, dengan nisbah aspek antara 1:8 dan 8:1; ini ialah had luas, bukannya peraturan bahawa setiap sisi mesti tidak melebihi 2,048 piksel. Jika saiz tidak diberikan, model mengesyorkan resolusi berdasarkan prom. Pilih komposisi landskap, segi empat sama atau potret untuk kegunaan yang dimaksudkan, kemudian periksa imej yang dikembalikan pada saiz sebenar itu supaya label kecil dan butiran halus dapat dinilai di tempat ia akan dipaparkan.

Penulisan semula prom diaktifkan secara lalai dalam aliran kerja pengeluar. Penambahbaikan langsung berfungsi untuk penjanaan dan penyuntingan; penambahbaikan berasaskan ejen ialah mod penulisan semula yang lebih terperinci untuk teks-ke-imej sahaja dan ditolak bagi penyuntingan imej-ke-imej. Thinking diaktifkan secara lalai, memerlukan penulisan semula prom dan menambah masa penjanaan. Prom negatif boleh menerangkan elemen yang tidak dikehendaki, manakala seed tetap membantu membandingkan variasi. Nyatakan pengecualian dan perkara tepat yang mesti dikekalkan dengan jelas, bukannya menjangkakan seed akan menghasilkan gambar yang sama apabila arahan berubah.

Untuk artifak akhir yang berguna, periksa perkataan yang dipaparkan, unit, urutan panel dan butiran yang mengenal pasti subjek, kemudian semak semula bahagian tertentu yang tidak menepati arahan. Respons berbilang imej memberikan pilihan untuk dibandingkan; kekalkan perkaitan setiap imej yang dikembalikan dengan prom dan rujukan yang menghasilkannya. Alamat imej pengeluar tamat tempoh selepas 24 jam, jadi simpan aset imej sebenar apabila hasilnya menjadi sebahagian daripada projek. Edisi standard 3.0 kekal berbeza daripada Pro dan model Qwen 2.1 yang mempunyai bilangan rujukan serta ciri ketelusan yang berbeza.

**Ailoot Ultra · Imej** `POST /v1/images/generations` `qwen/qwen-image-3`

[`qwen/qwen-image-3`](https://ailoot.ai/models/ms/#m=qwen%2Fqwen-image-3&route=Ultra&caller=qwen%2Fqwen-image-3&fmt=images)

Alibaba /`qwen/qwen-image-3`

### Pengenalan

Qwen-Image-3.0 menggabungkan penjanaan dan penyuntingan imej untuk susun atur yang sarat maklumat, adegan terperinci dan tipografi berbilang bahasa. Edisi standard mengimbangi kualiti dan kelajuan, serta menerima arahan teks atau sehingga tiga imej bersama arahan penyuntingan.

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 qwen/qwen-image-3 | 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, 1:2, 1:4, 2:1, 2:3, 3:2, 3:4, 4:1, 4:3, 4:5, 5:4, 9:16, 16:9 | Lalai— |
| Medan`n` | Jenis`integer` | KeperluanPilihan | Nilai & had Minimum: 1 Maksimum: 6 | Lalai— |
| Medan`input_references` | Jenis`array` | KeperluanPilihan | Nilai & had Item minimum: 0 Item maksimum: 4 | 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.006** 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.06** 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': 'qwen/qwen-image-3', '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** [`qwen/qwen-image-3`](https://ailoot.ai/models/ms/#m=qwen%2Fqwen-image-3&route=Ultra&caller=qwen%2Fqwen-image-3&fmt=images)

#### Alias laluan kaedah

`/v1/images`

#### ID pemanggil berkaitan

[`qwen/qwen-image-3`](https://ailoot.ai/models/ms/#m=qwen%2Fqwen-image-3&route=Ultra&caller=qwen%2Fqwen-image-3&fmt=images)

FAQ · Qwen: Qwen Image 3

Apakah input dan hasil yang tersedia?

`POST /v1/images/generations` · `qwen/qwen-image-3`: `text`, `image` → `image`

Apakah medan yang digunakan oleh permintaan?

`POST /v1/images/generations` · `qwen/qwen-image-3`: `model`, `prompt`, `resolution`, `aspect_ratio`, `n`, `input_references`, `provider`

Apakah had yang terpakai?

`POST /v1/images/generations` · `qwen/qwen-image-3`: `n.minimum`: `1`; `n.maximum`: `6`

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.
