Qwen: Qwen Image 3

Qwen-Image-3.0 yhdistää kuvien luonnin ja muokkauksen tietorikkaisiin sommitteluihin, yksityiskohtaisiin kohtauksiin ja monikieliseen typografiaan. Vakioversio tasapainottaa laadun ja nopeuden ja hyväksyy tekstimuotoisen tehtävänannon tai enintään kolme kuvaa muokkausohjeineen.

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

Tietoa mallista

Tämä kuvaus kattaa mallin ominaisuudet. Ailootissa saatavilla olevat syötteet, tulosteet ja asetukset luetellaan alla valitulle menetelmälle.

Qwen-Image-3.0 on Qwenin kolmannen sukupolven kuvamalli, joka yhdistää tekstistä kuvan luomisen ja viitekuviin perustuvan muokkauksen samaan malliin. Vakioversio tasapainottaa kuvan laadun ja vastausnopeuden, kun taas Qwen-Image-3.0 Pro on laatuun keskittyvä lippulaivaversio. Pyyntö tuottaa kuvan: julisteen, kuvitetun selityksen, tuotekohtauksen, kuvakäsikirjoituksen tai muokatun valokuvan, ei muokattavaa asiakirjaa tai toimivaa käyttöliittymää.

Sen kyky käsitellä rikasta sisältöä sopii kuvapinnalle, jossa on useita toisiinsa liittyviä osioita tai sisäkkäinen visuaalinen asettelu. Valmistele otsikot, täsmälliset sanamuodot, hierarkia ja paneelien väliset suhteet ennen tyylillisten yksityiskohtien lisäämistä. Tuotevertailun hyödyllinen tehtävänanto määrittelee tuotteen päänäkymän, nimettävät ominaisuudet ja tukipaneelien lukujärjestyksen. Kuvaile kuvakäsikirjoituksessa kunkin ruudun kohde, toiminta ja kuvateksti erikseen. Kehotteen suositeltu enimmäispituus on 4 500 tokenia; käytä tila kuvan todella tarvitsemaan sisältöön ja asetteluun.

Malli tukee yksityiskohtaisia tekstuureja, typografiaa aina esimerkeissä näytettyyn 10 pikselin pikkutekstiin asti sekä natiivia renderöintiä 12 kielellä useilla kirjasimilla ja taiteellisilla tyyleillä. Nämä kyvyt mahdollistavat realistisen objektin yhdistämisen tietorikkaaseen grafiikkaan sen sijaan, että olisi valittava valokuva tai paljon tekstiä sisältävä asettelu. Anna renderöitävät sanat ja numerot täsmällisesti sekä niiden kieli ja sijoituspaikka. Käsittele generoitua käyttöliittymää visuaalisena luonnoksena: kuvan painikkeet, kaaviot ja tekstit eivät toteuta sovelluksen toimintaa.

Muokkaamalla voi vaihtaa tekstiä, lisätä tai poistaa objekteja, siirtää elementtejä, muuttaa kohteen toimintaa, siirtää tyyliä tai parantaa vahingoittuneen kuvan yksityiskohtia. Anna yhdestä kolmeen kuvaa ja yksi selkeä muokkausohje. Kuvien numerointi noudattaa annettua järjestystä, joten määrittele, mikä kuva antaa kohteen, mikä vaatteen tai esineen ja mikä ympäristön. Pyydä tuotekohtauksessa sijoittamaan kuvan 1 objekti kuvan 2 ympäristöön säilyttäen tuotteen tunnistettavat ominaisuudet. Ilmaise muutokset ja säilyttämisvaatimukset selkeästi.

Kyseinen kuvasyötteen työnkulku hyväksyy JPG-, JPEG-, PNG-, BMP-, TIFF-, WebP- ja GIF-muodot; animoidusta GIF-kuvasta käsitellään vain ensimmäinen ruutu. Kukin kuva saa olla enintään 10 MB. Nykyinen API hyväksyy mitat väliltä 1–8 000 pikseliä, kun pitkän ja lyhyen sivun suhde on enintään 10:1, ja suosittelee hyvään tulokseen 384–2 048 pikseliä. Valitse syöte, josta siirrettävät tai muokattavat yksityiskohdat näkyvät selvästi. Tiukasti rajattu viitekuva voi peittää ympäröivän rakenteen, jota tarvitaan objektin luonnolliseen sijoittamiseen.

