Qwen: Qwen Image 3 Pro

Qwen-Image-3.0 Pro je vlajkový model Qwen pro generování a úpravy obrazů se složitým rozvržením, realistickými detaily a vícejazyčným textem. Použijte přesné zadání nebo jednu až tři reference pro vytvoření grafiky, produktové scény nebo cílené vizuální úpravy.

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

O modelu

Tento popis zahrnuje schopnosti modelu. Vstupy, výstupy a možnosti dostupné v Ailoot jsou uvedeny níže pro vybranou metodu.

Qwen-Image-3.0 Pro je vlajkový model Qwen třetí generace pro generování a úpravy obrazů. Kombinuje tvorbu složitého rozvržení, detailní realistické textury, vícejazyčnou typografii a přesné následování obrazového zadání. Pro a standardní Qwen-Image-3.0 sdílejí dokumentované režimy generování a úprav; Pro zdůrazňuje kvalitu obrazu, zatímco standardní vydání vyvažuje kvalitu a rychlost. Výsledkem je vykreslený obrazový výstup.

U grafiky bohaté na informace definujte obsah před vzhledem: hlavní nadpis, podpůrný text, čísla, hierarchii a vztahy mezi oddíly. Užitečné produktové zadání může kombinovat hlavní objekt, detailní záběry materiálu a označené vlastnosti na jedné ploše. U vzdělávací ilustrace určete koncept, strukturu diagramu a přesné popisky místo spoléhání na to, že model vymyslí základní fakta. Složitá rozvržení mohou také zobrazit několik panelů nebo vnořená rozhraní. Doporučené maximum promptu 4 500 tokenů zaměřte na to, co se musí objevit a kam to patří.

Rodina 3.0 podporuje nativní typografii ve 12 jazycích, více písem a přes 100 uměleckých stylů spolu s jemnými texturami, například vlasů, kůže nebo látky. Je demonstrováno vykreslování malého textu už při velikosti 10 pixelů. To podporuje návrh kombinující písmo s fyzickým materiálem nebo text s realistickým obrazem. Poskytněte přesné znění, číslice a jazyk a popište typografickou roli každého bloku. Novinová stránka nebo maketa rozhraní je stále obraz, takže pozdější upravitelné rozvržení nebo interaktivní chování je samostatný výstup, který je třeba na jeho základě vytvořit.

Pro může upravovat text uvnitř obrazu, přidávat, odstraňovat nebo přesouvat prvky, měnit činnost zobrazeného subjektu, přenášet vizuální styl a vylepšovat detaily. Úpravy přijímají jeden až tři vstupní obrazy s instrukcí. Jejich pořadí určuje obraz 1, obraz 2 a obraz 3 v zadání. Určete, která reference dodává identitu subjektu, která objekt nebo oblečení a která prostředí nebo pózu. Cílená úprava pojmenovává zamýšlenou změnu i vlastnosti, které mají zůstat zachovány, a usnadňuje tak porovnání výsledného obrazu s referencemi.

Podporované vstupy jsou JPG, JPEG, PNG, BMP, TIFF, WebP a GIF, u animovaných GIFů se použije pouze první snímek. Každý vstupní obraz může mít až 10 MB. Přesné API přijímá strany od 1 do 8 000 pixelů a poměr dlouhé strany ke krátké nejvýše 10:1; doporučený rozsah je 384–2 048 pixelů. Průvodce úpravami samostatně doporučuje obrazy až do 3 072 pixelů, proto chápejte volbu vstupu jako přípravu potřebných detailů, nikoli slib, že každé rozlišení zlepší výsledek. Pro drobný text nebo vlastnosti materiálu použijte čitelnou a vhodně zarámovanou referenci.

Výstupy jsou PNG. Postup výrobce vrací jednu až šest alternativ, ve výchozím stavu jednu, a podporuje celkovou pixelovou plochu od 512 × 512 do 2 048 × 2 048 s poměry stran od 1:8 do 8:1. Rozpočet pixelové plochy umožňuje některé nečtvercové rozměry, jejichž delší strana přesahuje 2 048 pixelů. Pokud velikost není určena, model doporučí rozlišení podle zadání. Vyberte tvar pro skutečné umístění a poté porovnejte generované alternativy podle úplnosti obsahu, detailů subjektu a typografie v zamýšlené velikosti zobrazení.

Inteligentní přepisování promptu je ve výchozím stavu zapnuto. Přímé vylepšení je dostupné pro generování i úpravy, zatímco agentní vylepšení zpřesňuje prompty text-to-image a nelze je použít pro úpravy image-to-image. Thinking je také ve výchozím stavu zapnuto a vyžaduje přepisování promptu; přidává práci uvažování a čas generování. Negativní prompty určují nežádoucí prvky a volitelný seed může pomoci konzistentněji porovnávat varianty. Jasné pozitivní zadání má stále definovat subjekt, kompozici a detaily k zachování.

Praktická kontrola výsledku ověřuje přesný text, čísla, pořadí čtení, věrnost referencím a hrany nebo textury důležité pro návrh. Pokud konkrétní část potřebuje úpravu, zachovejte úspěšnou kompozici a popište cílenou změnu. Všechny vybrané obrazy ponechte s jejich promptem a referencemi, protože umístění výstupů výrobce expirují po 24 hodinách. Dokumentované režimy a limity Pro patří k vydání 3.0; deset referencí a nativní průhlednost popsané pro Qwen 2.1 jsou schopnosti samostatného vydání.

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

Přijímané vstupy: Text · Obrázky
Výsledky: Obrázky

Dostupné v Ailoot · vstupy a metody

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

