models

Qwen: Qwen Image 3

Markdown · JSON

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-3

Alibaba /qwen/qwen-image-3

Pradž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
LaukasTipasReikalavimasReikšmės ir ribosNumatyta
LaukasmodelTipasstringReikalavimasPrivalomaReikšmės ir ribos
qwen/qwen-image-3
Numatyta—
LaukaspromptTipasstringReikalavimasPrivalomaReikšmės ir ribos
Mažiausias ilgis: 1
Numatyta—
LaukasresolutionTipasstringReikalavimasNeprivalomaReikšmės ir ribos
1K, 2K
Numatyta—
Laukasaspect_ratioTipasstringReikalavimasNeprivalomaReikš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—
LaukasnTipasintegerReikalavimasNeprivalomaReikšmės ir ribos
Mažiausia reikšmė: 1
Didžiausia reikšmė: 6
Numatyta—
Laukasinput_referencesTipasarrayReikalavimasNeprivalomaReikšmės ir ribos
Mažiausias elementų skaičius: 0
Didžiausias elementų skaičius: 4
Numatyta—
LaukasproviderTipasobjectReikalavimasNeprivalomaReikšmės ir ribosNumatyta—
Metodo parametrai ir gyvavimo ciklas
ParametrasSpecifikacija
Parametrascontent_typeSpecifikacijaapplication/json
ParametrasrequiredSpecifikacijamodel, prompt
Parametrasmaterial_typesSpecifikacijatext, 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 kiekisApskaitos vienetasMokestis
KonfigūracijaBaziniai žetonų įkainiaiĮkainių lentelėBazinis įkainisNumatomas 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 įvertisApskaitos 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

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

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}/content
  • GET /v1/media/assets
  • GET /v1/media/assets/{asset_id}
Kito turinio skaitymas
Skaityti esamą jums priklausančią medžiagą
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
LaukasTipas
LaukascreatedTipas
Laukasdata[].urlTipas
Laukasdata[].b64_jsonTipas
LaukasusageTipas

Pseudonimai

Modelių pseudonimai

Ailoot Ultra qwen/qwen-image-3

Metodų kelių pseudonimai

/v1/images

Susiję ID iškvietimui

qwen/qwen-image-3

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

Išsamiau

Prijunkite Ailoot prie Claude Code, OpenCode, Hermes arba savo programos.

Įmonė ir jos projektų portfelis

Įmonė ir jos projektų portfelis: milijonai klientų; mėnesio pardavimai siekia milijardus.

Pirkite žetonus su nuolaida.

Prenumeratos nuolaida reguliariam darbui. Kodai — iki 50% žetonų pirkimui.

Prenumerata
Pasirinkite planą su nuolaida reguliarioms užklausoms.
Nuolaidos kodas iki 50%
Įveskite kodą perkant. Kaina perskaičiuojama pagal galiojančios akcijos sąlygas.
Išlaidos istorijoje
Kiekvienai užklausai išsaugomi modelis, žetonai ir suma.

Pasirinkti prenumeratą · Peržiūrėti modelių kainas

Prijunkite API prie produkto, kurį parduodate.

SaaS, programos ir botai pagal Ailoot ofertą bei licencijos sutartį. Perpardavimui paprašykite perpardavėjo licencijos.

Komercinė programa
Teksto, vaizdų, video ir garso kūrimą integruokite į mokamas paslaugos funkcijas.
Perpardavėjo licencija
Atsiųskite projekto aprašymą ir prieigos schemą. Paprašykite rašytinių naudojimo ir perpardavimo sąlygų.
Dokumentai svetainėje
Oferta, licencijos sutartis ir duomenų tvarkymo politika prieinamos prieš prisijungiant.

Paprašyti perpardavėjo licencijos · Oferta ir licencijos sutartis