Qwen: Qwen Image 3 Pro

A Qwen-Image-3.0 Pro a Qwen zászlóshajója képgeneráláshoz és szerkesztéshez, összetett elrendezésekhez, élethű részletekhez és többnyelvű szöveghez. Pontos feladatleírással vagy egy–három referenciával készíts grafikát, termékjelenetet vagy célzott vizuális módosítást.

Ailoot Ultra · Képek POST /v1/images/generations qwen/qwen-image-3-pro

A modellről

Ez a leírás a modell képességeit ismerteti. Az Ailootban elérhető bemenetek, kimenetek és lehetőségek alább, a kiválasztott metódusnál láthatók.

A Qwen-Image-3.0 Pro a Qwen harmadik generációs zászlóshajó-modellje képgeneráláshoz és szerkesztéshez. Összetett elrendezéseket, részletes élethű textúrákat, többnyelvű tipográfiát és a képfeladatleírás pontos követését egyesíti. A Pro és a szokásos Qwen-Image-3.0 közös dokumentált generálási és szerkesztési módokat használ; a Pro a képminőséget hangsúlyozza, a standard verzió pedig a minőséget és sebességet egyensúlyozza. Az eredmény renderelt kép.

Információgazdag grafikánál a tartalmat határozd meg a megjelenés előtt: címsor, kiegészítő szöveg, számadatok, hierarchia és a szakaszok kapcsolata. Egy hasznos termékfeladat fő objektumot, közelről látható anyagrészleteket és címkézett jellemzőket egyesíthet egy képfelületen. Oktatóillusztrációnál nevezd meg a fogalmat, a diagram szerkezetét és a pontos képaláírásokat, ne a modellre bízd a mögöttes tények kitalálását. Az összetett elrendezés több panelt vagy egymásba ágyazott felületet is mutathat. Az ajánlott 4 500 tokenes promptmaximumot arra összpontosítsd, minek kell megjelennie és hol.

A 3.0-család 12 nyelven támogat natív tipográfiát, több betűtípust és több mint 100 művészi stílust, továbbá finom textúrákat, például hajat, bőrt vagy szövetet. Az apró szöveg megjelenítését akár 10 pixeles méretben is demonstrálják. Ez támogatja a betűk fizikai anyaggal való ötvözését vagy a szöveg élethű képekkel való kombinálását. Add meg a pontos megfogalmazást, számokat és nyelvet, és írd le minden blokk tipográfiai szerepét. Egy újságoldal vagy felületi látványterv továbbra is kép, így a későbbi szerkeszthető elrendezés vagy interaktív működés külön, ebből felépítendő eredmény.

A Pro szerkesztheti a képen belüli szöveget, hozzáadhat, törölhet vagy mozgathat elemeket, módosíthatja az alany cselekvését, átvihet vizuális stílust és javíthat részleteket. A szerkesztés egy–három bemeneti képet fogad egy utasítással. Sorrendjük határozza meg a feladatleírás 1., 2. és 3. képét. Jelezd, mely referencia adja az alany identitását, melyik biztosít tárgyat vagy ruházatot, és melyik járul hozzá környezettel vagy pózzal. A célzott szerkesztés megnevezi a kívánt változtatást és a megőrzendő jellemzőket is, megkönnyítve a létrejött kép referenciákkal való összevetését.

Támogatott bemenet a JPG, JPEG, PNG, BMP, TIFF, WebP és GIF; animált GIF esetén csak az első képkocka kerül felhasználásra. Egy bemeneti kép legfeljebb 10 MB lehet. A pontos API 1–8 000 pixeles oldalakat és legfeljebb 10:1 hosszú/rövid oldalarányt fogad; ajánlott tartománya 384–2 048 pixel. A szerkesztési útmutató külön legfeljebb 3 072 pixeles képeket ajánl, ezért a bemenetválasztást a szükséges részletesség előkészítésének tekintsd, ne ígéretnek arra, hogy minden felbontás javítja az eredményt. Apró szöveghez vagy anyagjellemzőkhöz használj olvasható, megfelelően keretezett referenciát.

