Qwen: Qwen Image 3

Qwen-Image-3.0 spája generovanie a úpravu obrázkov pre informačne bohaté kompozície, detailné scény a viacjazyčnú typografiu. Štandardná edícia vyvažuje kvalitu a rýchlosť a prijíma textové zadanie alebo až tri obrázky s pokynom na úpravu.

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

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 je obrazový model tretej generácie od Qwen, ktorý v jednom modeli spája tvorbu obrázkov z textu a úpravy podľa referencií. Štandardná edícia vyvažuje kvalitu obrazu a rýchlosť odozvy, zatiaľ čo Qwen-Image-3.0 Pro je príbuzná vlajková edícia zameraná na kvalitu. Požiadavka vytvorí obrázok: plagát, ilustrované vysvetlenie, produktovú scénu, storyboard alebo upravenú fotografiu, nie editovateľný dokument či fungujúce rozhranie.

Schopnosť pracovať s bohatým obsahom sa hodí na plátno s viacerými súvisiacimi sekciami alebo vnoreným vizuálnym usporiadaním. Pred pridaním štylistických detailov pripravte nadpisy, presné znenie, hierarchiu a vzťahy medzi panelmi. Užitočné zadanie na porovnanie produktov určí hlavný pohľad na produkt, vlastnosti, ktoré treba označiť, a poradie čítania sprievodných panelov. Pri storyboarde opíšte námet, akciu a popis každého panela samostatne. Odporúčaná maximálna dĺžka zadania je 4 500 tokenov; tento priestor využite na obsah a rozloženie, ktoré obrázok skutočne potrebuje.

Model podporuje detailné textúry, typografiu vrátane malého textu predvedeného pri veľkosti 10 pixelov a natívne vykresľovanie v 12 jazykoch s rôznymi písmami a umeleckými štýlmi. Tieto schopnosti umožňujú spojiť realistický objekt s informačne bohatou grafikou bez nutnosti vyberať si medzi fotografiou a kompozíciou s množstvom textu. Uveďte presné slová a čísla, ktoré sa majú vykresliť, ich jazyk a umiestnenie. Vygenerované rozhranie berte ako vizuálny návrh: tlačidlá, grafy a popisky na obrázku nerealizujú správanie aplikácie.

Pri úprave možno meniť text, pridávať alebo odstraňovať objekty, presúvať prvky, upravovať činnosť zobrazovaného subjektu, prenášať štýl alebo zlepšovať detaily poškodeného obrázka. Poskytnite jeden až tri obrázky a jeden jasný pokyn na úpravu. Číslovanie obrázkov zodpovedá poradiu ich dodania, preto určte, ktorý obrázok poskytuje subjekt, ktorý odev alebo objekt a ktorý prostredie. Pri produktovej scéne požiadajte o umiestnenie objektu z obrázka 1 do prostredia z obrázka 2 so zachovaním vlastností, ktoré produkt odlišujú. Zmeny aj požiadavky na zachovanie prvkov vyjadrite výslovne.

Konkrétny postup pre obrazový vstup prijíma JPG, JPEG, PNG, BMP, TIFF, WebP a GIF; pri animovanom GIF sa spracuje iba prvá snímka. Každý obrázok môže mať najviac 10 MB. Aktuálne API prijíma rozmery od 1 do 8 000 pixelov, s pomerom dlhšej a kratšej strany najviac 10:1, a pre dobré výsledky odporúča 384–2 048 pixelov. Vyberte vstup, na ktorom jasne vidno detaily určené na prenos alebo úpravu. Tesne orezaná referencia môže zakryť okolitú štruktúru potrebnú na prirodzené umiestnenie objektu.

Výstupom je PNG, od jedného do šiestich obrázkov na požiadavku, pričom predvolený počet je jeden. Plocha výstupu v pixeloch sa pohybuje od 512 × 512 do 2 048 × 2 048, s pomerom strán od 1:8 do 8:1; ide o limity plochy, nie o pravidlo, podľa ktorého môže mať každá strana najviac 2 048 pixelov. Ak veľkosť neuvediete, model odporučí rozlíšenie podľa zadania. Podľa zamýšľaného použitia zvoľte kompozíciu na šírku, štvorcovú alebo na výšku a potom skontrolujte vrátený obrázok v skutočnej veľkosti, aby ste malé popisky a jemné detaily posúdili tak, ako sa budú zobrazovať.

Prepisovanie zadania je v postupe výrobcu predvolene zapnuté. Priame vylepšenie zadania funguje pri generovaní aj úpravách; vylepšenie pomocou agenta je prepracovanejší režim prepisovania iba pre tvorbu obrázkov z textu a pri úpravách obrázka podľa obrázka sa odmietne. Premýšľanie je predvolene zapnuté, vyžaduje prepisovanie zadania a predlžuje čas generovania. Negatívne zadania môžu opísať nežiaduce prvky a pevná hodnota seed pomáha porovnávať varianty. Vylúčenia a presné požiadavky na zachovanie prvkov uveďte jasne namiesto očakávania, že seed pri meniacom sa zadaní vráti identický obrázok.

Ak má byť výsledný výstup použiteľný, skontrolujte vykreslené slová, jednotky, poradie panelov a detaily identifikujúce subjekt a potom opravte konkrétnu časť, ktorá nezodpovedá zadaniu. Odpoveď s viacerými obrázkami poskytuje alternatívy na porovnanie; pri každom vrátenom obrázku zachovajte spojenie so zadaním a referenciami, z ktorých vznikol. Adresy obrázkov poskytnuté výrobcom vypršia po 24 hodinách, preto si uložte samotný obrazový súbor, keď sa výsledok stane súčasťou projektu. Štandardná edícia 3.0 sa naďalej odlišuje od Pro aj od modelov Qwen 2.1 s ich odlišnými počtami referencií a funkciami priehľadnosti.

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

qwen/qwen-image-3

Alibaba /qwen/qwen-image-3

Ú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	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.06 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', '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

Aliasy ciest metód

/v1/images

Súvisiace ID na volanie

qwen/qwen-image-3

FAQ · Qwen: Qwen Image 3

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

Qwen: Qwen Image 3

Qwen: Qwen Image 3

Úvod

Dostupné v Ailoot · vstupy a metódy

Cenník

Ako sa vypočíta konečný poplatok

Odhadované sadzby na porovnanie

Ceny podľa konfigurácie

Príklady požiadaviek

Ailoot Ultra · Obrázky

Prijať a uložiť výsledky

Ailoot Ultra · Obrázky

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

Ak treba overiť pôvodnú odpoveď

Aliasy

Aliasy modelov

Aliasy ciest metód

Súvisiace ID na volanie

Spoločnosť a jej portfólio projektov

Nakupujte tokeny so zľavou.

Pripojte API k produktu, ktorý predávate.