model

Qwen: Qwen Image 3

Markdown · JSON

Qwen: Qwen Image 3

Qwen-Image-3.0 memadukan pembuatan dan penyuntingan gambar untuk tata letak kaya informasi, adegan terperinci, dan tipografi multibahasa. Edisi standar menyeimbangkan kualitas dan kecepatan, dengan masukan berupa arahan teks atau hingga tiga gambar beserta instruksi penyuntingan.

Tentang model

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

Qwen-Image-3.0 adalah model gambar generasi ketiga Qwen, yang menggabungkan pembuatan teks-ke-gambar dan penyuntingan berbasis referensi dalam satu model. Edisi standar menyeimbangkan kualitas gambar dan kecepatan respons, sedangkan Qwen-Image-3.0 Pro merupakan varian unggulan yang berorientasi pada kualitas. Sebuah permintaan menghasilkan gambar: poster, penjelasan berilustrasi, adegan produk, papan cerita, atau foto yang direvisi, bukan dokumen yang dapat disunting atau antarmuka yang berjalan.

Kemampuan kontennya yang kaya cocok untuk kanvas dengan beberapa bagian yang saling berkaitan atau tata letak visual bertingkat. Siapkan judul, kata-kata yang tepat, hierarki, dan hubungan antar-panel sebelum menambahkan detail gaya. Untuk perbandingan produk, arahan yang berguna menentukan tampilan produk utama, atribut yang perlu diberi label, dan urutan baca panel pendukung. Untuk papan cerita, jelaskan subjek, tindakan, dan keterangan setiap panel secara terpisah. Batas maksimum prompt yang disarankan adalah 4.500 token; gunakan ruang tersebut untuk konten dan tata letak yang benar-benar dibutuhkan gambar.

Model ini mendukung tekstur terperinci, tipografi hingga teks kecil yang didemonstrasikan pada ukuran 10 piksel, serta rendering asli dalam 12 bahasa dengan berbagai font dan gaya artistik. Kemampuan tersebut dapat memadukan objek realistis dengan grafis kaya informasi, tanpa harus memilih antara foto dan tata letak yang sarat teks. Berikan kata-kata dan angka yang harus ditampilkan secara tepat, bahasa yang dituju, serta tempat penempatannya. Perlakukan antarmuka yang dihasilkan sebagai mockup visual: tombol, grafik, dan label dalam gambar tidak menjalankan perilaku sebuah aplikasi.

Penyuntingan dapat mengubah teks, menambah atau menghapus objek, memindahkan elemen, menyesuaikan tindakan subjek, menerapkan gaya, atau meningkatkan detail gambar yang rusak. Berikan satu hingga tiga gambar dan satu instruksi penyuntingan yang jelas. Penomoran gambar mengikuti urutan masukan, jadi tentukan gambar mana yang menyumbangkan subjek, mana yang menyediakan pakaian atau objek, dan mana yang menyediakan latar. Untuk adegan produk, minta agar objek dari gambar 1 ditempatkan ke lingkungan gambar 2 sambil mempertahankan ciri yang membedakan produk tersebut. Nyatakan perubahan dan hal-hal yang harus dipertahankan secara eksplisit.

Alur masukan gambar untuk edisi ini menerima JPG, JPEG, PNG, BMP, TIFF, WebP, dan GIF; hanya bingkai pertama GIF animasi yang diproses. Setiap gambar dapat berukuran hingga 10 MB. API saat ini menerima dimensi dari 1 hingga 8.000 piksel dengan rasio sisi panjang terhadap sisi pendek tidak lebih dari 10:1, dan menyarankan 384–2.048 piksel untuk hasil yang baik. Pilih masukan yang memperlihatkan dengan jelas detail yang akan dipindahkan atau disunting. Referensi yang dipotong terlalu rapat dapat menyembunyikan struktur di sekitarnya yang dibutuhkan untuk menempatkan objek secara alami.