Vstup: text, image
Výstup: image

Pole	Typ	Požadavek	Hodnoty a limity	Výchozí
Pole`model`	Typ`string`	PožadavekPovinné	Hodnoty a limity qwen/qwen-image-3-pro	Výchozí—
Pole`prompt`	Typ`string`	PožadavekPovinné	Hodnoty a limity Minimální délka: 1	Výchozí—
Pole`resolution`	Typ`string`	PožadavekVolitelné	Hodnoty a limity 1K, 2K	Výchozí—
Pole`aspect_ratio`	Typ`string`	PožadavekVolitelné	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	Výchozí—
Pole`n`	Typ`integer`	PožadavekVolitelné	Hodnoty a limity Minimum: 1 Maximum: 6	Výchozí—
Pole`input_references`	Typ`array`	PožadavekVolitelné	Hodnoty a limity Minimální počet položek: 0 Maximální počet položek: 4	Výchozí—
Pole`provider`	Typ`object`	PožadavekVolitelné	Hodnoty a limity	Výchozí—

Parametry a životní cyklus metody

Parametr	Kontrakt
Parametr`content_type`	Kontraktapplication/json
Parametr`required`	Kontraktmodel, prompt
Parametr`material_types`	Kontrakttext, image

Životní cyklus: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · skutečně vrácené task_id nebo záznam v knihovně médií

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

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Tarify

Jak se vypočítá konečný poplatek

Zobrazené sazby slouží k odhadu ceny před generováním. Konečný poplatek se vypočítá z nákladů zaznamenaných u původního generování. Naměřená délka výstupu ani odhadovaná množství nejsou konečným účtovaným množstvím.

Údaje o tarifech nepřidávají možnosti požadavku. Podporované parametry jsou uvedeny u vybrané metody.

Rychlý režim: Neuvedeno Při výběru rychlého režimu
Režim flex: Neuvedeno Při výběru režimu flex
Maximální intenzita uvažování: Neuvedeno Když se při maximální intenzitě uvažování použije výchozí úprava (default)

Odhadované sazby pro srovnání

Ceny podle konfigurace

Přiřaďte každý poplatek k uvedeným podmínkám. Pro každou sadu alternativních konfigurací použijte jednu sazbu.

Konfigurace	Tabulka sazeb	Předpokládané množství	Účtovací jednotka	Poplatek
KonfiguraceZákladní sazby za tokeny	Tabulka sazebZákladní sazba	Předpokládané množství—	Účtovací jednotka—	Poplatek Vstup · Vstupní tokeny · Odhad pouze pro srovnání — / 1K tokenů Výstup · Výstupní tokeny · Odhad pouze pro srovnání — / 1K tokenů Vstup · Čtení z mezipaměti · Odhad pouze pro srovnání — / 1K tokenů Vstup · Zápis do mezipaměti · Odhad pouze pro srovnání — / 1K tokenů Vstup · Zápis do mezipaměti, 1 hodina · Odhad pouze pro srovnání — / 1K tokenů
Konfiguracevstupní obrázek	Tabulka sazeb—	Předpokládané množství—	Účtovací jednotkaza vstupní obrázek	Poplatek Vstup · vstupní obrázek · Odhad pouze pro srovnání $0.006 za vstupní obrázek
KonfiguraceOdhadovaná cena generování	Tabulka sazeb—	Předpokládané množstvíodhad pro jedno generování	Účtovací jednotka—	Poplatek Výstup · Odhadovaná cena generování · Odhad pouze pro srovnání $0.08 odhad před generováním Tento odhad není dodatečným poplatkem ani pevnou sazbou za dokončené generování.

Ailoot před požadavkem rezervuje odhadovanou částku. Po výsledku vyúčtuje konečný poplatek podle naměřeného využití. Při streamování se účtování řídí konečným záznamem využití. Jak funguje rezervace a vyúčtování →

Příklady požadavků

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

Přijímání a ukládání výsledků

Ailoot Ultra · Obrázky

Stáhněte každý vrácený obrázek nebo 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}

Další načtení obsahu

Načíst existující soubory, které vám patří

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.

Uchovejte všechny dokončené výsledky

Uložte každý dokončený obrázek; stáhněte obsah každé vrácené URL nebo dekódujte obsah Base64.

Uchovejte úplnou odpověď a hlavičky, všechny skutečné výstupy, původní vrácené identifikátory a všechna pole s údaji o využití. Obnovte původní operaci bez opětovného odeslání požadavku na vytvoření.

Pokud je nutné ověřit původní odpověď

Uchovejte vrácené X-Client-Request-ID pro spárování záznamů. Načítejte pouze skutečně vrácené hodnoty task_id/asset_id nebo vlastní knihovnu médií; nikdy nevytvářejte URL úlohy z ID operace a nikdy znovu neodesílejte požadavek na vytvoření.

Pole odpovědi

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

Aliasy

Aliasy modelu

Ailoot Ultra qwen/qwen-image-3-pro

Aliasy cest metod

/v1/images

Související ID modelů

qwen/qwen-image-3-pro

FAQ · Qwen: Qwen Image 3 Pro

Jaké vstupy a výsledky jsou dostupné?: POST /v1/images/generations · qwen/qwen-image-3-pro: text, image → image
Jaká pole požadavek používá?: POST /v1/images/generations · qwen/qwen-image-3-pro: model, prompt, resolution, aspect_ratio, n, input_references, provider
Jaké limity platí?: POST /v1/images/generations · qwen/qwen-image-3-pro: n.minimum: 1; n.maximum: 6

Qwen: Qwen Image 3 Pro