Qwen: Qwen Image 3 Pro

Qwen-Image-3.0 Pro – Qwen vaizdų generavimo ir redagavimo flagmanas sudėtingiems maketams, tikroviškoms detalėms ir daugiakalbiam tekstui. Tikslia užduotimi arba nuo vieno iki trijų pavyzdinių vaizdų kurkite grafiką, produkto sceną ar tikslinį vaizdo pakeitimą.

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

Apie modelį

Šis aprašas apima modelio galimybes. Pasirinktam metodui Ailoot prieinamos įvestys, išvestys ir parinktys nurodytos toliau.

Qwen-Image-3.0 Pro yra trečiosios kartos Qwen modelis flagmanas vaizdams generuoti ir redaguoti. Jis derina sudėtingų maketų kūrimą, detalias tikroviškas tekstūras, daugiakalbę tipografiją ir tikslų vaizdo užduoties laikymąsi. Pro ir standartinė Qwen-Image-3.0 versija turi tuos pačius dokumentuotus generavimo ir redagavimo režimus; Pro pabrėžia vaizdo kokybę, o standartinė versija derina kokybę ir greitį. Rezultatas yra atvaizduotas vaizdo artefaktas.

Informacijos gausiai grafikai pirmiausia apibrėžkite turinį, tada išvaizdą: antraštę, papildomą tekstą, skaičius, hierarchiją ir dalių ryšį. Naudinga produkto užduotis gali viename vaizde sujungti pagrindinį objektą, stambiu planu rodomas medžiagos detales ir pažymėtas savybes. Mokomajai iliustracijai nurodykite sąvoką, diagramos struktūrą ir tikslius užrašus, užuot tikėjęsi, kad modelis sugalvos pagrindinius faktus. Sudėtingi maketai taip pat gali rodyti kelias paneles ar įdėtąsias sąsajas. Rekomenduojamą iki 4 500 žetonų užklausą sutelkite į tai, kas turi būti vaizde ir kur tai turi atsirasti.

3.0 šeima palaiko natūralią tipografiją 12 kalbų, įvairius šriftus ir daugiau kaip 100 meninių stilių bei smulkias tekstūras, pavyzdžiui, plaukus, odą ar audinį. Mažo teksto atvaizdavimas demonstruojamas iki 10 pikselių dydžio. Tai leidžia kurti dizainą, kuriame raidės susilieja su fizine medžiaga arba tekstas derinamas su tikroviškais vaizdais. Pateikite tikslius žodžius, skaitmenis ir kalbą bei aprašykite kiekvieno bloko tipografinį vaidmenį. Laikraščio puslapis ar sąsajos maketas tebėra paveikslas, todėl vėlesnis redaguojamas maketas ar interaktyvus veikimas yra atskiras iš jo kuriamas artefaktas.

Pro gali redaguoti tekstą vaizde, pridėti, ištrinti ar perkelti elementus, pakeisti objekto veiksmą, perkelti vaizdinį stilių ir pagerinti detales. Redagavimas priima nuo vieno iki trijų įvesties vaizdų kartu su instrukcija. Jų tvarka apibrėžia 1 vaizdą, 2 vaizdą ir 3 vaizdą užduotyje. Nurodykite, kuris pavyzdys suteikia subjekto tapatybę, kuris – objektą ar aprangą, o kuris – aplinką ar pozą. Tikslinis redagavimas įvardija ir norimą pakeitimą, ir savybes, kurios turi išlikti, todėl rezultatą lengviau palyginti su pavyzdžiais.

Palaikomos įvestys yra JPG, JPEG, PNG, BMP, TIFF, WebP ir GIF; animuotiems GIF naudojamas tik pirmasis kadras. Kiekvienas įvesties vaizdas gali būti iki 10 MB. Šis konkretus API priima kraštines nuo 1 iki 8 000 pikselių ir ilgosios bei trumposios kraštinės santykį ne didesnį kaip 10:1; rekomenduojamas intervalas yra 384–2 048 pikseliai. Redagavimo vadove atskirai rekomenduojami iki 3 072 pikselių vaizdai, todėl įvesties parinkimą vertinkite kaip pasiruošimą reikalingoms detalėms, o ne pažadą, kad kiekviena raiška pagerina rezultatą. Mažam tekstui ar medžiagos ypatybėms naudokite įskaitomą, tinkamai įrėmintą pavyzdį.