A kimenet PNG. A gyártói munkafolyamat egy–hat alternatívát ad vissza, alapértelmezésként egyet, és 512 × 512-től 2 048 × 2 048-ig terjedő teljes pixelterületet támogat 1:8–8:1 képarányokkal. A pixelterület-keret bizonyos nem négyzetes méreteket is megenged, amelyek hosszabb oldala meghaladja a 2 048 pixelt. Ha nincs méret megadva, a modell a feladatleírás alapján ajánl felbontást. A formát a tényleges elhelyezéshez válaszd, majd a generált változatoknál a tartalom teljességét, az alany részleteit és a tipográfiát a tervezett megjelenítési méretben hasonlítsd össze.

Az intelligens promptátírás alapértelmezésként be van kapcsolva. Közvetlen javítás generáláshoz és szerkesztéshez is elérhető, míg az ügynöki javítás a szövegből képet készítő promptokat finomítja, és képből képet szerkesztő munkához nem használható. A Thinking szintén alapértelmezésként bekapcsolt, és promptátírást igényel; további következtetési munkát és generálási időt ad hozzá. A negatív promptok nem kívánt elemeket neveznek meg, az opcionális seed pedig egységesebbé teheti a változatok összehasonlítását. A világos pozitív feladatleírásnak továbbra is meg kell határoznia az alanyt, a kompozíciót és a megőrzendő részleteket.

A gyakorlati eredményellenőrzés a pontos szöveget, számokat, olvasási sorrendet, referenciahűséget és a tervhez fontos éleket vagy textúrákat vizsgálja. Ha egy konkrét rész javítandó, őrizd meg a sikeres kompozíciót, és írd le a célzott módosítást. Minden kiválasztott képet tarts meg a promptjával és referenciáival, mert a gyártó kimeneti helyei 24 óra után lejárnak. A Pro dokumentált módjai és korlátai a 3.0-verzióhoz tartoznak; a Qwen 2.1-nél leírt tízreferenciás és natív átlátszósági funkció külön verzióképesség.

Ailoot Ultra · Képek POST /v1/images/generations qwen/qwen-image-3-pro

qwen/qwen-image-3-pro

Alibaba /qwen/qwen-image-3-pro

Kezdő lépések

Elfogadott bemenetek: Szöveg · Képek
Eredmények: Képek

Elérhető az Ailootban · bemenetek és metódusok

Ailoot Ultra · Képek POST /v1/images/generations

Bemenet: text, image
Kimenet: image

Mező	Típus	Követelmény	Értékek és korlátok	Alapértelmezett
Mező`model`	Típus`string`	KövetelményKötelező	Értékek és korlátok qwen/qwen-image-3-pro	Alapértelmezett—
Mező`prompt`	Típus`string`	KövetelményKötelező	Értékek és korlátok Minimális hossz: 1	Alapértelmezett—
Mező`resolution`	Típus`string`	KövetelményOpcionális	Értékek és korlátok 1K, 2K	Alapértelmezett—
Mező`aspect_ratio`	Típus`string`	KövetelményOpcionális	Értékek és korlátok 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	Alapértelmezett—
Mező`n`	Típus`integer`	KövetelményOpcionális	Értékek és korlátok Minimum: 1 Maximum: 6	Alapértelmezett—
Mező`input_references`	Típus`array`	KövetelményOpcionális	Értékek és korlátok Minimális elemszám: 0 Maximális elemszám: 4	Alapértelmezett—
Mező`provider`	Típus`object`	KövetelményOpcionális	Értékek és korlátok	Alapértelmezett—

Metódus paraméterei és életciklusa

Paraméter	Szerződés
Paraméter`content_type`	Szerződésapplication/json
Paraméter`required`	Szerződésmodel, prompt
Paraméter`material_types`	Szerződéstext, image

Életciklus: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · A ténylegesen visszaadott task_id vagy a médiatár bejegyzése

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

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Díjcsomagok

A végső díj számítása

A megjelenített díjtételek a generálás előtti költségbecsléshez szolgálnak. A végleges díj az eredeti generáláshoz rögzített költségből számítódik. A kimenet mért időtartama és az előre jelzett mennyiségek nem azonosak a véglegesen elszámolandó mennyiséggel.

A díjszabás nem ad új kérési lehetőségeket. A támogatott paraméterek a kiválasztott módszernél szerepelnek.

