Source: https://ailoot.ai/models/fi/qwen-qwen-image-3-pro/
Canonical: https://ailoot.ai/models/fi/qwen-qwen-image-3-pro/
Language: fi

# Qwen: Qwen Image 3 Pro

[Markdown](https://ailoot.ai/models/fi/qwen-qwen-image-3-pro/index.md) · [JSON](https://ailoot.ai/models/fi/qwen-qwen-image-3-pro/facts.json)

## [Qwen: Qwen Image 3 Pro](https://ailoot.ai/models/fi/qwen-qwen-image-3-pro/)

Qwen-Image-3.0 Pro on Qwenin lippulaivamalli kuvien generointiin ja muokkaukseen, monimutkaisiin asetteluihin, realistisiin yksityiskohtiin ja monikieliseen tekstiin. Käytä tarkkaa tehtävänantoa tai yhdestä kolmeen viitekuvaa grafiikan, tuotenäkymän tai kohdennetun kuvamuokkauksen luomiseen.

- [**Ailoot Ultra · Kuvat** `POST /v1/images/generations` `qwen/qwen-image-3-pro`](https://ailoot.ai/models/fi/qwen-qwen-image-3-pro/#method-0)

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 Pro on Qwenin kolmannen sukupolven lippulaivamalli kuvien generointiin ja muokkaukseen. Se yhdistää monimutkaiset asettelut, yksityiskohtaiset realistiset tekstuurit, monikielisen typografian ja kuvatehtävänannon tarkan seuraamisen. Pro ja tavallinen Qwen-Image-3.0 jakavat dokumentoidut generointi- ja muokkaustilat; Pro painottaa kuvanlaatua, kun taas tavallinen versio tasapainottaa laatua ja nopeutta. Tulos on renderöity kuva.

Tietorikkaassa grafiikassa määritä sisältö ennen ulkoasua: otsikko, tukiteksti, luvut, hierarkia ja osioiden väliset suhteet. Hyödyllinen tuotetehtävänanto voi yhdistää pääkohteen, materiaalien lähikuvayksityiskohdat ja merkityt ominaisuudet samalle kuvapinnalle. Opetuskuvituksessa määritä käsite, diagrammin rakenne ja tarkat kuvatekstit sen sijaan, että antaisit mallin keksiä taustalla olevat faktat. Monimutkaiset asettelut voivat myös sisältää useita paneeleita tai sisäkkäisiä käyttöliittymiä. Pidä suositeltu 4 500 tokenin kehotteen enimmäispituus kohdennettuna siihen, mitä pitää näkyä ja missä.

3.0-perhe tukee natiivia typografiaa 12 kielellä, useita fontteja ja yli 100 taiteellista tyyliä sekä hienoja tekstuureja, kuten hiuksia, ihoa ja kangasta. Pienen tekstin piirtämistä on esitelty jopa 10 pikselin koossa. Tämä tukee kirjainten yhdistämistä fyysiseen materiaaliin tai tekstin yhdistämistä realistisiin kuviin. Anna tarkka sanamuoto, numerot ja kieli ja kuvaa kunkin tekstilohkon typografinen rooli. Sanomalehtisivu tai käyttöliittymäluonnos on edelleen kuva, joten myöhempi muokattava asettelu tai interaktiivinen toiminta on erillinen sen pohjalta rakennettava tulos.

Pro voi muokata kuvan tekstiä, lisätä, poistaa tai siirtää elementtejä, muuttaa kohteen toimintaa, siirtää visuaalista tyyliä ja parantaa yksityiskohtia. Muokkaus vastaanottaa yhdestä kolmeen syötekuvaa ohjeen kanssa. Järjestys määrittää tehtävänannon kuvan 1, kuvan 2 ja kuvan 3. Kerro, mikä viite antaa kohteen identiteetin, mikä objektin tai vaatteet ja mikä ympäristön tai asennon. Kohdennettu muokkaus nimeää sekä halutun muutoksen että ennallaan säilytettävät ominaisuudet, mikä helpottaa tuloskuvan vertailua viitteisiin.

Tuetut syötemuodot ovat JPG, JPEG, PNG, BMP, TIFF, WebP ja GIF; animoiduista GIF-tiedostoista käytetään vain ensimmäistä ruutua. Kukin syötekuva voi olla enintään 10 MB. Tarkka API hyväksyy sivupituudet 1–8 000 pikseliä ja pitkän ja lyhyen sivun suhteen enintään 10:1; sen suositusalue on 384–2 048 pikseliä. Muokkausopas suosittelee erikseen enintään 3 072 pikselin kuvia, joten käsittele syötevalintaa tarvittavan yksityiskohtaisuuden valmisteluna, älä lupauksena siitä, että jokainen resoluutio parantaa tulosta. Käytä pienelle tekstille tai materiaalin ominaisuuksille luettavaa ja riittävän hyvin rajattua viitettä.

Tulosteet ovat PNG-kuvia. Valmistajan työnkulku palauttaa yhdestä kuuteen vaihtoehtoa, oletuksena yhden, ja tukee kokonaispikselipinta-alaa 512 × 512:stä 2 048 × 2 048:aan kuvasuhteilla 1:8–8:1. Pikselipinta-alan budjetti sallii joitakin ei-neliömäisiä kokoja, joiden pidempi sivu ylittää 2 048 pikseliä. Jos kokoa ei määritetä, malli suosittelee resoluutiota tehtävänannon perusteella. Valitse muoto todellisen sijoituspaikan mukaan ja vertaa sitten generoitujen vaihtoehtojen sisällön kattavuutta, kohteen yksityiskohtia ja typografiaa aiotussa näyttökoossa.

Älykäs kehotteen uudelleenkirjoitus on oletusarvoisesti käytössä. Suora tehostus on saatavilla sekä generointiin että muokkaukseen, kun taas agenttitehostus tarkentaa tekstistä kuvaksi -kehotteita eikä sovellu kuvasta kuvaksi -muokkaukseen. Thinking on myös oletusarvoisesti käytössä ja edellyttää kehotteen uudelleenkirjoitusta; se lisää päättelytyötä ja generointiaikaa. Negatiiviset kehotteet nimeävät ei-toivotut elementit, ja valinnainen seed voi tehdä varianttien vertailusta johdonmukaisempaa. Selkeän myönteisen tehtävänannon tulee silti määrittää kohde, sommittelu ja säilytettävät yksityiskohdat.

Käytännön tulostarkistus tarkistaa tarkan tekstin, numerot, lukujärjestyksen, viiteuskollisuuden sekä suunnittelulle tärkeät reunat tai tekstuurit. Kun tietty osa tarvitsee muutosta, säilytä onnistunut sommittelu ja kuvaa kohdennettu muutos. Tallenna kaikki valitut kuvat kehotteineen ja viitteineen, koska valmistajan tulosten sijainnit vanhenevat 24 tunnin kuluttua. Pron dokumentoidut tilat ja rajat kuuluvat 3.0-versioon; Qwen 2.1:lle kuvatut kymmenen viitteen tuki ja natiivi läpinäkyvyys ovat erillisen version kykyjä.

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

[`qwen/qwen-image-3-pro`](https://ailoot.ai/models/fi/#m=qwen%2Fqwen-image-3-pro&route=Ultra&caller=qwen%2Fqwen-image-3-pro&fmt=images)

Alibaba /`qwen/qwen-image-3-pro`

### Aloitus

Qwen-Image-3.0 Pro on Qwenin lippulaivamalli kuvien generointiin ja muokkaukseen, monimutkaisiin asetteluihin, realistisiin yksityiskohtiin ja monikieliseen tekstiin. Käytä tarkkaa tehtävänantoa tai yhdestä kolmeen viitekuvaa grafiikan, tuotenäkymän tai kohdennetun kuvamuokkauksen luomiseen.

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-pro | 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.08** 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 →](https://ailoot.ai/docs/fi/billing/reserve/)

### Esimerkkipyynnöt

#### Ailoot Ultra · Kuvat

curl

```bash
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
```

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

```bash
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-pro`](https://ailoot.ai/models/fi/#m=qwen%2Fqwen-image-3-pro&route=Ultra&caller=qwen%2Fqwen-image-3-pro&fmt=images)

#### Menetelmäpolkujen aliakset

`/v1/images`

#### Liittyvät kutsujan ID:t

[`qwen/qwen-image-3-pro`](https://ailoot.ai/models/fi/#m=qwen%2Fqwen-image-3-pro&route=Ultra&caller=qwen%2Fqwen-image-3-pro&fmt=images)

FAQ · Qwen: Qwen Image 3 Pro

Mitä syötteitä ja tuloksia on saatavilla?

`POST /v1/images/generations` · `qwen/qwen-image-3-pro`: `text`, `image` → `image`

Mitä kenttiä pyyntö käyttää?

`POST /v1/images/generations` · `qwen/qwen-image-3-pro`: `model`, `prompt`, `resolution`, `aspect_ratio`, `n`, `input_references`, `provider`

Mitä rajoja sovelletaan?

`POST /v1/images/generations` · `qwen/qwen-image-3-pro`: `n.minimum`: `1`; `n.maximum`: `6`

Yhdistä Ailoot Claude Codeen, OpenCodeen, Hermesiin tai omaan sovellukseesi.

## Yritys ja sen projektisalkku

Yritys ja sen projektisalkku: miljoonia asiakkaita; kuukausittainen myynti miljardiluokassa.

## Osta tokenit alennuksella.

Tilausalennus säännölliseen käyttöön. Kampanjakoodit — jopa 50% tokeniostoista.

Tilaus

Valitse alennushintainen paketti säännöllisiä pyyntöjäsi varten.

Kampanjakoodi jopa 50%

Syötä koodi oston yhteydessä. Hinta lasketaan uudelleen voimassa olevan kampanjan mukaan.

Kulut historiassa

Malli, tokenit ja summa tallennetaan jokaiselle pyynnölle.

[Valitse tilaus](https://ailoot.ai/docs/fi/billing/subscriptions/) · [Katso mallihinnat](https://ailoot.ai/models/fi/)

## Yhdistä API tuotteeseen, jonka myyt.

SaaS, sovellukset ja botit Ailootin palveluehtojen ja lisenssisopimuksen mukaisesti. Pyydä edelleenmyyntiin jälleenmyyjälisenssi.

Kaupallinen sovellus

Lisää tekstin, kuvien, videoiden ja äänen luonti palvelusi maksullisiin ominaisuuksiin.

Jälleenmyyjälisenssi

Lähetä projektikuvaus ja pääsyn toteutustapa. Pyydä kirjalliset käyttö- ja jälleenmyyntiehdot.

Asiakirjat verkkosivustolla

Palveluehdot, lisenssisopimus ja tietojenkäsittelykäytäntö ovat saatavilla ennen yhdistämistä.

[Pyydä jälleenmyyjälisenssi](mailto:support@ailoot.ai) · [Palveluehdot ja lisenssisopimus](https://ailoot.ai/legal/offer?lang=fi)

## Ailoot · Yritys ja sen projektisalkku





Ailoot perustuu kertyneeseen toimintakokemukseen, laajaan asiakaskuntaan, vakaaseen palveluun ja jatkuvaan KPI-seurantaan.





Yritys ja sen projektisalkku: miljoonia asiakkaita; kuukausittainen myynti miljardiluokassa.





Ailoot hyödyntää tätä toimintakokemusta tarjotessaan API-yhteyden tekoälytoimintoihin asiakkaiden tuotteissa, agenteissa, sovelluksissa ja automaatioissa.
