Qwen: Qwen Image 3
Qwen-Image-3.0 ma’lumotga boy maketlar, batafsil sahnalar va ko‘p tilli tipografiya uchun tasvir yaratish va tahrirlashni birlashtiradi. Standart nashr sifat va tezlikni muvozanatlashtiradi; matnli topshiriqni yoki tahrirlash ko‘rsatmasi bilan uchtagacha tasvirni qabul qiladi.
Model haqida
Bu tavsif model imkoniyatlarini yoritadi. Ailoot da tanlangan usul uchun mavjud kirish, chiqish va parametrlar quyida keltirilgan.
Qwen-Image-3.0 — Qwen’ning uchinchi avlod tasvir modeli bo‘lib, matndan tasvir yaratish va namunaga asoslangan tahrirlashni bir modelda birlashtiradi. Standart nashr tasvir sifati va javob tezligini muvozanatlashtiradi, Qwen-Image-3.0 Pro esa sifatga yo‘naltirilgan yetakchi nashrdir. So‘rov natijasi — tasvir: plakat, rasmli tushuntirish, mahsulot sahnasi, kadrlar rejasi yoki qayta ishlangan fotosurat; tahrirlanadigan hujjat yoki ishlaydigan interfeys emas.
Uning boy mazmun yaratish imkoniyatlari o‘zaro bog‘liq bir nechta bo‘limi yoki ichma-ich vizual tuzilishi bor maketga mos. Uslubiy tafsilotlarni qo‘shishdan oldin sarlavhalar, aniq matn, iyerarxiya va panellar o‘rtasidagi munosabatni tayyorlang. Mahsulotlarni taqqoslash uchun foydali topshiriq mahsulotning asosiy ko‘rinishi, belgilanishi kerak bo‘lgan xususiyatlar va qo‘shimcha panellarni o‘qish tartibini ko‘rsatadi. Kadrlar rejasi uchun har bir panelning obyekti, harakati va yozuvini alohida tavsiflang. Prompt uchun tavsiya etilgan eng katta hajm 4 500 token; bu joyni tasvirga haqiqatan kerak bo‘lgan mazmun va joylashuvga sarflang.
Model batafsil teksturalarni, namoyishlarda 10 pikselgacha kichik matnni va turli shriftlar hamda badiiy uslublar bilan 12 tilda bevosita matn tasvirlashni qo‘llaydi. Bu imkoniyatlar fotosurat yoki matni ko‘p maketdan birini tanlashga majbur qilmasdan, realistik obyektni ma’lumotga boy grafika bilan birlashtirishi mumkin. Tasvirlanishi kerak bo‘lgan aniq so‘zlar va raqamlarni, ularning tilini va joyini bering. Yaratilgan interfeysni vizual maket deb qabul qiling: tasvirdagi tugmalar, diagrammalar va yozuvlar ilovaning ishlashini amalga oshirmaydi.
Tahrirlash matnni o‘zgartirishi, obyektlarni qo‘shishi yoki olib tashlashi, elementlarni ko‘chirishi, obyekt harakatini o‘zgartirishi, uslubni ko‘chirishi yoki shikastlangan tasvir tafsilotlarini yaxshilashi mumkin. Birdan uchtagacha tasvir va bitta aniq tahrirlash ko‘rsatmasini bering. Tasvirlar taqdim etilgan tartibda raqamlanadi, shuning uchun qaysi tasvir asosiy obyektni, qaysi biri kiyim yoki buyumni, qaysi biri esa muhitni berishini belgilang. Mahsulot sahnasi uchun 1-tasvirdagi obyektni uning ajralib turadigan xususiyatlarini saqlagan holda 2-tasvirdagi muhitga joylashni so‘rang. O‘zgarishlar va saqlanishi kerak bo‘lgan jihatlarni ochiq ko‘rsating.
Aniq tasvir kiritish jarayoni JPG, JPEG, PNG, BMP, TIFF, WebP va GIF’ni qabul qiladi; animatsiyali GIF’ning faqat birinchi kadri qayta ishlanadi. Har bir tasvir 10 MB gacha bo‘lishi mumkin. Joriy API 1 dan 8 000 pikselgacha o‘lchamlarni, uzun tomonning qisqa tomonga nisbati 10:1 dan oshmasligi sharti bilan qabul qiladi va yaxshi natija uchun 384–2 048 pikselni tavsiya etadi. Ko‘chiriladigan yoki tahrirlanadigan tafsilotlar aniq ko‘rinadigan kirish tasvirini tanlang. Juda tor kesilgan namuna obyektni tabiiy joylashtirish uchun kerak bo‘lgan atrof tuzilishini yashirishi mumkin.
Chiqish PNG formatida bo‘ladi: har bir so‘rov uchun birdan oltitagacha tasvir, standart holatda esa bitta tasvir. Chiqishning piksel maydoni 512 × 512 dan 2 048 × 2 048 gacha, tomonlar nisbati esa 1:8 bilan 8:1 oralig‘ida; bular maydon chegaralari, har bir tomon ko‘pi bilan 2 048 piksel bo‘lishi shart degani emas. O‘lcham berilmasa, model promptdan kelib chiqib rezolyutsiya tavsiya qiladi. Mo‘ljallangan foydalanish uchun gorizontal, kvadrat yoki vertikal kompozitsiyani tanlang, so‘ng kichik yozuvlar va nozik tafsilotlarni ular ko‘rinadigan joyda baholash uchun qaytarilgan tasvirni aynan shu o‘lchamda ko‘ring.
Ishlab chiqaruvchi jarayonida promptni qayta yozish standart holatda yoqilgan. Bevosita yaxshilash yaratish va tahrirlash uchun ishlaydi; agent orqali yaxshilash esa faqat matndan tasvir yaratishga mo‘ljallangan murakkabroq qayta yozish rejimi bo‘lib, tasvirdan tasvirga tahrirlashda rad etiladi. Fikrlash ham standart holatda yoqilgan, promptni qayta yozishni talab qiladi va yaratish vaqtini uzaytiradi. Salbiy promptlar istalmagan elementlarni tavsiflashi mumkin, belgilangan tasodifiy urug‘ qiymati esa variantlarni taqqoslashga yordam beradi. O‘zgarayotgan topshiriqdan urug‘ qiymati bir xil rasm qaytarishini kutish o‘rniga, chiqarib tashlanadigan jihatlar va aniq saqlash talablarini ochiq ayting.
Foydali yakuniy natija uchun tasvirlangan so‘zlar, birliklar, panellar tartibi va obyektni tanitadigan tafsilotlarni tekshiring, so‘ng topshiriqqa mos kelmagan aniq qismni qayta ishlang. Bir nechta tasvirli javob taqqoslash uchun variantlar beradi; har bir qaytarilgan tasvirni uni yaratgan prompt va namunalar bilan bog‘lab saqlang. Ishlab chiqaruvchining tasvir manzillari 24 soatdan keyin amal qilishdan to‘xtaydi, shuning uchun natija loyiha qismiga aylanganda tasvir faylining o‘zini saqlang. Standart 3.0 nashri Pro’dan va namuna soni hamda shaffoflik imkoniyatlari boshqacha bo‘lgan Qwen 2.1 modellaridan alohida bo‘lib qoladi.
Ailoot Ultra · Rasmlar POST /v1/images/generations qwen/qwen-image-3
qwen/qwen-image-3Boshlash
Qwen-Image-3.0 ma’lumotga boy maketlar, batafsil sahnalar va ko‘p tilli tipografiya uchun tasvir yaratish va tahrirlashni birlashtiradi. Standart nashr sifat va tezlikni muvozanatlashtiradi; matnli topshiriqni yoki tahrirlash ko‘rsatmasi bilan uchtagacha tasvirni qabul qiladi.
- 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 |
|---|---|---|---|---|
Maydonmodel | Turstring | TalabMajburiy | Qiymatlar va cheklovlar qwen/qwen-image-3 | Standart— |
Maydonprompt | Turstring | TalabMajburiy | Qiymatlar va cheklovlar Eng kam uzunlik: 1 | Standart— |
Maydonresolution | Turstring | TalabIxtiyoriy | Qiymatlar va cheklovlar 1K, 2K | Standart— |
Maydonaspect_ratio | Turstring | 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— |
Maydonn | Turinteger | TalabIxtiyoriy | Qiymatlar va cheklovlar Eng kam: 1 Eng ko‘p: 6 | Standart— |
Maydoninput_references | Turarray | TalabIxtiyoriy | Qiymatlar va cheklovlar Elementlarning eng kam soni: 0 Elementlarning eng ko‘p soni: 4 | Standart— |
Maydonprovider | Turobject | TalabIxtiyoriy | Qiymatlar va cheklovlar | Standart— |
Usul parametrlari va hayot sikli
| Parametr | Parametr talablari |
|---|---|
Parametrcontent_type | Parametr talablariapplication/json |
Parametrrequired | Parametr talablarimodel, prompt |
Parametrmaterial_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.06 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
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
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}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Boshqa kontentni 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 |
|---|---|
Maydoncreated | Tur |
Maydondata[].url | Tur |
Maydondata[].b64_json | Tur |
Maydonusage | Tur |
Taxalluslar
Model taxalluslari
Ailoot Ultra qwen/qwen-image-3
Usul yo‘llari taxalluslari
/v1/images
Chaqirish uchun tegishli ID lar
FAQ · Qwen: Qwen Image 3
- Qanday kirish ma’lumotlari va natijalar mavjud?
POST /v1/images/generations·qwen/qwen-image-3:text,image→image- So‘rov qaysi maydonlardan foydalanadi?
POST /v1/images/generations·qwen/qwen-image-3:model,prompt,resolution,aspect_ratio,n,input_references,provider- Qanday cheklovlar amal qiladi?
POST /v1/images/generations·qwen/qwen-image-3:n.minimum:1;n.maximum:6