Gyors mód: Nincs megadva Ha a gyors mód van kiválasztva
Flex mód: Nincs megadva Ha a flex mód van kiválasztva
Maximális gondolkodási ráfordítás: Nincs megadva Ha a maximális gondolkodási ráfordításra a default beállításhoz tartozó korrekció vonatkozik

Becsült díjak összehasonlításhoz

Árak beállításonként

Minden díjat a megjelenített feltételekhez rendeljen. Az alternatív beállítások minden csoportjához egy díjtételt használjon.

Beállítás	Díjtáblázat	Előre jelzett mennyiség	Elszámolási egység	Díj
BeállításTokenek alapdíjai	DíjtáblázatAlapdíj	Előre jelzett mennyiség—	Elszámolási egység—	Díj Bemenet · Bemeneti tokenek · Becslés, csak összehasonlításra — / 1K token Kimenet · Kimeneti tokenek · Becslés, csak összehasonlításra — / 1K token Bemenet · Gyorsítótár olvasása · Becslés, csak összehasonlításra — / 1K token Bemenet · Írás a gyorsítótárba · Becslés, csak összehasonlításra — / 1K token Bemenet · Írás a gyorsítótárba, 1 óra · Becslés, csak összehasonlításra — / 1K token
Beállításbemeneti kép	Díjtáblázat—	Előre jelzett mennyiség—	Elszámolási egységbemeneti képenként	Díj Bemenet · bemeneti kép · Becslés, csak összehasonlításra $0.006 bemeneti képenként
BeállításA generálás becsült költsége	Díjtáblázat—	Előre jelzett mennyiségbecslés egy generálásra	Elszámolási egység—	Díj Kimenet · Becsült generálási költség · Becslés, csak összehasonlításra $0.08 becslés a generálás előtt Ez a becslés nem jelent további díjat, és nem rögzített díjszabás az elkészült generálásra.

Az Ailoot a kérés előtt becsült összeget foglal le. Az eredmény után a mért használat alapján elszámolja a végső díjat. Folyamatos átvitel esetén a végső használati rekordot használja. A foglalás és az elszámolás működése →

Példakérések

Ailoot Ultra · Képek

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

Eredmények fogadása és mentése

Ailoot Ultra · Képek

Töltsön le minden visszaadott képet, vagy mentse a Base64-tartalmat

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

További tartalomlekérések

A meglévő, Önhöz tartozó médiafájlok lekérése

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.

Őrizzen meg minden elkészült eredményt

Mentsen minden elkészült képet; töltse le az összes visszaadott URL tartalmát, vagy dekódolja a Base64-tartalmat.

Őrizze meg a teljes választ és a fejléceket, minden tényleges kimenetet, az eredetileg visszaadott azonosítókat és az összes használati adatmezőt. Az eredeti műveletet állítsa helyre, a létrehozási kérés újbóli beküldése nélkül.

Ha az eredeti választ ellenőrizni kell

Őrizze meg a visszaadott X-Client-Request-ID értéket az egyeztetéshez. Csak a ténylegesen visszaadott task_id/asset_id értékekkel kérdezzen le, vagy használja a saját médiatárat; soha ne állítson össze feladat-URL-t a műveletazonosítóból, és soha ne küldje be újra a létrehozási kérést.

Válaszmezők

Mező	Típus
Mező`created`	Típus
Mező`data[].url`	Típus
Mező`data[].b64_json`	Típus
Mező`usage`	Típus

Álnevek

Modell álnevei

Ailoot Ultra qwen/qwen-image-3-pro

Metódusútvonalak álnevei

/v1/images

Kapcsolódó modellazonosítók

qwen/qwen-image-3-pro

FAQ · Qwen: Qwen Image 3 Pro

Milyen bemenetek és eredmények érhetők el?: POST /v1/images/generations · qwen/qwen-image-3-pro: text, image → image
Mely mezőket használja a kérés?: POST /v1/images/generations · qwen/qwen-image-3-pro: model, prompt, resolution, aspect_ratio, n, input_references, provider
Milyen korlátok érvényesek?: POST /v1/images/generations · qwen/qwen-image-3-pro: n.minimum: 1; n.maximum: 6

Qwen: Qwen Image 3 Pro