Qwen: Qwen Image 3

Qwen-Image-3.0 združuje ustvarjanje in urejanje slik za postavitve z veliko informacijami, podrobne prizore in večjezično tipografijo. Standardna izdaja uravnoteži kakovost in hitrost ter sprejme besedilni opis ali do tri slike z navodilom za urejanje.

Ailoot Ultra · Slike POST /v1/images/generations qwen/qwen-image-3

O modelu

Ta opis zajema zmožnosti modela. Vhodi, izhodi in možnosti, ki so na voljo v Ailoot, so spodaj navedeni za izbrano metodo.

Qwen-Image-3.0 je Qwenov slikovni model tretje generacije, ki v enem modelu združuje ustvarjanje slik iz besedila in urejanje na podlagi referenčnih slik. Standardna izdaja uravnoteži kakovost slike in hitrost odziva, Qwen-Image-3.0 Pro pa je vodilna sorodna izdaja, usmerjena v kakovost. Zahteva ustvari sliko: plakat, ilustrirano razlago, prizor z izdelkom, snemalno knjigo ali popravljeno fotografijo, ne pa dokumenta, ki ga je mogoče urejati, ali delujočega vmesnika.

Njegove zmožnosti za bogato vsebino so primerne za platno z več povezanimi razdelki ali vgnezdeno vizualno postavitev. Pred dodajanjem slogovnih podrobnosti pripravite naslove, natančno besedilo, hierarhijo in razmerja med polji. Pri primerjavi izdelkov uporaben opis določa glavni pogled na izdelek, lastnosti, ki jih je treba označiti, in vrstni red branja podpornih polj. Pri snemalni knjigi ločeno opišite motiv, dejanje in napis vsakega polja. Priporočena največja dolžina poziva je 4.500 žetonov; ta prostor namenite vsebini in postavitvi, ki ju slika dejansko potrebuje.

Model podpira podrobne teksture, tipografijo do majhnega besedila, prikazanega pri velikosti 10 slikovnih pik, ter neposreden izris v 12 jezikih z več pisavami in umetniškimi slogi. Te zmožnosti omogočajo združevanje realističnega predmeta z informacijsko bogato grafiko, namesto da bi morali izbirati med fotografijo in postavitvijo z veliko besedila. Navedite natančne besede in številke za izris, predvideni jezik in njihovo mesto. Ustvarjeni vmesnik obravnavajte kot vizualno maketo: gumbi, grafikoni in oznake na sliki ne izvajajo funkcij aplikacije.

Z urejanjem lahko spremenite besedilo, dodate ali odstranite predmete, premaknete elemente, prilagodite dejanje subjekta, prenesete slog ali izboljšate podrobnosti poškodovane slike. Priložite eno do tri slike in eno jasno navodilo za urejanje. Številčenje slik sledi vrstnemu redu vnosa, zato določite, katera slika prispeva subjekt, katera oblačilo ali predmet in katera okolje. Pri prizoru z izdelkom zahtevajte, naj bo predmet s slike 1 postavljen v okolje s slike 2, ob tem pa naj se ohranijo značilnosti, po katerih se izdelek razlikuje od drugih. Jasno navedite spremembe in zahteve glede ohranitve.

Postopek vnosa slik za to izdajo sprejema JPG, JPEG, PNG, BMP, TIFF, WebP in GIF; pri animiranem GIF-u se obdela le prva sličica. Vsaka slika je lahko velika do 10 MB. Trenutni API sprejema dimenzije od 1 do 8.000 slikovnih pik z razmerjem med daljšo in krajšo stranico največ 10:1, za dobre rezultate pa priporoča 384–2.048 slikovnih pik. Izberite vhodno sliko, na kateri so podrobnosti za prenos ali urejanje jasno vidne. Tesno obrezana referenčna slika lahko skrije okoliško strukturo, ki je potrebna za naravno umestitev predmeta.

Izhodni format je PNG, število slik na zahtevo je od ene do šestih, privzeto pa ena. Površina izhodne slike v slikovnih pikah je v razponu od 512 × 512 do 2.048 × 2.048, z razmerjem stranic med 1:8 in 8:1; to so omejitve površine in ne pravilo, da sme vsaka stranica meriti največ 2.048 slikovnih pik. Če velikost ni navedena, model predlaga ločljivost na podlagi poziva. Za predvideno uporabo izberite ležečo, kvadratno ali pokončno kompozicijo, nato pa vrnjeno sliko preglejte pri njeni dejanski velikosti, da lahko majhne oznake in drobne podrobnosti ocenite tam, kjer bodo prikazane.

