Qwen: Qwen Image 3 Pro

Qwen-Image-3.0 Pro ialah model utama Qwen untuk penjanaan dan penyuntingan imej dengan susun atur kompleks, butiran realistik dan teks berbilang bahasa. Gunakan taklimat tepat atau satu hingga tiga rujukan untuk mencipta grafik, adegan produk atau suntingan visual terfokus.

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

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 Pro ialah model utama generasi ketiga Qwen untuk penjanaan dan penyuntingan imej. Model menggabungkan penciptaan susun atur kompleks, tekstur realistik terperinci, tipografi berbilang bahasa dan pematuhan rapat kepada taklimat imej. Pro dan Qwen-Image-3.0 standard berkongsi mod penjanaan dan penyuntingan yang didokumenkan; Pro menekankan kualiti imej, manakala edisi standard mengimbangi kualiti dan kelajuan. Hasilnya ialah artifak imej yang dirender.

Untuk grafik kaya maklumat, tentukan kandungan sebelum rupa: tajuk utama, teks sokongan, angka, hierarki dan hubungan antara bahagian. Taklimat produk yang berguna boleh menggabungkan objek utama, butiran bahan jarak dekat dan ciri berlabel pada satu kanvas. Untuk ilustrasi pendidikan, kenal pasti konsep, struktur rajah dan kapsyen yang tepat, bukannya bergantung pada model untuk mencipta fakta asas. Susun atur kompleks juga boleh menunjukkan beberapa panel atau antara muka bersarang. Pastikan prom dengan maksimum 4,500 token yang disyorkan tertumpu pada perkara yang mesti muncul dan tempatnya.

Keluarga 3.0 menyokong tipografi natif dalam 12 bahasa, pelbagai fon dan lebih daripada 100 gaya seni, bersama tekstur halus seperti rambut, kulit atau fabrik. Rendering teks kecil ditunjukkan sehingga 10 piksel. Ini menyokong reka bentuk yang menggabungkan huruf dengan bahan fizikal atau teks dengan imej realistik. Berikan perkataan, angka dan bahasa yang tepat, serta terangkan peranan tipografi setiap blok. Halaman akhbar atau mockup antara muka masih berupa gambar, maka susun atur yang boleh disunting atau tingkah laku interaktif kemudian ialah artifak berasingan yang perlu dibina daripadanya.

Pro boleh menyunting teks dalam imej, menambah, memadam atau memindahkan elemen, mengubah tindakan subjek, memindahkan gaya visual dan meningkatkan butiran. Penyuntingan menerima satu hingga tiga imej input dengan arahan. Turutannya menentukan imej 1, imej 2 dan imej 3 dalam taklimat. Nyatakan rujukan yang membekalkan identiti subjek, yang menyediakan objek atau pakaian dan yang memberikan latar atau pose. Suntingan terfokus menamakan perubahan yang dimaksudkan serta ciri yang perlu kekal, menjadikan imej hasil lebih mudah dibandingkan dengan rujukan.

Input yang disokong ialah JPG, JPEG, PNG, BMP, TIFF, WebP dan GIF, dengan hanya bingkai pertama digunakan untuk GIF beranimasi. Setiap imej input boleh berukuran sehingga 10 MB. API khusus ini menerima sisi dari 1 hingga 8,000 piksel dan nisbah sisi panjang kepada sisi pendek tidak melebihi 10:1; julat yang disyorkan ialah 384–2,048 piksel. Panduan penyuntingan secara berasingan mengesyorkan imej sehingga 3,072 piksel, maka anggap pilihan input sebagai persediaan untuk butiran yang diperlukan, bukannya janji bahawa setiap resolusi meningkatkan hasil. Gunakan rujukan yang boleh dibaca dan dibingkaikan secukupnya untuk teks kecil atau ciri bahan.

Output ialah PNG. Aliran kerja pengeluar mengembalikan satu hingga enam alternatif, dengan nilai lalai satu, serta menyokong jumlah keluasan piksel dari 512 × 512 hingga 2,048 × 2,048 dan nisbah aspek dari 1:8 hingga 8:1. Bajet keluasan piksel membenarkan sesetengah dimensi bukan segi empat sama yang sisi panjangnya melebihi 2,048 piksel. Apabila saiz tidak ditentukan, model mengesyorkan resolusi berdasarkan taklimat. Pilih bentuk untuk penempatan sebenar, kemudian bandingkan alternatif yang dijana dari segi kelengkapan kandungan, butiran subjek dan tipografi pada saiz paparan yang dimaksudkan.

Penulisan semula prom pintar diaktifkan secara lalai. Penambahbaikan langsung tersedia untuk penjanaan dan penyuntingan, manakala penambahbaikan ejen memperhalus prom teks-ke-imej dan tidak boleh digunakan untuk penyuntingan imej-ke-imej. Mod Thinking turut diaktifkan secara lalai dan memerlukan penulisan semula prom; ia menambah kerja penaakulan serta masa penjanaan. Prom negatif mengenal pasti elemen yang tidak diingini, dan seed pilihan boleh membantu menjadikan perbandingan antara varian lebih konsisten. Taklimat positif yang jelas masih disarankan untuk menentukan subjek, komposisi dan butiran untuk dikekalkan.

Langkah semakan hasil yang praktikal menyemak teks tepat, nombor, turutan bacaan, kesetiaan kepada rujukan serta tepi atau tekstur yang penting bagi reka bentuk. Apabila bahagian tertentu perlu disemak semula, kekalkan komposisi yang berjaya dan terangkan perubahan terfokus. Simpan semua imej terpilih dengan prom dan rujukannya kerana lokasi output pengeluar tamat tempoh selepas 24 jam. Mod dan had Pro yang didokumenkan adalah milik edisi 3.0; ciri sepuluh rujukan dan ketelusan natif yang diterangkan untuk Qwen 2.1 ialah keupayaan edisi berasingan.

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

qwen/qwen-image-3-pro

Alibaba /qwen/qwen-image-3-pro

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 qwen/qwen-image-3-pro	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.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': '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 · 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 qwen/qwen-image-3-pro

Alias laluan kaedah

/v1/images

ID pemanggil berkaitan

qwen/qwen-image-3-pro

FAQ · Qwen: Qwen Image 3 Pro

Apakah input dan hasil yang tersedia?: POST /v1/images/generations · qwen/qwen-image-3-pro: text, image → image
Apakah medan yang digunakan oleh permintaan?: POST /v1/images/generations · qwen/qwen-image-3-pro: model, prompt, resolution, aspect_ratio, n, input_references, provider
Apakah had yang terpakai?: POST /v1/images/generations · qwen/qwen-image-3-pro: n.minimum: 1; n.maximum: 6

Qwen: Qwen Image 3 Pro