Qwen: Qwen Image 3 Pro

Qwen-Image-3.0 Pro — Qwen’ning murakkab joylashuvlar, realistik tafsilotlar va ko‘p tilli matn uchun yetakchi rasm yaratish hamda tahrirlash modeli. Grafika, mahsulot sahnasi yoki aniq vizual tahrir yaratish uchun ravshan topshiriq yoki bittadan uchtagacha namunadan foydalaning.

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

Model haqida

Bu tavsif model imkoniyatlarini yoritadi. Ailoot da tanlangan usul uchun mavjud kirish, chiqish va parametrlar quyida keltirilgan.

Qwen-Image-3.0 Pro — Qwen’ning rasm yaratish va tahrirlash uchun uchinchi avlod yetakchi modeli. U murakkab joylashuv yaratish, batafsil realistik teksturalar, ko‘p tilli tipografiya va rasm topshirig‘iga yaqin rioya qilishni birlashtiradi. Pro va standart Qwen-Image-3.0 hujjatlashtirilgan yaratish va tahrirlash rejimlarini bo‘lishadi; Pro rasm sifatiga urg‘u beradi, standart versiya esa sifat va tezlikni muvozanatlashtiradi. Natija renderlangan rasm artefaktidir.

Ma’lumotga boy grafika uchun ko‘rinishdan oldin mazmunni belgilang: asosiy sarlavha, yordamchi matn, raqamlar, iyerarxiya va bo‘limlar o‘rtasidagi aloqa. Foydali mahsulot topshirig‘i bitta sahifada asosiy obyekt, materialning yaqin tafsilotlari va belgilangan xususiyatlarni birlashtirishi mumkin. Ta’limiy rasm uchun asosiy faktlarni model o‘ylab topishiga tayanmay, tushuncha, diagramma tuzilishi va aniq yozuvlarni belgilang. Murakkab joylashuvlar bir nechta panel yoki ichma-ich interfeyslarni ham ko‘rsatishi mumkin. Tavsiya etilgan eng ko‘p 4 500 tokenli yo‘riqnomani nima paydo bo‘lishi va qayerga joylashishi kerakligiga qarating.

3.0 oilasi 12 tilda tabiiy tipografiya, bir nechta shrift va 100 dan ortiq badiiy uslub, shuningdek, soch, teri yoki mato kabi nozik teksturalarni qo‘llab-quvvatlaydi. Kichik matnni renderlash 10 pikselgacha namoyish etilgan. Bu harflarni jismoniy material bilan uyg‘unlashtiradigan yoki matnni realistik tasvir bilan birlashtiradigan dizaynni qo‘llaydi. Aniq matn, raqamlar va tilni bering, har bir blokning tipografik rolini tushuntiring. Gazeta sahifasi yoki interfeys maketi hamon rasmdir; keyingi tahrirlanuvchi joylashuv yoki interaktiv xatti-harakat undan yaratiladigan alohida artefaktdir.

Pro rasm ichidagi matnni tahrirlashi, element qo‘shishi, o‘chirishi yoki ko‘chirishi, subyekt harakatini o‘zgartirishi, vizual uslubni ko‘chirishi va tafsilotlarni yaxshilashi mumkin. Tahrirlash yo‘riqnoma bilan birga bittadan uchtagacha kirish rasmini qabul qiladi. Ularning tartibi topshiriqdagi rasm 1, rasm 2 va rasm 3 ni belgilaydi. Qaysi namuna subyektning kimligini, qaysi biri buyum yoki kiyimni, qaysi biri muhit yoki holatni berishini ko‘rsating. Aniq tahrir istalgan o‘zgarishni ham, saqlanishi kerak bo‘lgan xususiyatlarni ham aytadi va natijani namunalar bilan taqqoslashni osonlashtiradi.

Qo‘llab-quvvatlanadigan kirishlar JPG, JPEG, PNG, BMP, TIFF, WebP va GIF; animatsiyali GIF uchun faqat birinchi kadr ishlatiladi. Har bir kirish rasmi 10 MB gacha bo‘lishi mumkin. Aynan shu API tomonlarni 1 dan 8 000 pikselgacha va uzun-qisqa tomon nisbatini ko‘pi bilan 10:1 qabul qiladi; tavsiya etilgan oralig‘i 384–2 048 piksel. Tahrirlash qo‘llanmasi alohida ravishda 3 072 pikselgacha rasmlarni tavsiya etadi, shuning uchun kirish tanlovini har qanday aniqlik natijani yaxshilashi haqidagi va’da emas, kerakli tafsilotga tayyorgarlik deb biling. Mayda matn yoki material xususiyatlari uchun o‘qiladigan, yetarlicha to‘g‘ri kadrga olingan namunadan foydalaning.