Tulokset ovat PNG-kuvia, joita tuotetaan yhdestä kuuteen pyyntöä kohti, oletuksena yksi. Tuloksen pikselipinta-ala on välillä 512 × 512 ja 2 048 × 2 048, ja kuvasuhteet välillä 1:8 ja 8:1. Nämä ovat pinta-alarajoja, eivät sääntö, jonka mukaan jokainen sivu saa olla enintään 2 048 pikseliä. Jos kokoa ei anneta, malli suosittelee tarkkuutta kehotteen perusteella. Valitse käyttötarkoitukseen vaakasuuntainen, neliömäinen tai pystysuuntainen sommittelu ja tarkastele sitten palautettua kuvaa sen todellisessa koossa, jotta pienet tekstit ja hienot yksityiskohdat voidaan arvioida siinä, missä ne näkyvät.

Kehotteen uudelleenkirjoitus on valmistajan työnkulussa oletuksena käytössä. Suora parantaminen toimii sekä luonnissa että muokkauksessa; agentin avulla tehtävä parantaminen on kehittyneempi uudelleenkirjoitustila vain tekstistä kuvaksi luontiin, ja se hylätään kuvasta kuvaan muokkauksessa. Päättely on oletuksena käytössä, edellyttää kehotteen uudelleenkirjoitusta ja pidentää luontiaikaa. Negatiivisilla kehotteilla voi kuvata ei-toivottuja elementtejä, ja kiinteä seed-arvo auttaa vertailemaan muunnelmia. Ilmaise poissulut ja täsmälliset säilyttämisvaatimukset selvästi sen sijaan, että odottaisit seed-arvon tuottavan saman kuvan tehtävänannon muuttuessa.

Hyödyllistä lopputulosta varten tarkista renderöidyt sanat, yksiköt, paneelien järjestys ja kohteen tunnistettavat yksityiskohdat. Korjaa sitten juuri se osa, joka ei vastannut tehtävänantoa. Usean kuvan vastaus tarjoaa vertailtavia vaihtoehtoja; säilytä jokaisen palautetun kuvan yhteys sen tuottaneeseen kehotteeseen ja viitekuviin. Valmistajan kuvaosoitteet vanhenevat 24 tunnin kuluttua, joten säilytä varsinainen kuvatiedosto, kun tulos tulee osaksi projektia. Vakioversio 3.0 pysyy erillään Pro-versiosta ja Qwen 2.1 -malleista, joiden viitekuvamäärät ja läpinäkyvyysominaisuudet ovat erilaisia.

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

qwen/qwen-image-3

Alibaba /qwen/qwen-image-3

Aloitus

Hyväksytyt syötteet: Teksti · Kuvat
Tulokset: Kuvat

Saatavilla Ailootissa · syötteet & menetelmät

Ailoot Ultra · Kuvat POST /v1/images/generations

Syötetyypit: text, image
Tulostyypit: image

Kenttä	Tyyppi	Vaatimus	Arvot & rajat	Oletus
Kenttä`model`	Tyyppi`string`	VaatimusPakollinen	Arvot & rajat qwen/qwen-image-3	Oletus—
Kenttä`prompt`	Tyyppi`string`	VaatimusPakollinen	Arvot & rajat Vähimmäispituus: 1	Oletus—
Kenttä`resolution`	Tyyppi`string`	VaatimusValinnainen	Arvot & rajat 1K, 2K	Oletus—
Kenttä`aspect_ratio`	Tyyppi`string`	VaatimusValinnainen	Arvot & rajat 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	Oletus—
Kenttä`n`	Tyyppi`integer`	VaatimusValinnainen	Arvot & rajat Vähimmäismäärä: 1 Enimmäismäärä: 6	Oletus—
Kenttä`input_references`	Tyyppi`array`	VaatimusValinnainen	Arvot & rajat Kohteiden vähimmäismäärä: 0 Kohteiden enimmäismäärä: 4	Oletus—
Kenttä`provider`	Tyyppi`object`	VaatimusValinnainen	Arvot & rajat	Oletus—

Menetelmän parametrit ja elinkaari

Parametri	Sopimus
Parametri`content_type`	Sopimusapplication/json
Parametri`required`	Sopimusmodel, prompt
Parametri`material_types`	Sopimustext, image

Elinkaari: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · todellisuudessa palautettu task_id tai mediakirjaston tietue

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

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Hinnoittelu

Lopullisen veloituksen laskenta

Näytettyjen hintojen avulla arvioidaan kustannukset ennen generointia. Lopullinen veloitus lasketaan alkuperäiselle generoinnille kirjatun kustannuksen perusteella. Lopullisena laskutettavana määränä ei käytetä tulosteen mitattua kestoa eikä ennustettuja määriä.

Hintatiedot eivät lisää pyyntövalintoja. Tuetut parametrit on lueteltu valitulle menetelmälle.

Nopea tila: Ei määritetty Kun nopea tila on valittu
Flex-tila: Ei määritetty Kun flex-tila on valittu
Päättelyn enimmäisteho: Ei määritetty Kun päättelyn enimmäistehoon sovelletaan default-oletussäätöä

Arvioidut vertailuhinnat

