Qwen: Qwen Image 3 Pro

Qwen-Image-3.0 Pro je vlajkový model Qwen na generovanie a úpravu obrázkov pre zložité rozloženia, realistické detaily a viacjazyčný text. Použite presné zadanie alebo jednu až tri referencie na vytvorenie grafiky, produktovej scény alebo cielenej vizuálnej úpravy.

Ailoot Ultra · Obrázky POST /v1/images/generations qwen/qwen-image-3-pro

O modeli

Tento opis pokrýva možnosti modelu. Dostupné vstupy, výstupy a voľby v Ailoot sú uvedené nižšie pre vybranú metódu.

Qwen-Image-3.0 Pro je vlajkový model tretej generácie Qwen na generovanie a úpravu obrázkov. Spája tvorbu zložitých rozložení, detailné realistické textúry, viacjazyčnú typografiu a dôsledné dodržiavanie obrazového zadania. Pro a štandardný Qwen-Image-3.0 zdieľajú dokumentované režimy generovania a úprav; Pro zdôrazňuje kvalitu obrázka, zatiaľ čo štandardné vydanie vyvažuje kvalitu a rýchlosť. Výsledkom je vykreslený obrazový artefakt.

Pri informačne bohatej grafike definujte obsah pred vzhľadom: nadpis, podporný text, čísla, hierarchiu a vzťahy medzi časťami. Užitočné produktové zadanie môže na jednom plátne spojiť hlavný objekt, detailné zábery materiálu a označené vlastnosti. Pri vzdelávacej ilustrácii určte koncept, štruktúru diagramu a presné popisy namiesto spoliehania sa na model, že vymyslí podkladové fakty. Zložité rozloženia môžu zobrazovať aj viac panelov či vnorené rozhrania. Prompt v rámci odporúčaného maxima 4 500 tokenov sústreďte na to, čo sa musí objaviť a kam to patrí.

Rodina 3.0 podporuje prirodzenú typografiu v 12 jazykoch, viacero písiem a viac ako 100 umeleckých štýlov, spolu s jemnými textúrami, ako sú vlasy, pokožka či látka. Vykreslenie malého textu je demonštrované až do 10 pixelov. To podporuje dizajn spájajúci písmo s fyzickým materiálom alebo text s realistickým obrazom. Dodajte presné znenie, číslice a jazyk a opíšte typografickú rolu každého bloku. Novinová strana alebo maketa rozhrania je stále obrázok, takže neskoršie editovateľné rozloženie či interaktívne správanie sú samostatným artefaktom, ktorý z neho treba vytvoriť.

Pro môže upravovať text v obrázku, pridávať, odstraňovať či presúvať prvky, meniť konanie subjektu, prenášať vizuálny štýl a vylepšovať detaily. Úpravy prijímajú jeden až tri vstupné obrázky s pokynom. Ich poradie určuje obrázok 1, obrázok 2 a obrázok 3 v zadaní. Uveďte, ktorá referencia dodáva identitu subjektu, ktorá objekt či oblečenie a ktorá prostredie alebo pózu. Cielená úprava pomenúva zamýšľanú zmenu aj vlastnosti, ktoré majú zostať nedotknuté, čím uľahčuje porovnanie výsledného obrázka s referenciami.

Podporované vstupy sú JPG, JPEG, PNG, BMP, TIFF, WebP a GIF; pri animovaných GIF sa používa iba prvá snímka. Každý vstupný obrázok môže mať až 10 MB. Konkrétne API prijíma strany od 1 do 8 000 pixelov a pomer dlhej ku krátkej strane najviac 10:1; odporúčaný rozsah je 384–2 048 pixelov. Sprievodca úpravami samostatne odporúča obrázky do 3 072 pixelov, preto vnímajte výber vstupu ako prípravu na potrebné detaily, nie prísľub, že každé rozlíšenie zlepší výsledok. Pri drobnom texte alebo vlastnostiach materiálu používajte čitateľnú a primerane orámovanú referenciu.

