Qwen: Qwen Image 3 Pro

Qwen-Image-3.0 Pro je Qwenov vodilni model za generiranje in urejanje slik s kompleksnimi postavitvami, realističnimi podrobnostmi in večjezičnim besedilom. Z natančnimi navodili ali eno do tremi referencami ustvarite grafiko, prizor z izdelkom ali ciljno vizualno spremembo.

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

O modelu

Ta opis zajema zmožnosti modela. Vhodi, izhodi in možnosti, ki so na voljo v Ailoot, so spodaj navedeni za izbrano metodo.

Qwen-Image-3.0 Pro je Qwenov vodilni model tretje generacije za generiranje in urejanje slik. Združuje ustvarjanje kompleksnih postavitev, podrobnih realističnih tekstur, večjezične tipografije in natančno sledenje navodilom za sliko. Pro in standardni Qwen-Image-3.0 imata iste dokumentirane načine generiranja in urejanja; Pro poudarja kakovost slike, standardna izdaja pa uravnoteža kakovost in hitrost. Rezultat je izrisana slika.

Pri grafiki z veliko informacijami pred videzom določite vsebino: naslov, spremljevalno besedilo, številčne podatke, hierarhijo in povezave med razdelki. Uporabna navodila za izdelek lahko na enem platnu združijo glavni predmet, bližnje posnetke podrobnosti materiala in označene lastnosti. Pri izobraževalni ilustraciji določite pojem, strukturo diagrama in natančne napise, namesto da bi se zanašali na model, da si izmisli osnovna dejstva. Kompleksne postavitve lahko prikazujejo tudi več plošč ali gnezdene vmesnike. Poziv naj v okviru priporočene največje dolžine 4.500 žetonov ostane osredotočen na to, kaj mora biti prikazano in kam sodi.

Družina 3.0 podpira izvorno tipografijo v 12 jezikih, več pisav in več kot 100 umetniških slogov ter drobne teksture, kot so lasje, koža ali tkanina. Prikaz majhnega besedila je demonstriran tudi pri velikosti le 10 pikslov. To omogoča oblikovanje, ki združi črke s fizičnim materialom ali besedilo z realističnimi podobami. Podajte natančno besedilo, številke in jezik ter opišite tipografsko vlogo vsakega bloka. Časopisna stran ali maketa vmesnika je še vedno slika, zato je poznejša urejljiva postavitev ali interaktivno vedenje ločen izdelek, ki ga je treba zgraditi na njeni podlagi.

Pro lahko ureja besedilo znotraj slike, dodaja, briše ali premika elemente, spreminja dejanje subjekta, prenaša vizualni slog in izboljšuje podrobnosti. Urejanje sprejme eno do tri vhodne slike z navodilom. Njihov vrstni red določa sliko 1, sliko 2 in sliko 3 v navodilih. Navedite, katera referenca določa identiteto subjekta, katera prinaša predmet ali oblačilo in katera okolje ali pozo. Ciljna sprememba navede tako želeno spremembo kot lastnosti, ki morajo ostati nedotaknjene, kar olajša primerjavo nastale slike z referencami.

Podprti vhodi so JPG, JPEG, PNG, BMP, TIFF, WebP in GIF, pri animiranih GIF pa se uporabi samo prvi kader. Vsaka vhodna slika je lahko velika do 10 MB. Ta API sprejema stranice od 1 do 8.000 pikslov in razmerje med daljšo in krajšo stranico, ki ne presega 10:1; priporočeni razpon je 384–2.048 pikslov. Vodnik za urejanje ločeno priporoča slike do 3.072 pikslov, zato izbiro vhoda obravnavajte kot pripravo na potrebne podrobnosti, ne kot obljubo, da vsaka ločljivost izboljša rezultat. Za drobno besedilo ali značilnosti materiala uporabite čitljivo referenco z ustreznim izrezom.