Hinnat asetusten mukaan

Kohdista kukin veloitus näytettyihin ehtoihin. Käytä yhtä hintaa kutakin vaihtoehtoisten asetusten ryhmää kohden.

Asetukset	Hinnasto	Ennustettu määrä	Laskutusyksikkö	Veloitus
AsetuksetTokenien perushinnat	HinnastoPerushinta	Ennustettu määrä—	Laskutusyksikkö—	Veloitus Syöte · Syötetokenit · Arvio vain vertailua varten — / 1K tokenia Tuloste · Tulostokenit · Arvio vain vertailua varten — / 1K tokenia Syöte · Välimuistin luku · Arvio vain vertailua varten — / 1K tokenia Syöte · Välimuistiin kirjoitus · Arvio vain vertailua varten — / 1K tokenia Syöte · Välimuistiin kirjoitus, 1 tunti · Arvio vain vertailua varten — / 1K tokenia
Asetuksetsyötekuva	Hinnasto—	Ennustettu määrä—	Laskutusyksikkösyötekuvaa kohden	Veloitus Syöte · syötekuva · Arvio vain vertailua varten $0.006 syötekuvaa kohden
AsetuksetArvioitu luontikustannus	Hinnasto—	Ennustettu määräyhden generoinnin arvio	Laskutusyksikkö—	Veloitus Tuloste · Arvioidut generointikustannukset · Arvio vain vertailua varten $0.06 arvio ennen generointia Tämä arvio ei ole lisämaksu eikä valmistuneen generoinnin kiinteä hinta.

Ailoot varaa arvioidun summan ennen pyyntöä. Tuloksen jälkeen lopullinen veloitus toteutetaan mitatun käytön perusteella. Suoratoiston veloituksessa käytetään lopullista käyttötietuetta. Varauksen ja lopullisen veloituksen toiminta →

Esimerkkipyynnöt

Ailoot Ultra · Kuvat

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

Vastaanota ja tallenna tulokset

Ailoot Ultra · Kuvat

Lataa jokainen palautettu kuva tai tallenna sen Base64-sisältö

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

Muut sisällön lukukerrat

Lue olemassa olevat omistamasi aineistot

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.

Säilytä kaikki valmistuneet tulokset

Tallenna jokainen valmistunut kuva; nouda jokainen palautettu URL tai pura sen Base64-sisältö.

Säilytä koko vastaus ja otsakkeet, jokainen todellinen tuloste, alkuperäiset palautetut tunnisteet ja kaikki käyttötietokentät. Selvitä alkuperäisen operaation tila lähettämättä luontipyyntöä uudelleen.

Jos alkuperäinen vastaus on tarkistettava

Säilytä palautettu X-Client-Request-ID täsmäytystä varten. Tee lukukyselyt vain todellisuudessa palautetuilla task_id/asset_id-arvoilla tai käytä omistamaasi mediakirjastoa; älä koskaan rakenna tehtävän URL-osoitetta operaation ID:n perusteella äläkä lähetä luontipyyntöä uudelleen.

Vastauksen kentät

Kenttä	Tyyppi
Kenttä`created`	Tyyppi
Kenttä`data[].url`	Tyyppi
Kenttä`data[].b64_json`	Tyyppi
Kenttä`usage`	Tyyppi

Aliakset

Mallin aliakset

Ailoot Ultra qwen/qwen-image-3

Menetelmäpolkujen aliakset

/v1/images

Liittyvät kutsujan ID:t

qwen/qwen-image-3

FAQ · Qwen: Qwen Image 3

Mitä syötteitä ja tuloksia on saatavilla?: POST /v1/images/generations · qwen/qwen-image-3: text, image → image
Mitä kenttiä pyyntö käyttää?: POST /v1/images/generations · qwen/qwen-image-3: model, prompt, resolution, aspect_ratio, n, input_references, provider
Mitä rajoja sovelletaan?: POST /v1/images/generations · qwen/qwen-image-3: n.minimum: 1; n.maximum: 6

Qwen: Qwen Image 3

Qwen: Qwen Image 3

Aloitus

Saatavilla Ailootissa · syötteet & menetelmät

Hinnoittelu

Lopullisen veloituksen laskenta

Arvioidut vertailuhinnat

Hinnat asetusten mukaan

Esimerkkipyynnöt

Ailoot Ultra · Kuvat

Vastaanota ja tallenna tulokset

Ailoot Ultra · Kuvat

Säilytä kaikki valmistuneet tulokset

Jos alkuperäinen vastaus on tarkistettava

Aliakset

Mallin aliakset

Menetelmäpolkujen aliakset

Liittyvät kutsujan ID:t

Yritys ja sen projektisalkku

Osta tokenit alennuksella.

Yhdistä API tuotteeseen, jonka myyt.