Qwen: Qwen Image 3 Pro
Qwen-Image-3.0 Pro adalah model unggulan Qwen untuk generasi dan penyuntingan gambar dengan tata letak kompleks, detail realistis, dan teks multibahasa. Gunakan arahan yang tepat atau satu hingga tiga referensi untuk membuat grafis, adegan produk, atau suntingan visual terfokus.
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 Pro adalah model unggulan generasi ketiga Qwen untuk generasi dan penyuntingan gambar. Model menggabungkan pembuatan tata letak kompleks, tekstur realistis terperinci, tipografi multibahasa, dan kepatuhan erat pada arahan gambar. Pro dan Qwen-Image-3.0 standar berbagi mode generasi dan penyuntingan yang didokumentasikan; Pro menekankan kualitas gambar, sedangkan edisi standar menyeimbangkan kualitas dan kecepatan. Hasilnya adalah artefak gambar yang dirender.
Untuk grafis kaya informasi, tentukan isi sebelum tampilan: judul utama, teks pendukung, angka, hierarki, dan hubungan antarbagian. Arahan produk yang bermanfaat dapat menggabungkan objek utama, detail bahan dari dekat, dan fitur berlabel pada satu kanvas. Untuk ilustrasi pendidikan, tentukan konsep, struktur diagram, dan keterangan persis, bukan mengandalkan model untuk mengarang fakta dasar. Tata letak kompleks juga dapat menampilkan beberapa panel atau antarmuka bersarang. Jaga prompt dalam batas maksimum yang disarankan 4.500 token tetap terfokus pada hal yang harus muncul dan tempatnya.
Keluarga 3.0 mendukung tipografi asli dalam 12 bahasa, berbagai font, dan lebih dari 100 gaya artistik, bersama tekstur halus seperti rambut, kulit, atau kain. Rendering teks kecil diperagakan hingga 10 piksel. Ini mendukung desain yang memadukan huruf dengan bahan fisik atau menggabungkan teks dengan gambar realistis. Berikan kata-kata, angka, dan bahasa yang tepat serta jelaskan peran tipografi setiap blok. Halaman surat kabar atau mockup antarmuka tetap berupa gambar, sehingga tata letak yang dapat disunting atau perilaku interaktif berikutnya adalah artefak terpisah yang perlu dibangun darinya.
Pro dapat menyunting teks dalam gambar, menambah, menghapus, atau memindahkan elemen, mengubah tindakan subjek, mentransfer gaya visual, dan meningkatkan detail. Penyuntingan menerima satu hingga tiga gambar masukan dengan instruksi. Urutannya menentukan gambar 1, gambar 2, dan gambar 3 dalam arahan. Nyatakan referensi yang memberi identitas subjek, yang menyediakan objek atau pakaian, dan yang menyumbang latar atau pose. Suntingan terfokus menyebut perubahan yang diinginkan serta fitur yang harus tetap utuh, sehingga gambar hasil lebih mudah dibandingkan dengan referensi.
Masukan yang didukung adalah JPG, JPEG, PNG, BMP, TIFF, WebP, dan GIF, dengan hanya bingkai pertama digunakan untuk GIF animasi. Tiap gambar masukan dapat berukuran hingga 10 MB. API khusus ini menerima sisi dari 1 hingga 8.000 piksel dan rasio sisi panjang terhadap sisi pendek tidak lebih dari 10:1; rentang yang disarankan adalah 384–2.048 piksel. Panduan penyuntingan secara terpisah menyarankan gambar hingga 3.072 piksel, sehingga pilihan masukan harus diperlakukan sebagai persiapan untuk detail yang dibutuhkan, bukan janji bahwa setiap resolusi memperbaiki hasil. Gunakan referensi yang terbaca dan dibingkai dengan memadai untuk teks kecil atau karakteristik bahan.
Keluaran berupa PNG. Alur kerja pengembang mengembalikan satu hingga enam alternatif, dengan bawaan satu, dan mendukung luas piksel total dari 512 × 512 hingga 2.048 × 2.048 dengan rasio aspek dari 1:8 hingga 8:1. Anggaran luas piksel memungkinkan sebagian dimensi nonpersegi yang sisi panjangnya melebihi 2.048 piksel. Ketika ukuran tidak ditentukan, model menyarankan resolusi berdasarkan arahan. Pilih bentuk untuk penempatan sebenarnya, lalu bandingkan alternatif yang dihasilkan berdasarkan kelengkapan isi, detail subjek, dan tipografi pada ukuran tampilan yang dituju.
Penulisan ulang prompt cerdas diaktifkan secara bawaan. Peningkatan langsung tersedia untuk generasi dan penyuntingan, sedangkan peningkatan agen memperjelas prompt teks-ke-gambar dan tidak dapat digunakan untuk penyuntingan gambar-ke-gambar. Mode Thinking juga diaktifkan secara bawaan dan memerlukan penulisan ulang prompt; fitur ini menambah pekerjaan penalaran dan waktu generasi. Prompt negatif mengidentifikasi elemen yang tidak diinginkan, dan seed opsional dapat membuat perbandingan varian lebih konsisten. Arahan positif yang jelas sebaiknya tetap menetapkan subjek, komposisi, dan detail yang harus dipertahankan.
Langkah peninjauan hasil yang praktis memeriksa teks persis, angka, urutan baca, kesetiaan pada referensi, serta tepi atau tekstur yang penting bagi desain. Ketika bagian tertentu perlu direvisi, pertahankan komposisi yang berhasil dan jelaskan perubahan terfokus. Simpan semua gambar terpilih bersama prompt dan referensinya karena lokasi keluaran pengembang kedaluwarsa setelah 24 jam. Mode dan batas Pro yang didokumentasikan merupakan milik edisi 3.0; fitur sepuluh referensi dan transparansi asli yang dijelaskan untuk Qwen 2.1 adalah kemampuan edisi yang terpisah.
Ailoot Ultra · Gambar POST /v1/images/generations qwen/qwen-image-3-pro
qwen/qwen-image-3-proMulai
Qwen-Image-3.0 Pro adalah model unggulan Qwen untuk generasi dan penyuntingan gambar dengan tata letak kompleks, detail realistis, dan teks multibahasa. Gunakan arahan yang tepat atau satu hingga tiga referensi untuk membuat grafis, adegan produk, atau suntingan visual terfokus.
- 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 qwen/qwen-image-3-pro | 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, 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— |
Kolomn | Jenisinteger | PersyaratanOpsional | Nilai & batasan Minimum: 1 Maksimum: 6 | Bawaan— |
Kolominput_references | Jenisarray | PersyaratanOpsional | Nilai & batasan Item minimum: 0 Item maksimum: 4 | 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.006 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': 'qwen/qwen-image-3-pro', '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 qwen/qwen-image-3-pro
Alias jalur metode
/v1/images
ID pemanggil terkait
FAQ · Qwen: Qwen Image 3 Pro
- Input dan hasil apa yang tersedia?
POST /v1/images/generations·qwen/qwen-image-3-pro:text,image→image- Kolom apa yang digunakan permintaan?
POST /v1/images/generations·qwen/qwen-image-3-pro:model,prompt,resolution,aspect_ratio,n,input_references,provider- Batasan apa yang berlaku?
POST /v1/images/generations·qwen/qwen-image-3-pro:n.minimum:1;n.maximum:6