Chiqishlar PNG. Ishlab chiqaruvchi jarayoni bittadan oltitagacha variantni qaytaradi, standart qiymat bitta; umumiy piksel maydoni 512 × 512 dan 2 048 × 2 048 gacha, tomonlar nisbati esa 1:8 dan 8:1 gacha qo‘llab-quvvatlanadi. Piksel maydoni budjeti uzun tomoni 2 048 pikseldan oshadigan ayrim kvadrat bo‘lmagan o‘lchamlarga imkon beradi. O‘lcham belgilanmasa, model topshiriq asosida aniqlikni tavsiya qiladi. Haqiqiy joylashtirishga mos shaklni tanlab, yaratilgan variantlarni mazmunning to‘liqligi, subyekt tafsilotlari va tipografiya bo‘yicha mo‘ljallangan ko‘rsatish hajmida taqqoslang.

Aqlli yo‘riqnoma qayta yozish standart holatda yoqilgan. Bevosita yaxshilash yaratish va tahrirlash uchun mavjud, agent orqali yaxshilash esa matndan rasm yo‘riqnomalarini aniqlashtiradi va rasmdan rasm tahririda ishlatilmaydi. Thinking rejimi ham standart holatda yoqilgan va yo‘riqnoma qayta yozishni talab qiladi; u qo‘shimcha mulohaza va yaratish vaqtini qo‘shadi. Salbiy yo‘riqnomalar nomaqbul elementlarni belgilaydi, ixtiyoriy seed esa variantlar orasidagi taqqoslashni izchilroq qilishi mumkin. Aniq ijobiy topshiriq baribir subyekt, kompozitsiya va saqlanadigan tafsilotlarni belgilashi kerak.

Amaliy natijani ko‘rib chiqish bosqichi aniq matn, raqamlar, o‘qish tartibi, namunaga moslik va dizayn uchun muhim chetlar yoki teksturalarni tekshiradi. Muayyan qism qayta ishlashni talab qilsa, muvaffaqiyatli kompozitsiyani saqlab, aniq o‘zgarishni bayon qiling. Barcha tanlangan rasmlarni yo‘riqnoma va namunalar bilan birga saqlang, chunki ishlab chiqaruvchining chiqish manzillari 24 soatdan keyin amal qilmaydi. Pro’ning hujjatlashtirilgan rejim va limitlari 3.0 versiyasiga tegishli; Qwen 2.1 uchun bayon qilingan o‘nta namuna va tabiiy shaffoflik imkoniyatlari boshqa versiyaga xosdir.

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

qwen/qwen-image-3-pro

Alibaba /qwen/qwen-image-3-pro

Boshlash

Qabul qilinadigan kirish ma’lumotlari: Matn · Rasmlar
Natijalar: Rasmlar

Ailoot da mavjud · kirish ma’lumotlari va usullar

Ailoot Ultra · Rasmlar POST /v1/images/generations

Kirish: text, image
Chiqish: image

Maydon	Tur	Talab	Qiymatlar va cheklovlar	Standart
Maydon`model`	Tur`string`	TalabMajburiy	Qiymatlar va cheklovlar qwen/qwen-image-3-pro	Standart—
Maydon`prompt`	Tur`string`	TalabMajburiy	Qiymatlar va cheklovlar Eng kam uzunlik: 1	Standart—
Maydon`resolution`	Tur`string`	TalabIxtiyoriy	Qiymatlar va cheklovlar 1K, 2K	Standart—
Maydon`aspect_ratio`	Tur`string`	TalabIxtiyoriy	Qiymatlar va cheklovlar 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	Standart—
Maydon`n`	Tur`integer`	TalabIxtiyoriy	Qiymatlar va cheklovlar Eng kam: 1 Eng ko‘p: 6	Standart—
Maydon`input_references`	Tur`array`	TalabIxtiyoriy	Qiymatlar va cheklovlar Elementlarning eng kam soni: 0 Elementlarning eng ko‘p soni: 4	Standart—
Maydon`provider`	Tur`object`	TalabIxtiyoriy	Qiymatlar va cheklovlar	Standart—

Usul parametrlari va hayot sikli

Parametr	Parametr talablari
Parametr`content_type`	Parametr talablariapplication/json
Parametr`required`	Parametr talablarimodel, prompt
Parametr`material_types`	Parametr talablaritext, image

Hayot sikli: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · Amalda qaytarilgan task_id yoki media kutubxonasidagi yozuv

GET /v1/media/assets/{asset_id}/content

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Tariflar

Yakuniy to‘lov qanday hisoblanadi

Ko‘rsatilgan tariflar xarajatni generatsiyadan oldin taxminiy hisoblash uchun xizmat qiladi. Yakuniy to‘lov dastlabki generatsiya uchun qayd etilgan xarajat asosida hisoblanadi. Natijaning o‘lchangan davomiyligi va oldindan taxmin qilingan miqdorlar haq undiriladigan yakuniy miqdor hisoblanmaydi.