Výstupy sú PNG. Postup výrobcu vracia jednu až šesť alternatív, predvolene jednu, a podporuje celkovú pixelovú plochu od 512 × 512 do 2 048 × 2 048 pri pomeroch strán od 1:8 do 8:1. Rozpočet pixelovej plochy umožňuje niektoré neštvorcové rozmery, ktorých dlhšia strana presahuje 2 048 pixelov. Ak veľkosť nie je uvedená, model odporučí rozlíšenie podľa zadania. Vyberte tvar pre skutočné umiestnenie a potom porovnajte generované alternatívy podľa úplnosti obsahu, detailov subjektu a typografie pri zamýšľanej veľkosti zobrazenia.

Inteligentné prepisovanie promptov je predvolene zapnuté. Priame vylepšenie je dostupné pre generovanie aj úpravy, zatiaľ čo vylepšenie pomocou agenta spresňuje prompty text-na-obrázok a nemožno ho použiť pri úprave obrázok-na-obrázok. Režim Thinking je tiež predvolene zapnutý a vyžaduje prepisovanie promptu; pridáva uvažovanie a čas generovania. Negatívne prompty určujú neželané prvky a voliteľná hodnota seed môže urobiť porovnávanie variantov konzistentnejším. Jasné pozitívne zadanie má stále určiť subjekt, kompozíciu a detaily na zachovanie.

Praktická kontrola výsledku preveruje presný text, čísla, poradie čítania, vernosť referenciám a okraje či textúry dôležité pre dizajn. Ak konkrétna časť potrebuje revíziu, zachovajte vydarenú kompozíciu a opíšte cielenú zmenu. Všetky vybrané obrázky uchovajte s promptom a referenciami, pretože umiestnenia výstupov výrobcu vypršia po 24 hodinách. Dokumentované režimy a limity Pro patria vydaniu 3.0; funkcie s desiatimi referenciami a natívnou priehľadnosťou opísané pre Qwen 2.1 sú schopnosťami samostatného vydania.

Ailoot Ultra · Obrázky POST /v1/images/generations qwen/qwen-image-3-pro

qwen/qwen-image-3-pro

Alibaba /qwen/qwen-image-3-pro

Úvod

Povolené vstupy: Text · Obrázky
Výsledky: Obrázky

Dostupné v Ailoot · vstupy a metódy

Ailoot Ultra · Obrázky POST /v1/images/generations

Vstup: text, image
Výstup: image

Pole	Typ	Požiadavka	Hodnoty a limity	Predvolené
Pole`model`	Typ`string`	PožiadavkaPovinné	Hodnoty a limity qwen/qwen-image-3-pro	Predvolené—
Pole`prompt`	Typ`string`	PožiadavkaPovinné	Hodnoty a limity Minimálna dĺžka: 1	Predvolené—
Pole`resolution`	Typ`string`	PožiadavkaVoliteľné	Hodnoty a limity 1K, 2K	Predvolené—
Pole`aspect_ratio`	Typ`string`	PožiadavkaVoliteľné	Hodnoty a limity 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	Predvolené—
Pole`n`	Typ`integer`	PožiadavkaVoliteľné	Hodnoty a limity Minimum: 1 Maximum: 6	Predvolené—
Pole`input_references`	Typ`array`	PožiadavkaVoliteľné	Hodnoty a limity Minimálny počet položiek: 0 Maximálny počet položiek: 4	Predvolené—
Pole`provider`	Typ`object`	PožiadavkaVoliteľné	Hodnoty a limity	Predvolené—

Parametre a životný cyklus metódy

Parameter	Špecifikácia
Parameter`content_type`	Špecifikáciaapplication/json
Parameter`required`	Špecifikáciamodel, prompt
Parameter`material_types`	Špecifikáciatext, image

Životný cyklus: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · skutočne vrátené task_id alebo záznam v knižnici médií

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

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Cenník

Ako sa vypočíta konečný poplatok

Zobrazené sadzby slúžia na odhad nákladov pred generovaním. Konečný poplatok sa vypočíta z nákladov zaznamenaných pri pôvodnom generovaní. Namerané trvanie výstupu a predpokladané množstvá nepredstavujú konečné účtované množstvo.

Tarifné údaje nepridávajú možnosti požiadavky. Podporované parametre sú uvedené pri vybranej metóde.