Išvestys yra PNG. Kūrėjo darbo eiga grąžina nuo vieno iki šešių variantų, pagal numatytąjį nustatymą – vieną, ir palaiko bendrą pikselių plotą nuo 512 × 512 iki 2 048 × 2 048 su kraštinių santykiais nuo 1:8 iki 8:1. Pikselių ploto biudžetas leidžia kai kuriuos ne kvadratinius matmenis, kurių ilgesnioji kraštinė viršija 2 048 pikselius. Kai dydis nenurodytas, modelis rekomenduoja raišką pagal užduotį. Pasirinkite formą tikrajai naudojimo vietai, tada palyginkite sugeneruotus variantus pagal turinio išsamumą, objekto detales ir tipografiją numatytu rodymo dydžiu.

Išmanusis užklausos perrašymas įjungtas pagal numatytąjį nustatymą. Tiesioginis pagerinimas prieinamas generavimui ir redagavimui, o agentinis pagerinimas tikslina teksto pavertimo vaizdu užklausas ir negali būti naudojamas vaizdo pavertimo vaizdu redagavimui. Thinking režimas taip pat įjungtas pagal numatytąjį nustatymą ir reikalauja užklausos perrašymo; jis prideda analizės darbo ir generavimo laiko. Neigiamos užklausos įvardija nepageidaujamus elementus, o pasirenkama seed reikšmė gali padėti nuosekliau palyginti variantus. Aiški teigiama užduotis vis tiek turėtų apibrėžti subjektą, kompoziciją ir išsaugotinas detales.

Praktinėje rezultato peržiūroje tikrinamas tikslus tekstas, skaičiai, skaitymo tvarka, atitiktis pavyzdžiams ir dizainui svarbūs kraštai ar tekstūros. Kai reikia taisyti konkrečią dalį, išsaugokite sėkmingą kompoziciją ir aprašykite tikslinį pakeitimą. Visus pasirinktus vaizdus saugokite su užklausa ir pavyzdžiais, nes kūrėjo išvesties adresai nustoja galioti po 24 valandų. Dokumentuoti Pro režimai ir ribos priklauso 3.0 versijai; dešimties pavyzdžių ir savosios skaidrumo funkcijos, aprašytos Qwen 2.1, yra atskiros versijos galimybės.

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

qwen/qwen-image-3-pro

Alibaba /qwen/qwen-image-3-pro

Pradžia

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
Laukas`model`	Tipas`string`	ReikalavimasPrivaloma	Reikšmės ir ribos qwen/qwen-image-3-pro	Numatyta—
Laukas`prompt`	Tipas`string`	ReikalavimasPrivaloma	Reikšmės ir ribos Mažiausias ilgis: 1	Numatyta—
Laukas`resolution`	Tipas`string`	ReikalavimasNeprivaloma	Reikšmės ir ribos 1K, 2K	Numatyta—
Laukas`aspect_ratio`	Tipas`string`	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—
Laukas`n`	Tipas`integer`	ReikalavimasNeprivaloma	Reikšmės ir ribos Mažiausia reikšmė: 1 Didžiausia reikšmė: 6	Numatyta—
Laukas`input_references`	Tipas`array`	ReikalavimasNeprivaloma	Reikšmės ir ribos Mažiausias elementų skaičius: 0 Didžiausias elementų skaičius: 4	Numatyta—
Laukas`provider`	Tipas`object`	ReikalavimasNeprivaloma	Reikšmės ir ribos	Numatyta—

Metodo parametrai ir gyvavimo ciklas

Parametras	Specifikacija
Parametras`content_type`	Specifikacijaapplication/json
Parametras`required`	Specifikacijamodel, prompt
Parametras`material_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.08 į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-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

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

Laukas	Tipas
Laukas`created`	Tipas
Laukas`data[].url`	Tipas
Laukas`data[].b64_json`	Tipas
Laukas`usage`	Tipas

Pseudonimai

Modelių pseudonimai

Ailoot Ultra qwen/qwen-image-3-pro

Metodų kelių pseudonimai

/v1/images

Susiję ID iškvietimui

qwen/qwen-image-3-pro

FAQ · Qwen: Qwen Image 3 Pro

Kokios įvestys ir rezultatai prieinami?: POST /v1/images/generations · qwen/qwen-image-3-pro: text, image → image
Kokius laukus naudoja užklausa?: POST /v1/images/generations · qwen/qwen-image-3-pro: model, prompt, resolution, aspect_ratio, n, input_references, provider
Kokie apribojimai taikomi?: POST /v1/images/generations · qwen/qwen-image-3-pro: n.minimum: 1; n.maximum: 6

Qwen: Qwen Image 3 Pro