V proizvajalčevem postopku je preoblikovanje poziva privzeto omogočeno. Neposredna izboljšava deluje pri ustvarjanju in urejanju; agentska izboljšava je podrobnejši način preoblikovanja le za ustvarjanje slik iz besedila, pri urejanju slike na podlagi slike pa je zavrnjena. Razmišljanje je privzeto omogočeno, zahteva preoblikovanje poziva in podaljša čas ustvarjanja. Negativni pozivi lahko opišejo neželene elemente, fiksno seme pa pomaga pri primerjavi različic. Jasno navedite izključitve in natančne zahteve glede ohranitve, namesto da bi pričakovali, da bo zaradi semena spremenjen opis vrnil enako sliko.

Za uporaben končni izdelek preverite izrisane besede, enote, vrstni red polj in podrobnosti, ki opredeljujejo subjekt, nato pa popravite določen del, ki ni ustrezal opisu. Odziv z več slikami ponuja možnosti za primerjavo; vsako vrnjeno sliko povežite s pozivom in referenčnimi slikami, iz katerih je nastala. Proizvajalčeve lokacije slik potečejo po 24 urah, zato dejansko slikovno datoteko shranite, ko rezultat postane del projekta. Standardna izdaja 3.0 je ločena od Pro in od modelov Qwen 2.1 z drugačnim številom referenčnih slik in drugačnimi funkcijami prosojnosti.

Ailoot Ultra · Slike POST /v1/images/generations qwen/qwen-image-3

qwen/qwen-image-3

Alibaba /qwen/qwen-image-3

Začetek

Dovoljeni vhodi: Besedilo · Slike
Rezultati: Slike

Na voljo v Ailoot · vhodi in metode

Ailoot Ultra · Slike POST /v1/images/generations

Vhod: text, image
Izhod: image

Polje	Vrsta	Zahteva	Vrednosti in omejitve	Privzeto
Polje`model`	Vrsta`string`	ZahtevaObvezno	Vrednosti in omejitve qwen/qwen-image-3	Privzeto—
Polje`prompt`	Vrsta`string`	ZahtevaObvezno	Vrednosti in omejitve Najmanjša dolžina: 1	Privzeto—
Polje`resolution`	Vrsta`string`	ZahtevaIzbirno	Vrednosti in omejitve 1K, 2K	Privzeto—
Polje`aspect_ratio`	Vrsta`string`	ZahtevaIzbirno	Vrednosti in omejitve 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	Privzeto—
Polje`n`	Vrsta`integer`	ZahtevaIzbirno	Vrednosti in omejitve Najmanj: 1 Največ: 6	Privzeto—
Polje`input_references`	Vrsta`array`	ZahtevaIzbirno	Vrednosti in omejitve Najmanjše število elementov: 0 Največ elementov: 4	Privzeto—
Polje`provider`	Vrsta`object`	ZahtevaIzbirno	Vrednosti in omejitve	Privzeto—

Parametri in življenjski cikel metode

Parameter	Specifikacija
Parameter`content_type`	Specifikacijaapplication/json
Parameter`required`	Specifikacijamodel, prompt
Parameter`material_types`	Specifikacijatext, image

Življenjski cikel: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · Dejansko vrnjeni task_id ali zapis v medijski knjižnici

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

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Cenik

Kako se izračuna končni strošek

Prikazane cene so namenjene oceni stroškov pred generiranjem. Končni znesek se izračuna na podlagi stroška, zabeleženega za izvirno generiranje. Izmerjeno trajanje izhoda in napovedane količine niso končna obračunska količina.

Tarifni podatki ne dodajajo možnosti zahteve. Podprti parametri so navedeni pri izbrani metodi.

Hitri način: Ni navedeno Ko je izbran hitri način
Način flex: Ni navedeno Ko je izbran način flex
Najvišja raven razmišljanja: Ni navedeno Ko najvišja raven razmišljanja uporablja privzeto prilagoditev (default)

Ocenjene cene za primerjavo

Cene po nastavitvah

