Qwen: Qwen Image 3
Qwen-Image-3.0 sujungia vaizdų kūrimą ir redagavimą informacijos gausiems maketams, detalioms scenoms ir daugiakalbei tipografikai. Standartinė versija derina kokybę ir greitį, priimdama tekstinį aprašą arba iki trijų vaizdų su redagavimo instrukcija.
Apie modelį
Šis aprašas apima modelio galimybes. Pasirinktam metodui Ailoot prieinamos įvestys, išvestys ir parinktys nurodytos toliau.
Qwen-Image-3.0 – trečiosios kartos Qwen vaizdų modelis, viename modelyje sujungiantis vaizdų kūrimą iš teksto ir redagavimą pagal pavyzdinius vaizdus. Standartinė versija derina vaizdo kokybę ir atsako greitį, o Qwen-Image-3.0 Pro yra kokybei pirmenybę teikianti aukščiausios klasės gimininga versija. Užklausa sukuria vaizdą – plakatą, iliustruotą paaiškinimą, produkto sceną, siužetinę kadrų seką ar pakeistą nuotrauką, o ne redaguojamą dokumentą ar veikiančią sąsają.
Galimybės kurti gausų turinį tinka drobei su keliomis susijusiomis dalimis arba įdėtiniam vaizdiniam maketui. Prieš pridėdami stiliaus detalių paruoškite antraštes, tikslų tekstą, hierarchiją ir ryšius tarp skydelių. Produktų palyginimo užduotyje naudinga nurodyti pagrindinį produkto vaizdą, žymimas savybes ir pagalbinių skydelių skaitymo tvarką. Siužetinei kadrų sekai atskirai aprašykite kiekvieno skydelio objektą, veiksmą ir užrašą. Rekomenduojamas maksimalus instrukcijos ilgis – 4 500 žetonų; šią vietą skirkite turiniui ir maketui, kurių vaizdui iš tikrųjų reikia.
Modelis palaiko detalias tekstūras, tipografiką su smulkiu tekstu, demonstruotu 10 pikselių dydžiu, ir tiesioginį teksto atvaizdavimą 12 kalbų, naudojant įvairius šriftus bei meninius stilius. Šios galimybės leidžia suderinti tikrovišką objektą su informacijos gausia grafika, o ne verčia rinktis tarp nuotraukos ir daug teksto turinčio maketo. Pateikite tikslius atvaizduojamus žodžius ir skaitmenis, jų kalbą ir numatytą vietą. Sugeneruotą sąsają laikykite vaizdiniu maketu: paveikslėlyje esantys mygtukai, diagramos ir žymos neįgyvendina programos veikimo.
Redaguojant galima keisti tekstą, pridėti ar pašalinti objektus, perkelti elementus, keisti vaizduojamo subjekto veiksmą, perkelti stilių ar pagerinti sugadinto vaizdo detales. Pateikite nuo vieno iki trijų vaizdų ir vieną aiškią redagavimo instrukciją. Vaizdai numeruojami pagal pateikimo tvarką, todėl nurodykite, kuris suteikia subjektą, kuris – drabužį ar objektą, o kuris – aplinką. Produkto scenai paprašykite objektą iš 1 vaizdo įkelti į aplinką iš 2 vaizdo, išsaugant išskirtines produkto savybes. Aiškiai išvardykite pakeitimus ir tai, kas turi likti nepakitę.
Konkretus vaizdų įvesties procesas priima JPG, JPEG, PNG, BMP, TIFF, WebP ir GIF; animuotame GIF apdorojamas tik pirmasis kadras. Kiekvienas vaizdas gali būti iki 10 MB. Dabartinė API priima matmenis nuo 1 iki 8 000 pikselių, kai ilgosios ir trumposios kraštinių santykis neviršija 10:1, o geriems rezultatams rekomenduoja 384–2 048 pikselius. Pasirinkite pradinį vaizdą, kuriame aiškiai matomos perkeliamos ar redaguojamos detalės. Labai siaurai apkirptas pavyzdinis vaizdas gali paslėpti aplinkinę struktūrą, reikalingą natūraliai objekto vietai parinkti.
Išvestis yra PNG: nuo vieno iki šešių vaizdų vienai užklausai, numatytasis skaičius – vienas. Išvesties plotas pikseliais svyruoja nuo 512 × 512 iki 2 048 × 2 048, o kraštinių santykis – nuo 1:8 iki 8:1; tai ploto ribos, o ne taisyklė, kad kiekviena kraštinė negali viršyti 2 048 pikselių. Jei dydis nepateiktas, modelis rekomenduoja raišką pagal instrukciją. Pasirinkite paskirčiai tinkamą horizontalią, kvadratinę ar vertikalią kompoziciją, tada patikrinkite grąžintą vaizdą tikruoju dydžiu, kad smulkius užrašus ir subtilias detales galėtumėte įvertinti ten, kur jie bus rodomi.
Gamintojo procese instrukcijos perrašymas įjungtas pagal numatytąją nuostatą. Tiesioginis patobulinimas veikia tiek kuriant, tiek redaguojant; patobulinimas pasitelkus agentą yra išsamesnis perrašymo režimas tik vaizdų kūrimui iš teksto ir atmetamas redaguojant vaizdą pagal vaizdą. Mąstymo režimas įjungtas pagal numatytąją nuostatą, reikalauja instrukcijos perrašymo ir pailgina generavimo laiką. Neigiamos instrukcijos gali aprašyti nepageidaujamus elementus, o fiksuota seed reikšmė padeda lyginti variantus. Aiškiai nurodykite, ko neturi būti ir kas turi būti tiksliai išsaugota, užuot tikėjęsi, kad seed reikšmė užtikrins tą patį paveikslėlį, kai užduoties aprašas keičiasi.
Kad gautumėte naudingą galutinį rezultatą, patikrinkite atvaizduotus žodžius, vienetus, skydelių tvarką ir subjektą atpažinti leidžiančias detales, tada pakoreguokite konkrečią užduoties neatitikusią dalį. Atsakymas su keliais vaizdais suteikia palyginamų alternatyvų; kiekvieną grąžintą vaizdą išsaugokite kartu su jį sukūrusia instrukcija ir pavyzdiniais vaizdais. Gamintojo vaizdų adresai nustoja galioti po 24 valandų, todėl, rezultatui tapus projekto dalimi, išsaugokite patį vaizdo failą. Standartinė 3.0 versija lieka atskira nuo Pro ir nuo Qwen 2.1 modelių, turinčių kitokį pavyzdinių vaizdų skaičių bei skaidrumo funkcijas.
Ailoot Ultra · Vaizdai POST /v1/images/generations qwen/qwen-image-3
qwen/qwen-image-3Pradžia
Qwen-Image-3.0 sujungia vaizdų kūrimą ir redagavimą informacijos gausiems maketams, detalioms scenoms ir daugiakalbei tipografikai. Standartinė versija derina kokybę ir greitį, priimdama tekstinį aprašą arba iki trijų vaizdų su redagavimo instrukcija.
- Leidžiamos įvestys
- Tekstas · Vaizdai
- Rezultatai
- Vaizdai
Prieinama Ailoot · įvestys ir metodai
Ailoot Ultra · Vaizdai POST /v1/images/generations
- Įvestis
text,image- Išvestis
image
| Laukas | Tipas | Reikalavimas | Reikšmės ir ribos | Numatyta |
|---|---|---|---|---|
Laukasmodel | Tipasstring | ReikalavimasPrivaloma | Reikšmės ir ribos qwen/qwen-image-3 | Numatyta— |
Laukasprompt | Tipasstring | ReikalavimasPrivaloma | Reikšmės ir ribos Mažiausias ilgis: 1 | Numatyta— |
Laukasresolution | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos 1K, 2K | Numatyta— |
Laukasaspect_ratio | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos 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 | Numatyta— |
Laukasn | Tipasinteger | ReikalavimasNeprivaloma | Reikšmės ir ribos Mažiausia reikšmė: 1 Didžiausia reikšmė: 6 | Numatyta— |
Laukasinput_references | Tipasarray | ReikalavimasNeprivaloma | Reikšmės ir ribos Mažiausias elementų skaičius: 0 Didžiausias elementų skaičius: 4 | Numatyta— |
Laukasprovider | Tipasobject | ReikalavimasNeprivaloma | Reikšmės ir ribos | Numatyta— |
Metodo parametrai ir gyvavimo ciklas
| Parametras | Specifikacija |
|---|---|
Parametrascontent_type | Specifikacijaapplication/json |
Parametrasrequired | Specifikacijamodel, prompt |
Parametrasmaterial_types | Specifikacijatext, image |
Gyvavimo ciklas: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · faktiškai grąžinta task_id reikšmė arba medijos bibliotekos įrašas
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Planai
Kaip apskaičiuojamas galutinis mokestis
Rodomi įkainiai leidžia įvertinti kainą prieš generavimą. Galutinė suma apskaičiuojama pagal užfiksuotą pradinio generavimo kainą. Išmatuota rezultato trukmė ir prognozuoti kiekiai nėra galutinis apmokestinamas kiekis.
Tarifų informacija neprideda užklausos parinkčių. Palaikomi parametrai nurodyti prie pasirinkto metodo.
- Spartusis režimas
- Nenurodyta Pasirinkus spartųjį režimą
- Flex režimas
- Nenurodyta Pasirinkus flex režimą
- Didžiausios samprotavimo pastangos
- Nenurodyta Kai didžiausioms samprotavimo pastangoms taikomas numatytasis koregavimas (default)
Numatomi įkainiai palyginimui
Kainos pagal konfigūraciją
Kiekvieną mokestį susiekite su nurodytomis sąlygomis. Kiekvienam alternatyvių konfigūracijų rinkiniui taikykite vieną įkainį.
| Konfigūracija | Įkainių lentelė | Numatomas kiekis | Apskaitos vienetas | Mokestis |
|---|---|---|---|---|
| KonfigūracijaBaziniai žetonų įkainiai | Įkainių lentelėBazinis įkainis | Numatomas kiekis— | Apskaitos vienetas— | Mokestis Įvestis · Įvesties tokenai · Įvertis tik palyginimui — / 1K tokenų Išvestis · Išvesties tokenai · Įvertis tik palyginimui — / 1K tokenų Įvestis · Talpyklos skaitymas · Įvertis tik palyginimui — / 1K tokenų Įvestis · Rašymas į talpyklą · Įvertis tik palyginimui — / 1K tokenų Įvestis · Rašymas į talpyklą, 1 val · Įvertis tik palyginimui — / 1K tokenų |
| Konfigūracijaįvesties paveikslėlis | Įkainių lentelė— | Numatomas kiekis— | Apskaitos vienetasuž įvesties vaizdą | Mokestis Įvestis · įvesties vaizdas · Įvertis tik palyginimui $0.006 už įvesties vaizdą |
| KonfigūracijaNumatoma generavimo kaina | Įkainių lentelė— | Numatomas kiekisvieno generavimo įvertis | Apskaitos vienetas— | Mokestis Išvestis · Numatoma generavimo kaina · Įvertis tik palyginimui $0.06 įvertis prieš generavimą Šis įvertis nėra papildomas mokestis ar fiksuotas užbaigto generavimo įkainis. |
Ailoot prieš užklausą rezervuoja numatomą sumą. Gavus rezultatą, galutinis mokestis nuskaitomas pagal išmatuotą naudojimą. Srautinio atsakymo atsiskaitymui naudojamas galutinis naudojimo įrašas. Kaip veikia rezervavimas ir atsiskaitymas →
Užklausų pavyzdžiai
Ailoot Ultra · Vaizdai
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
Gauti ir išsaugoti rezultatus
Ailoot Ultra · Vaizdai
Atsisiųskite kiekvieną grąžintą vaizdą arba išsaugokite jo Base64 turinį
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Kito turinio skaitymas
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.
Išsaugoti visus baigtus rezultatus
Išsaugokite kiekvieną baigtą vaizdą; gaukite turinį iš kiekvieno grąžinto URL arba dekoduokite jo Base64 turinį.
Išsaugokite visą atsakymą ir antraštes, visus faktiškai gautus rezultatus, pradinius grąžintus identifikatorius ir visus naudojimo apskaitos laukus. Atkurkite prieigą prie pradinės operacijos pakartotinai neteikdami kūrimo užklausos.
Jei reikia patikrinti pradinį atsakymą
Išsaugokite grąžintą X-Client-Request-ID duomenims sutikrinti. Tikrinkite tik faktiškai grąžintas task_id/asset_id reikšmes arba jums priklausančią medijos biblioteką; niekada nekurkite užduoties URL iš operacijos ID ir niekada pakartotinai neteikite kūrimo užklausos.
Atsakymo laukai
| Laukas | Tipas |
|---|---|
Laukascreated | Tipas |
Laukasdata[].url | Tipas |
Laukasdata[].b64_json | Tipas |
Laukasusage | Tipas |
Pseudonimai
Modelių pseudonimai
Ailoot Ultra qwen/qwen-image-3
Metodų kelių pseudonimai
/v1/images
Susiję ID iškvietimui
FAQ · Qwen: Qwen Image 3
- Kokios įvestys ir rezultatai prieinami?
POST /v1/images/generations·qwen/qwen-image-3:text,image→image- Kokius laukus naudoja užklausa?
POST /v1/images/generations·qwen/qwen-image-3:model,prompt,resolution,aspect_ratio,n,input_references,provider- Kokie apribojimai taikomi?
POST /v1/images/generations·qwen/qwen-image-3:n.minimum:1;n.maximum:6