Izhodi so PNG. Proizvajalčev potek dela vrne eno do šest različic, privzeto eno, in podpira skupno površino pikslov od 512 × 512 do 2.048 × 2.048 z razmerji stranic od 1:8 do 8:1. Omejitev površine pikslov dopušča nekatere nekvadratne dimenzije, katerih daljša stranica presega 2.048 pikslov. Če velikost ni določena, model priporoči ločljivost na podlagi navodil. Izberite obliko za dejansko mesto uporabe, nato pa generirane različice primerjajte glede na popolnost vsebine, podrobnosti subjekta in tipografijo pri predvideni velikosti prikaza.

Inteligentno preoblikovanje poziva je privzeto omogočeno. Neposredna izboljšava je na voljo tako za generiranje kot za urejanje, agentska izboljšava pa izpopolnjuje pozive za pretvorbo besedila v sliko in je ni mogoče uporabiti za urejanje slike v sliko. Thinking je prav tako privzeto omogočen in zahteva preoblikovanje poziva; dodaja sklepanje in čas generiranja. Negativni pozivi določajo neželene elemente, neobvezno seme pa lahko pripomore k bolj doslednim primerjavam različic. Jasen pozitiven opis naj še vedno določi subjekt, kompozicijo in podrobnosti, ki jih je treba ohraniti.

Praktični pregled rezultata preveri natančno besedilo, številke, vrstni red branja, zvestobo referencam ter robove ali teksture, pomembne za oblikovanje. Ko je treba popraviti določen del, ohranite uspešno kompozicijo in opišite ciljno spremembo. Vse izbrane slike shranite skupaj s pozivom in referencami, saj proizvajalčeve lokacije izhodov potečejo po 24 urah. Dokumentirani načini in omejitve Pro pripadajo izdaji 3.0; podpora za deset referenc in izvorna prosojnost, opisani za Qwen 2.1, sta zmožnosti ločene izdaje.

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

qwen/qwen-image-3-pro

Alibaba /qwen/qwen-image-3-pro

Začetek

Dovoljeni vhodi: Besedilo · Slike
Rezultati: Slike

Na voljo v Ailoot · vhodi in metode

Ailoot Ultra · Slike POST /v1/images/generations

Vhod: text, image
Izhod: image

Polje	Vrsta	Zahteva	Vrednosti in omejitve	Privzeto
Polje`model`	Vrsta`string`	ZahtevaObvezno	Vrednosti in omejitve qwen/qwen-image-3-pro	Privzeto—
Polje`prompt`	Vrsta`string`	ZahtevaObvezno	Vrednosti in omejitve Najmanjša dolžina: 1	Privzeto—
Polje`resolution`	Vrsta`string`	ZahtevaIzbirno	Vrednosti in omejitve 1K, 2K	Privzeto—
Polje`aspect_ratio`	Vrsta`string`	ZahtevaIzbirno	Vrednosti in omejitve 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	Privzeto—
Polje`n`	Vrsta`integer`	ZahtevaIzbirno	Vrednosti in omejitve Najmanj: 1 Največ: 6	Privzeto—
Polje`input_references`	Vrsta`array`	ZahtevaIzbirno	Vrednosti in omejitve Najmanjše število elementov: 0 Največ elementov: 4	Privzeto—
Polje`provider`	Vrsta`object`	ZahtevaIzbirno	Vrednosti in omejitve	Privzeto—

Parametri in življenjski cikel metode

Parameter	Specifikacija
Parameter`content_type`	Specifikacijaapplication/json
Parameter`required`	Specifikacijamodel, prompt
Parameter`material_types`	Specifikacijatext, image

Življenjski cikel: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · Dejansko vrnjeni task_id ali zapis v medijski knjižnici

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

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Cenik

Kako se izračuna končni strošek

Prikazane cene so namenjene oceni stroškov pred generiranjem. Končni znesek se izračuna na podlagi stroška, zabeleženega za izvirno generiranje. Izmerjeno trajanje izhoda in napovedane količine niso končna obračunska količina.

Tarifni podatki ne dodajajo možnosti zahteve. Podprti parametri so navedeni pri izbrani metodi.