Vsak strošek povežite s prikazanimi pogoji. Za vsak nabor alternativnih nastavitev uporabite eno ceno.

Nastavitev	Cenovna lestvica	Predvidena količina	Obračunska enota	Strošek
NastavitevOsnovne cene žetonov	Cenovna lestvicaOsnovna cena	Predvidena količina—	Obračunska enota—	Strošek Vhod · Vhodni žetoni · Ocena samo za primerjavo — / 1K žetonov Izhod · Izhodni žetoni · Ocena samo za primerjavo — / 1K žetonov Vhod · Branje predpomnilnika · Ocena samo za primerjavo — / 1K žetonov Vhod · Zapis v predpomnilnik · Ocena samo za primerjavo — / 1K žetonov Vhod · Zapis v predpomnilnik, 1 ura · Ocena samo za primerjavo — / 1K žetonov
Nastavitevvhodna slika	Cenovna lestvica—	Predvidena količina—	Obračunska enotana vhodno sliko	Strošek Vhod · vhodna slika · Ocena samo za primerjavo $0.006 na vhodno sliko
NastavitevOcenjeni strošek ustvarjanja	Cenovna lestvica—	Predvidena količinaocena za eno generiranje	Obračunska enota—	Strošek Izhod · Ocenjeni stroški ustvarjanja · Ocena samo za primerjavo $0.06 ocena pred ustvarjanjem Ta ocena ni dodatno plačilo ali fiksna cena za dokončano generiranje.

Ailoot pred zahtevo rezervira ocenjeni znesek. Po rezultatu obračuna končni strošek na podlagi izmerjene porabe. Obračun pretakanja uporablja končni zapis porabe. Kako delujeta rezervacija in obračun →

Primeri zahtev

Ailoot Ultra · Slike

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

Prejmi in shrani rezultate

Ailoot Ultra · Slike

Prenesite vsako vrnjeno sliko ali shranite njeno vsebino Base64

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

Branje druge vsebine

Preberi obstoječa gradiva, ki vam pripadajo

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.

Ohrani vse dokončane rezultate

Shranite vsako dokončano sliko; pridobite vsebino z vsake vrnjene URL ali dekodirajte njeno vsebino Base64.

Shranite celoten odgovor in glave, vse dejanske izhode, izvirne vrnjene identifikatorje in vsa polja s podatki o porabi. Pridobite podatke izvirne operacije brez ponovnega pošiljanja zahteve za ustvarjanje.

Če je treba preveriti izvirni odgovor

Shranite vrnjeni X-Client-Request-ID za uskladitev evidenc. Berite samo dejansko vrnjene vrednosti task_id/asset_id ali svojo medijsko knjižnico; iz ID operacije nikoli ne sestavite URL opravila in zahteve za ustvarjanje nikoli ne pošljite znova.

Polja odgovora

Polje	Vrsta
Polje`created`	Vrsta
Polje`data[].url`	Vrsta
Polje`data[].b64_json`	Vrsta
Polje`usage`	Vrsta

Druga imena

Druga imena modelov

Ailoot Ultra qwen/qwen-image-3

Druga imena poti metod

/v1/images

Povezani ID-ji za klic

qwen/qwen-image-3

FAQ · Qwen: Qwen Image 3

Kateri vhodi in rezultati so na voljo?: POST /v1/images/generations · qwen/qwen-image-3: text, image → image
Katera polja uporablja zahteva?: POST /v1/images/generations · qwen/qwen-image-3: model, prompt, resolution, aspect_ratio, n, input_references, provider
Katere omejitve veljajo?: POST /v1/images/generations · qwen/qwen-image-3: n.minimum: 1; n.maximum: 6

Qwen: Qwen Image 3

Qwen: Qwen Image 3

Začetek

Na voljo v Ailoot · vhodi in metode

Cenik

Kako se izračuna končni strošek

Ocenjene cene za primerjavo

Cene po nastavitvah

Primeri zahtev

Ailoot Ultra · Slike

Prejmi in shrani rezultate

Ailoot Ultra · Slike

Ohrani vse dokončane rezultate

Če je treba preveriti izvirni odgovor

Druga imena

Druga imena modelov

Druga imena poti metod

Povezani ID-ji za klic

Podjetje in njegov portfelj projektov

Žetone kupujte s popustom.

API povežite z izdelkom, ki ga prodajate.