Rýchly režim: Neuvedené Keď je zvolený rýchly režim
Režim Flex: Neuvedené Keď je zvolený režim flex
Maximálna úroveň uvažovania: Neuvedené Keď sa pri maximálnej úrovni uvažovania používa predvolená úprava (default)

Odhadované sadzby na porovnanie

Ceny podľa konfigurácie

Každý poplatok priraďte k zobrazeným podmienkam. Pre každú skupinu alternatívnych konfigurácií použite jednu sadzbu.

Konfigurácia	Sadzobník	Odhadované množstvo	Účtovacia jednotka	Poplatok
KonfiguráciaZákladné sadzby za tokeny	SadzobníkZákladná sadzba	Odhadované množstvo—	Účtovacia jednotka—	Poplatok Vstup · Vstupné tokeny · Odhad iba na porovnanie — / 1K tokenov Výstup · Výstupné tokeny · Odhad iba na porovnanie — / 1K tokenov Vstup · Čítanie cache · Odhad iba na porovnanie — / 1K tokenov Vstup · Zápis do cache · Odhad iba na porovnanie — / 1K tokenov Vstup · Zápis do cache, 1 hod · Odhad iba na porovnanie — / 1K tokenov
Konfiguráciavstupný obrázok	Sadzobník—	Odhadované množstvo—	Účtovacia jednotkaza vstupný obrázok	Poplatok Vstup · vstupný obrázok · Odhad iba na porovnanie $0.006 za vstupný obrázok
KonfiguráciaOdhadované náklady na generovanie	Sadzobník—	Odhadované množstvoodhad pre jedno generovanie	Účtovacia jednotka—	Poplatok Výstup · Odhadované náklady na generovanie · Odhad iba na porovnanie $0.08 odhad pred generovaním Tento odhad nepredstavuje dodatočný poplatok ani pevnú sadzbu za dokončené generovanie.

Ailoot pred požiadavkou rezervuje odhadovanú sumu. Po získaní výsledku vyúčtuje konečný poplatok podľa nameraného využitia. Pri streamovaní sa vyúčtovanie riadi konečným záznamom využitia. Ako funguje rezervácia a vyúčtovanie →

Príklady požiadaviek

Ailoot Ultra · Obrázky

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

Prijať a uložiť výsledky

Ailoot Ultra · Obrázky

Stiahnite každý vrátený obrázok alebo uložte jeho obsah Base64

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

Čítanie ďalšieho obsahu

Čítať existujúce podklady, ktoré vám patria

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.

Uchovať všetky dokončené výsledky

Uložte každý dokončený obrázok; stiahnite obsah z každej vrátenej URL alebo dekódujte jeho obsah Base64.

Uchovajte úplnú odpoveď a hlavičky, všetky skutočné výstupy, pôvodné vrátené identifikátory a všetky polia s údajmi o spotrebe. Obnovte pôvodnú operáciu bez opätovného odoslania požiadavky na vytvorenie.

Ak treba overiť pôvodnú odpoveď

Uchovajte vrátené X-Client-Request-ID na zosúladenie záznamov. Čítajte iba skutočne vrátené hodnoty task_id/asset_id alebo vlastnú knižnicu médií; nikdy nevytvárajte URL úlohy z ID operácie a nikdy znova neodosielajte požiadavku na vytvorenie.

Polia odpovede

Pole	Typ
Pole`created`	Typ
Pole`data[].url`	Typ
Pole`data[].b64_json`	Typ
Pole`usage`	Typ

Aliasy

Aliasy modelov

Ailoot Ultra qwen/qwen-image-3-pro

Aliasy ciest metód

/v1/images

Súvisiace ID na volanie

qwen/qwen-image-3-pro

FAQ · Qwen: Qwen Image 3 Pro

Aké vstupy a výsledky sú dostupné?: POST /v1/images/generations · qwen/qwen-image-3-pro: text, image → image
Aké polia používa požiadavka?: POST /v1/images/generations · qwen/qwen-image-3-pro: model, prompt, resolution, aspect_ratio, n, input_references, provider
Aké limity platia?: POST /v1/images/generations · qwen/qwen-image-3-pro: n.minimum: 1; n.maximum: 6

Qwen: Qwen Image 3 Pro