Tarif ma’lumotlari so‘rov imkoniyatlarini qo‘shmaydi. Qo‘llab-quvvatlanadigan parametrlar tanlangan usulda ko‘rsatilgan.

Tezkor rejim: Ko‘rsatilmagan Tezkor rejim tanlanganda
Flex rejimi: Ko‘rsatilmagan flex rejimi tanlanganda
Maksimal fikrlash darajasi: Ko‘rsatilmagan Maksimal fikrlash darajasi uchun standart (default) tuzatish qo‘llanganda

Taqqoslash uchun taxminiy tariflar

Sozlamalar bo‘yicha narxlar

Har bir to‘lovni ko‘rsatilgan shartlarga moslang. Har bir muqobil sozlamalar to‘plami uchun bitta tarifdan foydalaning.

Sozlama	Tariflar jadvali	Prognoz miqdori	Hisob birligi	To‘lov
SozlamaTokenlar uchun bazaviy tariflar	Tariflar jadvaliAsosiy tarif	Prognoz miqdori—	Hisob birligi—	To‘lov Kirish · Kirish tokenlari · Faqat taqqoslash uchun taxmin — / 1K token Chiqish · Chiqish tokenlari · Faqat taqqoslash uchun taxmin — / 1K token Kirish · Keshdan o‘qish · Faqat taqqoslash uchun taxmin — / 1K token Kirish · Keshga yozish · Faqat taqqoslash uchun taxmin — / 1K token Kirish · Keshga yozish, 1 soat · Faqat taqqoslash uchun taxmin — / 1K token
Sozlamakirish rasmi	Tariflar jadvali—	Prognoz miqdori—	Hisob birligikirish rasmi uchun	To‘lov Kirish · kirish rasmi · Faqat taqqoslash uchun taxmin $0.006 kirish rasmi uchun
SozlamaYaratishning taxminiy qiymati	Tariflar jadvali—	Prognoz miqdoribir generatsiya uchun taxmin	Hisob birligi—	To‘lov Chiqish · Yaratishning taxminiy narxi · Faqat taqqoslash uchun taxmin $0.08 yaratishdan oldingi taxmin Bu taxmin qo‘shimcha to‘lov ham, tugallangan generatsiya uchun qat’iy tarif ham emas.

Ailoot so‘rovdan oldin taxminiy summani band qiladi. Natijadan keyin o‘lchangan sarf asosidagi yakuniy to‘lovni yechadi. Oqimli javob bo‘yicha yakuniy hisob-kitob yakuniy sarf yozuviga asoslanadi. Summani band qilish va to‘lovni hisoblash tartibi →

So‘rov namunalari

Ailoot Ultra · Rasmlar

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

Natijalarni olish va saqlash

Ailoot Ultra · Rasmlar

Har bir qaytarilgan rasmni yuklab oling yoki uning Base64 kontentini saqlang

GET /v1/media/tasks/{task_id}
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}

Boshqa kontentni o‘qish

O‘zingizga tegishli mavjud materiallarni o‘qish

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.

Barcha tayyor natijalarni saqlash

Har bir tayyor rasmni saqlang; har bir qaytarilgan URL dan kontentni oling yoki uning Base64 kontentini dekodlang.

To‘liq javob va sarlavhalarni, amalda qaytarilgan barcha natijalarni, dastlab qaytarilgan identifikatorlarni hamda barcha usage maydonlarini saqlang. Yaratish so‘rovini qayta yubormasdan dastlabki operatsiyani tiklang.

Asl javobni tekshirish kerak bo‘lsa

Qaytarilgan X-Client-Request-ID ni ma’lumotlarni solishtirib tekshirish uchun saqlang. Faqat amalda qaytarilgan task_id/asset_id qiymatlari bo‘yicha yoki o‘zingizga tegishli media kutubxonasidan ma’lumot o‘qing; operatsiya ID sidan vazifa URL manzilini hech qachon tuzmang va yaratish so‘rovini qayta yubormang.

Javob maydonlari

Maydon	Tur
Maydon`created`	Tur
Maydon`data[].url`	Tur
Maydon`data[].b64_json`	Tur
Maydon`usage`	Tur

Taxalluslar

Model taxalluslari

Ailoot Ultra qwen/qwen-image-3-pro

Usul yo‘llari taxalluslari

/v1/images

Chaqirish uchun tegishli ID lar

qwen/qwen-image-3-pro

FAQ · Qwen: Qwen Image 3 Pro

Qanday kirish ma’lumotlari va natijalar mavjud?: POST /v1/images/generations · qwen/qwen-image-3-pro: text, image → image
So‘rov qaysi maydonlardan foydalanadi?: POST /v1/images/generations · qwen/qwen-image-3-pro: model, prompt, resolution, aspect_ratio, n, input_references, provider
Qanday cheklovlar amal qiladi?: POST /v1/images/generations · qwen/qwen-image-3-pro: n.minimum: 1; n.maximum: 6

Qwen: Qwen Image 3 Pro