Hitri način: Ni navedeno Ko je izbran hitri način
Način flex: Ni navedeno Ko je izbran način flex
Najvišja raven razmišljanja: Ni navedeno Ko najvišja raven razmišljanja uporablja privzeto prilagoditev (default)

Ocenjene cene za primerjavo

Cene po nastavitvah

Vsak strošek povežite s prikazanimi pogoji. Za vsak nabor alternativnih nastavitev uporabite eno ceno.

Nastavitev	Cenovna lestvica	Predvidena količina	Obračunska enota	Strošek
NastavitevOsnovne cene žetonov	Cenovna lestvicaOsnovna cena	Predvidena količina—	Obračunska enota—	Strošek Vhod · Vhodni žetoni · Ocena samo za primerjavo — / 1K žetonov Izhod · Izhodni žetoni · Ocena samo za primerjavo — / 1K žetonov Vhod · Branje predpomnilnika · Ocena samo za primerjavo — / 1K žetonov Vhod · Zapis v predpomnilnik · Ocena samo za primerjavo — / 1K žetonov Vhod · Zapis v predpomnilnik, 1 ura · Ocena samo za primerjavo — / 1K žetonov
Nastavitevvhodna slika	Cenovna lestvica—	Predvidena količina—	Obračunska enotana vhodno sliko	Strošek Vhod · vhodna slika · Ocena samo za primerjavo $0.006 na vhodno sliko
NastavitevOcenjeni strošek ustvarjanja	Cenovna lestvica—	Predvidena količinaocena za eno generiranje	Obračunska enota—	Strošek Izhod · Ocenjeni stroški ustvarjanja · Ocena samo za primerjavo $0.08 ocena pred ustvarjanjem Ta ocena ni dodatno plačilo ali fiksna cena za dokončano generiranje.

Ailoot pred zahtevo rezervira ocenjeni znesek. Po rezultatu obračuna končni strošek na podlagi izmerjene porabe. Obračun pretakanja uporablja končni zapis porabe. Kako delujeta rezervacija in obračun →

Primeri zahtev

Ailoot Ultra · Slike

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

Prejmi in shrani rezultate

Ailoot Ultra · Slike

Prenesite vsako vrnjeno sliko ali shranite njeno vsebino Base64

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

Branje druge vsebine

Preberi obstoječa gradiva, ki vam pripadajo

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.

Ohrani vse dokončane rezultate

Shranite vsako dokončano sliko; pridobite vsebino z vsake vrnjene URL ali dekodirajte njeno vsebino Base64.

Shranite celoten odgovor in glave, vse dejanske izhode, izvirne vrnjene identifikatorje in vsa polja s podatki o porabi. Pridobite podatke izvirne operacije brez ponovnega pošiljanja zahteve za ustvarjanje.

Če je treba preveriti izvirni odgovor

Shranite vrnjeni X-Client-Request-ID za uskladitev evidenc. Berite samo dejansko vrnjene vrednosti task_id/asset_id ali svojo medijsko knjižnico; iz ID operacije nikoli ne sestavite URL opravila in zahteve za ustvarjanje nikoli ne pošljite znova.

Polja odgovora

Polje	Vrsta
Polje`created`	Vrsta
Polje`data[].url`	Vrsta
Polje`data[].b64_json`	Vrsta
Polje`usage`	Vrsta

Druga imena

Druga imena modelov

Ailoot Ultra qwen/qwen-image-3-pro

Druga imena poti metod

/v1/images

Povezani ID-ji za klic

qwen/qwen-image-3-pro

FAQ · Qwen: Qwen Image 3 Pro

Kateri vhodi in rezultati so na voljo?: POST /v1/images/generations · qwen/qwen-image-3-pro: text, image → image
Katera polja uporablja zahteva?: POST /v1/images/generations · qwen/qwen-image-3-pro: model, prompt, resolution, aspect_ratio, n, input_references, provider
Katere omejitve veljajo?: POST /v1/images/generations · qwen/qwen-image-3-pro: n.minimum: 1; n.maximum: 6

Qwen: Qwen Image 3 Pro