Keluarannya berupa PNG, dengan satu hingga enam gambar per permintaan dan satu gambar sebagai nilai bawaan. Luas piksel keluaran berkisar dari 512 × 512 hingga 2.048 × 2.048, dengan rasio aspek antara 1:8 dan 8:1; ini adalah batas luas, bukan aturan bahwa setiap sisi harus paling panjang 2.048 piksel. Jika ukuran tidak diberikan, model menyarankan resolusi berdasarkan prompt. Pilih komposisi lanskap, persegi, atau potret sesuai penggunaan yang dituju, lalu periksa gambar yang dikembalikan pada ukuran sebenarnya agar label kecil dan detail halus dapat dinilai di tempat tampilnya.

Penulisan ulang prompt diaktifkan secara bawaan dalam alur kerja produsen. Peningkatan langsung berlaku untuk pembuatan maupun penyuntingan; peningkatan agen merupakan mode penulisan ulang yang lebih terperinci, hanya untuk teks-ke-gambar, dan ditolak untuk penyuntingan gambar-ke-gambar. Pemikiran diaktifkan secara bawaan, memerlukan penulisan ulang prompt, dan menambah waktu pembuatan. Prompt negatif dapat menjelaskan elemen yang tidak diinginkan, sedangkan seed tetap membantu membandingkan variasi. Nyatakan pengecualian dan persyaratan pelestarian yang tepat dengan jelas, alih-alih mengharapkan seed membuat arahan yang berubah menghasilkan gambar identik.

Untuk memperoleh hasil akhir yang berguna, periksa kata-kata yang dirender, satuan, urutan panel, dan detail yang mengidentifikasi subjek, lalu revisi bagian tertentu yang tidak memenuhi arahan. Respons dengan banyak gambar menyediakan alternatif untuk dibandingkan; simpan hubungan setiap gambar yang dikembalikan dengan prompt dan referensi yang menghasilkannya. Lokasi gambar dari produsen kedaluwarsa setelah 24 jam, jadi simpan aset gambar yang sebenarnya ketika hasilnya menjadi bagian dari proyek. Edisi standar 3.0 tetap berbeda dari Pro maupun model Qwen 2.1 yang memiliki jumlah referensi dan fitur transparansi yang berbeda.

Ailoot Ultra · Gambar POST /v1/images/generations qwen/qwen-image-3

qwen/qwen-image-3

Alibaba /qwen/qwen-image-3

Mulai

Qwen-Image-3.0 memadukan pembuatan dan penyuntingan gambar untuk tata letak kaya informasi, adegan terperinci, dan tipografi multibahasa. Edisi standar menyeimbangkan kualitas dan kecepatan, dengan masukan berupa arahan teks atau hingga tiga gambar beserta instruksi penyuntingan.

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
qwen/qwen-image-3
Bawaan—
KolompromptJenisstringPersyaratanWajibNilai & batasan
Panjang minimum: 1
Bawaan—
KolomresolutionJenisstringPersyaratanOpsionalNilai & batasan
1K, 2K
Bawaan—
Kolomaspect_ratioJenisstringPersyaratanOpsionalNilai & batasan
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
Bawaan—
KolomnJenisintegerPersyaratanOpsionalNilai & batasan
Minimum: 1
Maksimum: 6
Bawaan—
Kolominput_referencesJenisarrayPersyaratanOpsionalNilai & batasan
Item minimum: 0
Item maksimum: 4
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.006 per gambar masukan
KonfigurasiPerkiraan biaya pembuatanJadwal tarif—Jumlah perkiraanestimasi satu kali pembuatanSatuan penagihan—Biaya
Keluaran · Perkiraan biaya pembuatan · Perkiraan hanya untuk perbandingan $0.06 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': '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 · 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 qwen/qwen-image-3

Alias jalur metode

/v1/images

ID pemanggil terkait

qwen/qwen-image-3

FAQ · Qwen: Qwen Image 3
Input dan hasil apa yang tersedia?

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

Kolom apa yang digunakan permintaan?

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

Batasan apa yang berlaku?

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

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