Qwen-Image-3.0 je Qwenov slikovni model tretje generacije, ki v enem modelu združuje ustvarjanje slik iz besedila in urejanje na podlagi referenčnih slik. Standardna izdaja uravnoteži kakovost slike in hitrost odziva, Qwen-Image-3.0 Pro pa je vodilna sorodna izdaja, usmerjena v kakovost. Zahteva ustvari sliko: plakat, ilustrirano razlago, prizor z izdelkom, snemalno knjigo ali popravljeno fotografijo, ne pa dokumenta, ki ga je mogoče urejati, ali delujočega vmesnika.
Njegove zmožnosti za bogato vsebino so primerne za platno z več povezanimi razdelki ali vgnezdeno vizualno postavitev. Pred dodajanjem slogovnih podrobnosti pripravite naslove, natančno besedilo, hierarhijo in razmerja med polji. Pri primerjavi izdelkov uporaben opis določa glavni pogled na izdelek, lastnosti, ki jih je treba označiti, in vrstni red branja podpornih polj. Pri snemalni knjigi ločeno opišite motiv, dejanje in napis vsakega polja. Priporočena največja dolžina poziva je 4.500 žetonov; ta prostor namenite vsebini in postavitvi, ki ju slika dejansko potrebuje.
Model podpira podrobne teksture, tipografijo do majhnega besedila, prikazanega pri velikosti 10 slikovnih pik, ter neposreden izris v 12 jezikih z več pisavami in umetniškimi slogi. Te zmožnosti omogočajo združevanje realističnega predmeta z informacijsko bogato grafiko, namesto da bi morali izbirati med fotografijo in postavitvijo z veliko besedila. Navedite natančne besede in številke za izris, predvideni jezik in njihovo mesto. Ustvarjeni vmesnik obravnavajte kot vizualno maketo: gumbi, grafikoni in oznake na sliki ne izvajajo funkcij aplikacije.
Z urejanjem lahko spremenite besedilo, dodate ali odstranite predmete, premaknete elemente, prilagodite dejanje subjekta, prenesete slog ali izboljšate podrobnosti poškodovane slike. Priložite eno do tri slike in eno jasno navodilo za urejanje. Številčenje slik sledi vrstnemu redu vnosa, zato določite, katera slika prispeva subjekt, katera oblačilo ali predmet in katera okolje. Pri prizoru z izdelkom zahtevajte, naj bo predmet s slike 1 postavljen v okolje s slike 2, ob tem pa naj se ohranijo značilnosti, po katerih se izdelek razlikuje od drugih. Jasno navedite spremembe in zahteve glede ohranitve.
Postopek vnosa slik za to izdajo sprejema JPG, JPEG, PNG, BMP, TIFF, WebP in GIF; pri animiranem GIF-u se obdela le prva sličica. Vsaka slika je lahko velika do 10 MB. Trenutni API sprejema dimenzije od 1 do 8.000 slikovnih pik z razmerjem med daljšo in krajšo stranico največ 10:1, za dobre rezultate pa priporoča 384–2.048 slikovnih pik. Izberite vhodno sliko, na kateri so podrobnosti za prenos ali urejanje jasno vidne. Tesno obrezana referenčna slika lahko skrije okoliško strukturo, ki je potrebna za naravno umestitev predmeta.
Izhodni format je PNG, število slik na zahtevo je od ene do šestih, privzeto pa ena. Površina izhodne slike v slikovnih pikah je v razponu od 512 × 512 do 2.048 × 2.048, z razmerjem stranic med 1:8 in 8:1; to so omejitve površine in ne pravilo, da sme vsaka stranica meriti največ 2.048 slikovnih pik. Če velikost ni navedena, model predlaga ločljivost na podlagi poziva. Za predvideno uporabo izberite ležečo, kvadratno ali pokončno kompozicijo, nato pa vrnjeno sliko preglejte pri njeni dejanski velikosti, da lahko majhne oznake in drobne podrobnosti ocenite tam, kjer bodo prikazane.
V proizvajalčevem postopku je preoblikovanje poziva privzeto omogočeno. Neposredna izboljšava deluje pri ustvarjanju in urejanju; agentska izboljšava je podrobnejši način preoblikovanja le za ustvarjanje slik iz besedila, pri urejanju slike na podlagi slike pa je zavrnjena. Razmišljanje je privzeto omogočeno, zahteva preoblikovanje poziva in podaljša čas ustvarjanja. Negativni pozivi lahko opišejo neželene elemente, fiksno seme pa pomaga pri primerjavi različic. Jasno navedite izključitve in natančne zahteve glede ohranitve, namesto da bi pričakovali, da bo zaradi semena spremenjen opis vrnil enako sliko.
Za uporaben končni izdelek preverite izrisane besede, enote, vrstni red polj in podrobnosti, ki opredeljujejo subjekt, nato pa popravite določen del, ki ni ustrezal opisu. Odziv z več slikami ponuja možnosti za primerjavo; vsako vrnjeno sliko povežite s pozivom in referenčnimi slikami, iz katerih je nastala. Proizvajalčeve lokacije slik potečejo po 24 urah, zato dejansko slikovno datoteko shranite, ko rezultat postane del projekta. Standardna izdaja 3.0 je ločena od Pro in od modelov Qwen 2.1 z drugačnim številom referenčnih slik in drugačnimi funkcijami prosojnosti.
", "aboutText": "Qwen-Image-3.0 je Qwenov slikovni model tretje generacije, ki v enem modelu združuje ustvarjanje slik iz besedila in urejanje na podlagi referenčnih slik. Standardna izdaja uravnoteži kakovost slike in hitrost odziva, Qwen-Image-3.0 Pro pa je vodilna sorodna izdaja, usmerjena v kakovost. Zahteva ustvari sliko: plakat, ilustrirano razlago, prizor z izdelkom, snemalno knjigo ali popravljeno fotografijo, ne pa dokumenta, ki ga je mogoče urejati, ali delujočega vmesnika.\n\nNjegove zmožnosti za bogato vsebino so primerne za platno z več povezanimi razdelki ali vgnezdeno vizualno postavitev. Pred dodajanjem slogovnih podrobnosti pripravite naslove, natančno besedilo, hierarhijo in razmerja med polji. Pri primerjavi izdelkov uporaben opis določa glavni pogled na izdelek, lastnosti, ki jih je treba označiti, in vrstni red branja podpornih polj. Pri snemalni knjigi ločeno opišite motiv, dejanje in napis vsakega polja. Priporočena največja dolžina poziva je 4.500 žetonov; ta prostor namenite vsebini in postavitvi, ki ju slika dejansko potrebuje.\n\nModel podpira podrobne teksture, tipografijo do majhnega besedila, prikazanega pri velikosti 10 slikovnih pik, ter neposreden izris v 12 jezikih z več pisavami in umetniškimi slogi. Te zmožnosti omogočajo združevanje realističnega predmeta z informacijsko bogato grafiko, namesto da bi morali izbirati med fotografijo in postavitvijo z veliko besedila. Navedite natančne besede in številke za izris, predvideni jezik in njihovo mesto. Ustvarjeni vmesnik obravnavajte kot vizualno maketo: gumbi, grafikoni in oznake na sliki ne izvajajo funkcij aplikacije.\n\nZ urejanjem lahko spremenite besedilo, dodate ali odstranite predmete, premaknete elemente, prilagodite dejanje subjekta, prenesete slog ali izboljšate podrobnosti poškodovane slike. Priložite eno do tri slike in eno jasno navodilo za urejanje. Številčenje slik sledi vrstnemu redu vnosa, zato določite, katera slika prispeva subjekt, katera oblačilo ali predmet in katera okolje. Pri prizoru z izdelkom zahtevajte, naj bo predmet s slike 1 postavljen v okolje s slike 2, ob tem pa naj se ohranijo značilnosti, po katerih se izdelek razlikuje od drugih. Jasno navedite spremembe in zahteve glede ohranitve.\n\nPostopek vnosa slik za to izdajo sprejema JPG, JPEG, PNG, BMP, TIFF, WebP in GIF; pri animiranem GIF-u se obdela le prva sličica. Vsaka slika je lahko velika do 10 MB. Trenutni API sprejema dimenzije od 1 do 8.000 slikovnih pik z razmerjem med daljšo in krajšo stranico največ 10:1, za dobre rezultate pa priporoča 384–2.048 slikovnih pik. Izberite vhodno sliko, na kateri so podrobnosti za prenos ali urejanje jasno vidne. Tesno obrezana referenčna slika lahko skrije okoliško strukturo, ki je potrebna za naravno umestitev predmeta.\n\nIzhodni format je PNG, število slik na zahtevo je od ene do šestih, privzeto pa ena. Površina izhodne slike v slikovnih pikah je v razponu od 512 × 512 do 2.048 × 2.048, z razmerjem stranic med 1:8 in 8:1; to so omejitve površine in ne pravilo, da sme vsaka stranica meriti največ 2.048 slikovnih pik. Če velikost ni navedena, model predlaga ločljivost na podlagi poziva. Za predvideno uporabo izberite ležečo, kvadratno ali pokončno kompozicijo, nato pa vrnjeno sliko preglejte pri njeni dejanski velikosti, da lahko majhne oznake in drobne podrobnosti ocenite tam, kjer bodo prikazane.\n\nV proizvajalčevem postopku je preoblikovanje poziva privzeto omogočeno. Neposredna izboljšava deluje pri ustvarjanju in urejanju; agentska izboljšava je podrobnejši način preoblikovanja le za ustvarjanje slik iz besedila, pri urejanju slike na podlagi slike pa je zavrnjena. Razmišljanje je privzeto omogočeno, zahteva preoblikovanje poziva in podaljša čas ustvarjanja. Negativni pozivi lahko opišejo neželene elemente, fiksno seme pa pomaga pri primerjavi različic. Jasno navedite izključitve in natančne zahteve glede ohranitve, namesto da bi pričakovali, da bo zaradi semena spremenjen opis vrnil enako sliko.\n\nZa uporaben končni izdelek preverite izrisane besede, enote, vrstni red polj in podrobnosti, ki opredeljujejo subjekt, nato pa popravite določen del, ki ni ustrezal opisu. Odziv z več slikami ponuja možnosti za primerjavo; vsako vrnjeno sliko povežite s pozivom in referenčnimi slikami, iz katerih je nastala. Proizvajalčeve lokacije slik potečejo po 24 urah, zato dejansko slikovno datoteko shranite, ko rezultat postane del projekta. Standardna izdaja 3.0 je ločena od Pro in od modelov Qwen 2.1 z drugačnim številom referenčnih slik in drugačnimi funkcijami prosojnosti.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "a7ca7bf4bdca2b6dd0297fb397b8959a0a8f69e66906bfaf9f58a5a0d4cf1d22", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "sl", "methods": [ { "html": "qwen/qwen-image-3Qwen-Image-3.0 združuje ustvarjanje in urejanje slik za postavitve z veliko informacijami, podrobne prizore in večjezično tipografijo. Standardna izdaja uravnoteži kakovost in hitrost ter sprejme besedilni opis ali do tri slike z navodilom za urejanje.
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 je Qwenov slikovni model tretje generacije, ki v enem modelu združuje ustvarjanje slik iz besedila in urejanje na podlagi referenčnih slik. Standardna izdaja uravnoteži kakovost slike in hitrost odziva, Qwen-Image-3.0 Pro pa je vodilna sorodna izdaja, usmerjena v kakovost. Zahteva ustvari sliko: plakat, ilustrirano razlago, prizor z izdelkom, snemalno knjigo ali popravljeno fotografijo, ne pa dokumenta, ki ga je mogoče urejati, ali delujočega vmesnika.
Njegove zmožnosti za bogato vsebino so primerne za platno z več povezanimi razdelki ali vgnezdeno vizualno postavitev. Pred dodajanjem slogovnih podrobnosti pripravite naslove, natančno besedilo, hierarhijo in razmerja med polji. Pri primerjavi izdelkov uporaben opis določa glavni pogled na izdelek, lastnosti, ki jih je treba označiti, in vrstni red branja podpornih polj. Pri snemalni knjigi ločeno opišite motiv, dejanje in napis vsakega polja. Priporočena največja dolžina poziva je 4.500 žetonov; ta prostor namenite vsebini in postavitvi, ki ju slika dejansko potrebuje.
Model podpira podrobne teksture, tipografijo do majhnega besedila, prikazanega pri velikosti 10 slikovnih pik, ter neposreden izris v 12 jezikih z več pisavami in umetniškimi slogi. Te zmožnosti omogočajo združevanje realističnega predmeta z informacijsko bogato grafiko, namesto da bi morali izbirati med fotografijo in postavitvijo z veliko besedila. Navedite natančne besede in številke za izris, predvideni jezik in njihovo mesto. Ustvarjeni vmesnik obravnavajte kot vizualno maketo: gumbi, grafikoni in oznake na sliki ne izvajajo funkcij aplikacije.
Z urejanjem lahko spremenite besedilo, dodate ali odstranite predmete, premaknete elemente, prilagodite dejanje subjekta, prenesete slog ali izboljšate podrobnosti poškodovane slike. Priložite eno do tri slike in eno jasno navodilo za urejanje. Številčenje slik sledi vrstnemu redu vnosa, zato določite, katera slika prispeva subjekt, katera oblačilo ali predmet in katera okolje. Pri prizoru z izdelkom zahtevajte, naj bo predmet s slike 1 postavljen v okolje s slike 2, ob tem pa naj se ohranijo značilnosti, po katerih se izdelek razlikuje od drugih. Jasno navedite spremembe in zahteve glede ohranitve.
Postopek vnosa slik za to izdajo sprejema JPG, JPEG, PNG, BMP, TIFF, WebP in GIF; pri animiranem GIF-u se obdela le prva sličica. Vsaka slika je lahko velika do 10 MB. Trenutni API sprejema dimenzije od 1 do 8.000 slikovnih pik z razmerjem med daljšo in krajšo stranico največ 10:1, za dobre rezultate pa priporoča 384–2.048 slikovnih pik. Izberite vhodno sliko, na kateri so podrobnosti za prenos ali urejanje jasno vidne. Tesno obrezana referenčna slika lahko skrije okoliško strukturo, ki je potrebna za naravno umestitev predmeta.
Izhodni format je PNG, število slik na zahtevo je od ene do šestih, privzeto pa ena. Površina izhodne slike v slikovnih pikah je v razponu od 512 × 512 do 2.048 × 2.048, z razmerjem stranic med 1:8 in 8:1; to so omejitve površine in ne pravilo, da sme vsaka stranica meriti največ 2.048 slikovnih pik. Če velikost ni navedena, model predlaga ločljivost na podlagi poziva. Za predvideno uporabo izberite ležečo, kvadratno ali pokončno kompozicijo, nato pa vrnjeno sliko preglejte pri njeni dejanski velikosti, da lahko majhne oznake in drobne podrobnosti ocenite tam, kjer bodo prikazane.
V proizvajalčevem postopku je preoblikovanje poziva privzeto omogočeno. Neposredna izboljšava deluje pri ustvarjanju in urejanju; agentska izboljšava je podrobnejši način preoblikovanja le za ustvarjanje slik iz besedila, pri urejanju slike na podlagi slike pa je zavrnjena. Razmišljanje je privzeto omogočeno, zahteva preoblikovanje poziva in podaljša čas ustvarjanja. Negativni pozivi lahko opišejo neželene elemente, fiksno seme pa pomaga pri primerjavi različic. Jasno navedite izključitve in natančne zahteve glede ohranitve, namesto da bi pričakovali, da bo zaradi semena spremenjen opis vrnil enako sliko.
Za uporaben končni izdelek preverite izrisane besede, enote, vrstni red polj in podrobnosti, ki opredeljujejo subjekt, nato pa popravite določen del, ki ni ustrezal opisu. Odziv z več slikami ponuja možnosti za primerjavo; vsako vrnjeno sliko povežite s pozivom in referenčnimi slikami, iz katerih je nastala. Proizvajalčeve lokacije slik potečejo po 24 urah, zato dejansko slikovno datoteko shranite, ko rezultat postane del projekta. Standardna izdaja 3.0 je ločena od Pro in od modelov Qwen 2.1 z drugačnim številom referenčnih slik in drugačnimi funkcijami prosojnosti.
POST /v1/images/generationstext, imageimage| Polje | Vrsta | Zahteva | Vrednosti in omejitve | Privzeto |
|---|---|---|---|---|
Poljemodel | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve qwen/qwen-image-3 | Privzeto— |
Poljeprompt | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve Najmanjša dolžina: 1 | Privzeto— |
Poljeresolution | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve 1K, 2K | Privzeto— |
Poljeaspect_ratio | Vrstastring | 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— |
Poljen | Vrstainteger | ZahtevaIzbirno | Vrednosti in omejitve Najmanj: 1 Največ: 6 | Privzeto— |
Poljeinput_references | Vrstaarray | ZahtevaIzbirno | Vrednosti in omejitve Najmanjše število elementov: 0 Največ elementov: 4 | Privzeto— |
Poljeprovider | Vrstaobject | ZahtevaIzbirno | Vrednosti in omejitve | Privzeto— |
| Parameter | Specifikacija |
|---|---|
Parametercontent_type | Specifikacijaapplication/json |
Parameterrequired | Specifikacijamodel, prompt |
Parametermaterial_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}
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.
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.06 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 →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np={'model': 'qwen/qwen-image-3', 'prompt': 'a red panda astronaut floating in space, studio lighting'}\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit("No completed images; retain the full response")\n for index, item in enumerate(items):\n encoded=item.get("b64_json")\n uri=item.get("url", "")\n if not encoded and uri.startswith("data:image/"):\n header, separator, encoded=uri.partition(",")\n if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin("https://api.ailoot.ai",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit("Invalid returned image URL")\n owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",uri]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n temporary=Path(f"image-{index}.bin")\n subprocess.run(args+["-o",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit("Image has neither bytes nor URL")\n if not raw: raise SystemExit("Empty image result")\n 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"\n Path(f"image-{index}.{ext}").write_bytes(raw)\n print("Every returned image saved; complete response metadata retained")\nsave_images(json.loads(Path("result.json").read_text())["data"])\nPY_RESULT\nPrenesite vsako vrnjeno sliko ali shranite njeno vsebino Base64
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json\n# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.\nShranite 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.
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.
| Polje | Vrsta |
|---|---|
Poljecreated | Vrsta |
Poljedata[].url | Vrsta |
Poljedata[].b64_json | Vrsta |
Poljeusage | Vrsta |
Ailoot Ultra qwen/qwen-image-3
/v1/images