Qwen-Image-3.0-Pro je model družbe Alibaba za ustvarjanje in urejanje slik, pri katerih so pomembni kompozicija, napisi in drobne podrobnosti. Njegova področja uporabe vključujejo goste postavitve, sliko v sliki, časopisni prelom, snemalne knjige, jedilnike in učne liste. Trenutna kartica Ailoot predstavlja način ustvarjanja slike na podlagi besedilnega navodila. Alibaba predvideva tudi urejanje in delo z referenčnimi slikami; ti operaciji zahtevata ločeno podporo vhodnim slikam in nista predstavljeni v trenutnem načinu dostopa na kartici.
Proizvajalec izpostavlja dolga navodila do 4,5 tisoč tokenov, napise v 12 jezikih in delo z več pisavami. To je opisana zmožnost obdelave navodila in ne objavljena velikost formalnega kontekstnega okna. Med navedenimi lastnostmi so prikaz drobnih napisov velikosti 10 slikovnih pik, teksture kože in las ter majhnih sprememb obraznega izraza. Takšne podrobnosti so koristne pri pripravi gradiva, ki si ga ogledujemo od blizu.
Qwen-Image-3.0-Pro je namenjen tudi vizualnim konceptom spletnih strani, iger in zaslonov prenosov v živo. Takšen rezultat lahko združi ilustracijo, strukturo zaslona in oblikovane napise. Model ustvari sliko postavitve; delujoča aplikacija zahteva ločeno izvedbo.
Alibaba za način urejanja navaja od ene do treh slik. Pri tem načinu proizvajalec omogoča povezavo objekta s številko reference in opis kombinacije gradiva. Predvideni so dodajanje, odstranjevanje in premikanje objektov ter spreminjanje dogajanja, sloga, podrobnosti in besedila. Negativni opis pomaga opredeliti neželene elemente.
Proizvajalec v načinu urejanja sprejema vhodno gradivo v formatih JPG, JPEG, PNG, BMP, TIFF, WEBP in GIF. Pri animiranem GIF se uporabi prvi kader. Velikost posamezne datoteke je do 10 MB; proizvajalec priporoča slike s stranicami od 384 do 3072 slikovnih pik. To so priporočila za vhod in ne mere končnega rezultata.
Specifikacija proizvajalca predvideva od ene do šest izhodnih slik v formatu PNG na zahtevo. Površina rezultata je od 262 144 do 4 194 304 slikovnih pik, kar ustreza kvadratnim slikam od 512 × 512 do 2048 × 2048. Dovoljena so razmerja stranic od 1:8 do 8:1, zato je pri podolgovati kompoziciji dolžina stranice odvisna tudi od izbrane oblike kadra. Predvideno je dodatno preoblikovanje navodila pred ustvarjanjem.
", "aboutText": "Qwen-Image-3.0-Pro je model družbe Alibaba za ustvarjanje in urejanje slik, pri katerih so pomembni kompozicija, napisi in drobne podrobnosti. Njegova področja uporabe vključujejo goste postavitve, sliko v sliki, časopisni prelom, snemalne knjige, jedilnike in učne liste. Trenutna kartica Ailoot predstavlja način ustvarjanja slike na podlagi besedilnega navodila. Alibaba predvideva tudi urejanje in delo z referenčnimi slikami; ti operaciji zahtevata ločeno podporo vhodnim slikam in nista predstavljeni v trenutnem načinu dostopa na kartici.\n\n### Besedilo in podrobnosti v sliki\n\nProizvajalec izpostavlja dolga navodila do 4,5 tisoč tokenov, napise v 12 jezikih in delo z več pisavami. To je opisana zmožnost obdelave navodila in ne objavljena velikost formalnega kontekstnega okna. Med navedenimi lastnostmi so prikaz drobnih napisov velikosti 10 slikovnih pik, teksture kože in las ter majhnih sprememb obraznega izraza. Takšne podrobnosti so koristne pri pripravi gradiva, ki si ga ogledujemo od blizu.\n\nQwen-Image-3.0-Pro je namenjen tudi vizualnim konceptom spletnih strani, iger in zaslonov prenosov v živo. Takšen rezultat lahko združi ilustracijo, strukturo zaslona in oblikovane napise. Model ustvari sliko postavitve; delujoča aplikacija zahteva ločeno izvedbo.\n\n### Urejanje v specifikaciji družbe Alibaba\n\nAlibaba za način urejanja navaja od ene do treh slik. Pri tem načinu proizvajalec omogoča povezavo objekta s številko reference in opis kombinacije gradiva. Predvideni so dodajanje, odstranjevanje in premikanje objektov ter spreminjanje dogajanja, sloga, podrobnosti in besedila. Negativni opis pomaga opredeliti neželene elemente.\n\nProizvajalec v načinu urejanja sprejema vhodno gradivo v formatih JPG, JPEG, PNG, BMP, TIFF, WEBP in GIF. Pri animiranem GIF se uporabi prvi kader. Velikost posamezne datoteke je do 10 MB; proizvajalec priporoča slike s stranicami od 384 do 3072 slikovnih pik. To so priporočila za vhod in ne mere končnega rezultata.\n\nSpecifikacija proizvajalca predvideva od ene do šest izhodnih slik v formatu PNG na zahtevo. Površina rezultata je od 262 144 do 4 194 304 slikovnih pik, kar ustreza kvadratnim slikam od 512 × 512 do 2048 × 2048. Dovoljena so razmerja stranic od 1:8 do 8:1, zato je pri podolgovati kompoziciji dolžina stranice odvisna tudi od izbrane oblike kadra. Predvideno je dodatno preoblikovanje navodila pred ustvarjanjem.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "934d9f33cbf6c66f56d03d85cd2576e9f834826ed0e4e293ab9065936784c054", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "sl", "methods": [ { "html": "qwen-image-3.0-proModel za ustvarjanje slik iz besedila s poudarkom na zahtevnih postavitvah, napisih in realističnih podrobnostih. Primeren je za plakate, snemalne knjige, jedilnike in gradivo z gosto kompozicijo.
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 model družbe Alibaba za ustvarjanje in urejanje slik, pri katerih so pomembni kompozicija, napisi in drobne podrobnosti. Njegova področja uporabe vključujejo goste postavitve, sliko v sliki, časopisni prelom, snemalne knjige, jedilnike in učne liste. Trenutna kartica Ailoot predstavlja način ustvarjanja slike na podlagi besedilnega navodila. Alibaba predvideva tudi urejanje in delo z referenčnimi slikami; ti operaciji zahtevata ločeno podporo vhodnim slikam in nista predstavljeni v trenutnem načinu dostopa na kartici.
Proizvajalec izpostavlja dolga navodila do 4,5 tisoč tokenov, napise v 12 jezikih in delo z več pisavami. To je opisana zmožnost obdelave navodila in ne objavljena velikost formalnega kontekstnega okna. Med navedenimi lastnostmi so prikaz drobnih napisov velikosti 10 slikovnih pik, teksture kože in las ter majhnih sprememb obraznega izraza. Takšne podrobnosti so koristne pri pripravi gradiva, ki si ga ogledujemo od blizu.
Qwen-Image-3.0-Pro je namenjen tudi vizualnim konceptom spletnih strani, iger in zaslonov prenosov v živo. Takšen rezultat lahko združi ilustracijo, strukturo zaslona in oblikovane napise. Model ustvari sliko postavitve; delujoča aplikacija zahteva ločeno izvedbo.
Alibaba za način urejanja navaja od ene do treh slik. Pri tem načinu proizvajalec omogoča povezavo objekta s številko reference in opis kombinacije gradiva. Predvideni so dodajanje, odstranjevanje in premikanje objektov ter spreminjanje dogajanja, sloga, podrobnosti in besedila. Negativni opis pomaga opredeliti neželene elemente.
Proizvajalec v načinu urejanja sprejema vhodno gradivo v formatih JPG, JPEG, PNG, BMP, TIFF, WEBP in GIF. Pri animiranem GIF se uporabi prvi kader. Velikost posamezne datoteke je do 10 MB; proizvajalec priporoča slike s stranicami od 384 do 3072 slikovnih pik. To so priporočila za vhod in ne mere končnega rezultata.
Specifikacija proizvajalca predvideva od ene do šest izhodnih slik v formatu PNG na zahtevo. Površina rezultata je od 262 144 do 4 194 304 slikovnih pik, kar ustreza kvadratnim slikam od 512 × 512 do 2048 × 2048. Dovoljena so razmerja stranic od 1:8 do 8:1, zato je pri podolgovati kompoziciji dolžina stranice odvisna tudi od izbrane oblike kadra. Predvideno je dodatno preoblikovanje navodila pred ustvarjanjem.
POST /v1/images/generationstextimage| Polje | Vrsta | Zahteva | Vrednosti in omejitve | Privzeto |
|---|---|---|---|---|
Poljemodel | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve qwen-image-3.0-pro | Privzeto— |
Poljeprompt | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve Najmanjša dolžina: 1 | Privzeto— |
Poljen | Vrstainteger | ZahtevaIzbirno | Vrednosti in omejitve Najmanj: 1 | Privzeto1 |
Poljeresponse_format | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve url, b64_json | Privzeto— |
Poljestream | Vrstaboolean | ZahtevaIzbirno | Vrednosti in omejitve | Privzetofalse |
Poljesize | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljepartial_images | Vrstainteger | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljeimages[].image_url | Vrstastring | ZahtevaNi podprto | Vrednosti in omejitve Največ dekodiranih bajtov: 10.485.760 Vrste MIME: image/png, image/jpeg Največ slik na polje: 3 Pogoji: En dejanski URL na objekt images[]. Število elementov polja je ločeno od te listne vrednosti niza. Velja, ko: Samo JSON images/edits; JSON images/generations ne razčleni referenc images. | Privzeto— |
Poljeimage | Vrstafile | ZahtevaIzbirno | Vrednosti in omejitve Največ dekodiranih bajtov: 10.485.760 Vrste MIME: image/png, image/jpeg Velja, ko: ustvarjanje prek multipart/form-data | Privzeto— |
Poljeimage[] | Vrstafile[] | ZahtevaIzbirno | Vrednosti in omejitve Največ elementov: 3 Največ dekodiranih bajtov: 10.485.760 Vrste MIME: image/png, image/jpeg Velja, ko: ustvarjanje prek multipart/form-data | Privzeto— |
Iz besedila v sliko · Obvezno: prompt
reference_images_generation · Obvezno: prompt
| Parameter | Specifikacija |
|---|---|
Parametermaterial_types | Specifikacijatext |
Parameterrequired | Specifikacijamodel, prompt |
Parameteroptional_controls | Specifikacijanull |
Parametercontent_type | Specifikacijaapplication/json |
Ž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}
Strukture metod in ID so natančno določeni; zmožnost ponudnika je ločena od sprejema zahteve.
POST /v1/images/generationsAiloot 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\nexport AILOOT_API_KEY\n: "${AILOOT_PROMPT_FILE:?Set your actual UTF-8 image brief}"\nexport AILOOT_PROMPT_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "qwen-image-3.0-pro", "prompt": ""}')\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Choose your actual UTF-8 brief")\np['prompt']=f.read_text(encoding="utf-8")\nif not p['prompt'].strip():raise SystemExit("Brief must contain text")\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\nfrom openai import OpenAI\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")\n\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Set your actual UTF-8 image brief file")\nrequest={'model': 'qwen-image-3.0-pro', 'prompt': ''}\nrequest["prompt"]=f.read_text(encoding="utf-8")\nclient=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)\nresult=client.images.generate(**request)\nPath("sdk-result.txt").write_text(str(result),encoding="utf-8")\nsave_images([{"b64_json":getattr(item,"b64_json",None),"url":getattr(item,"url",None)} for item in result.data])\nimport OpenAI from "openai";\nimport { readFileSync, writeFileSync } from "node:fs";\nconst key=process.env.AILOOT_API_KEY;\nif(!key) throw new Error("Set your actual Ailoot API key");\nconst client=new OpenAI({baseURL:"https://api.ailoot.ai/v1",apiKey:key,maxRetries:0});\nconst request={"model": "qwen-image-3.0-pro", "prompt": ""};\nif(!process.env.AILOOT_PROMPT_FILE)throw new Error("Set your actual UTF-8 image brief file");\nrequest.prompt=readFileSync(process.env.AILOOT_PROMPT_FILE,"utf8");\nconst result=await client.images.generate(request);\nwriteFileSync("sdk-result.json",JSON.stringify(result,null,2));\nif(!result.data?.length) throw new Error("No completed images");\nfor(let index=0;index<result.data.length;index++) {\n const item=result.data[index];let encoded=item.b64_json,uri=item.url||"",raw;\n if(!encoded && uri.startsWith("data:image/")) {\n const comma=uri.indexOf(",");if(comma<0 || !uri.slice(0,comma).includes(";base64")) throw new Error("Unsupported image data URI");\n encoded=uri.slice(comma+1);\n }\n if(encoded) {\n if(encoded.length%4!==0 || !/^[A-Za-z0-9+/]*={0,2}$/.test(encoded)) throw new Error("Invalid Base64");\n raw=Buffer.from(encoded,"base64");\n } else if(uri) {\n const u=new URL(uri,"https://api.ailoot.ai");\n if(u.protocol!=="https:" || u.username || u.password) throw new Error("Invalid returned URL");\n const owned=u.origin==="https://api.ailoot.ai" && u.pathname.startsWith("/v1/media/assets/") && u.pathname.endsWith("/content");\n const response=await fetch(u,{headers:owned?{Authorization:"Bearer "+key}:{},redirect:"manual"});\n if(!response.ok) throw new Error("Image content download failed: "+response.status);\n raw=Buffer.from(await response.arrayBuffer());\n } else throw new Error("Image has neither bytes nor URL");\n if(!raw.length) throw new Error("Empty image result");\n const ext=raw.subarray(0,4).equals(Buffer.from([137,80,78,71]))?"png":raw[0]===255&&raw[1]===216?"jpg":raw.toString("ascii",0,4)==="RIFF"&&raw.toString("ascii",8,12)==="WEBP"?"webp":raw.toString("utf8").trimStart().startsWith("<svg")||raw.toString("utf8").trimStart().startsWith("<?xml")?"svg":"bin";\n writeFileSync(`image-${index}.${ext}`,raw);\n}\nconsole.log("Every returned image saved; sdk-result.json retains complete metadata");\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}Shranite vsako dokončano sliko; pridobite vsebino z vsake vrnjene URL ali dekodirajte njeno vsebino Base64.
Shranite vsak podatkovni element. Dekodirajte vsak b64_json ali pridobite vsebino z vsakega vrnjenega podpisanega URL. Končnico imena datoteke izberite glede na dejanski tip MIME oziroma bajte.
Če je treba preveriti rezultat generiranja ali urejanja slike, shranite izvirni operation_id/X-Client-Request-ID in vrnjene podatke o rezultatu. Obstoječe rezultate, ki vam pripadajo, pridobite prek medijske knjižnice z dejanskimi vrednostmi task_id ali asset_id. Zahteve za generiranje/urejanje ne pošiljajte znova in iz operation_id ne sestavljajte URL za periodično preverjanje stanja.
| Polje | Vrsta |
|---|---|
Poljecreated | Vrstainteger |
Poljedata[].url | Vrstastring |
Poljedata[].b64_json | Vrstabase64 string |
Poljeusage | Vrstaobject |
| Odgovor | Pogoj | Naslednji korak |
|---|---|---|
Odgovor400 · invalid_request_error | PogojNeveljavna obvezna polja, predstavitev gradiva ali vrednost parametra | Naslednji korakPred novo zahtevo za ustvarjanje popravite navedena polja. |
Odgovorserver_error | PogojVrnjeni odgovor navaja, da je treba operacijo ali rezultat preveriti | Naslednji korakShranite izvirni vrnjeni ID operacije/opravila, glave zahteve in odgovor; nadaljujte s podprtimi branji te izvirne operacije. Zahteve za ustvarjanje ne pošiljajte znova. |
Ailoot qwen-image-3.0-pro, qwen-image, qwen-image-latest
Uporabite zgoraj navedene poti metod.
qwen-imageModel za ustvarjanje slik iz besedila s poudarkom na zahtevnih postavitvah, napisih in realističnih podrobnostih. Primeren je za plakate, snemalne knjige, jedilnike in gradivo z gosto kompozicijo.
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 model družbe Alibaba za ustvarjanje in urejanje slik, pri katerih so pomembni kompozicija, napisi in drobne podrobnosti. Njegova področja uporabe vključujejo goste postavitve, sliko v sliki, časopisni prelom, snemalne knjige, jedilnike in učne liste. Trenutna kartica Ailoot predstavlja način ustvarjanja slike na podlagi besedilnega navodila. Alibaba predvideva tudi urejanje in delo z referenčnimi slikami; ti operaciji zahtevata ločeno podporo vhodnim slikam in nista predstavljeni v trenutnem načinu dostopa na kartici.
Proizvajalec izpostavlja dolga navodila do 4,5 tisoč tokenov, napise v 12 jezikih in delo z več pisavami. To je opisana zmožnost obdelave navodila in ne objavljena velikost formalnega kontekstnega okna. Med navedenimi lastnostmi so prikaz drobnih napisov velikosti 10 slikovnih pik, teksture kože in las ter majhnih sprememb obraznega izraza. Takšne podrobnosti so koristne pri pripravi gradiva, ki si ga ogledujemo od blizu.
Qwen-Image-3.0-Pro je namenjen tudi vizualnim konceptom spletnih strani, iger in zaslonov prenosov v živo. Takšen rezultat lahko združi ilustracijo, strukturo zaslona in oblikovane napise. Model ustvari sliko postavitve; delujoča aplikacija zahteva ločeno izvedbo.
Alibaba za način urejanja navaja od ene do treh slik. Pri tem načinu proizvajalec omogoča povezavo objekta s številko reference in opis kombinacije gradiva. Predvideni so dodajanje, odstranjevanje in premikanje objektov ter spreminjanje dogajanja, sloga, podrobnosti in besedila. Negativni opis pomaga opredeliti neželene elemente.
Proizvajalec v načinu urejanja sprejema vhodno gradivo v formatih JPG, JPEG, PNG, BMP, TIFF, WEBP in GIF. Pri animiranem GIF se uporabi prvi kader. Velikost posamezne datoteke je do 10 MB; proizvajalec priporoča slike s stranicami od 384 do 3072 slikovnih pik. To so priporočila za vhod in ne mere končnega rezultata.
Specifikacija proizvajalca predvideva od ene do šest izhodnih slik v formatu PNG na zahtevo. Površina rezultata je od 262 144 do 4 194 304 slikovnih pik, kar ustreza kvadratnim slikam od 512 × 512 do 2048 × 2048. Dovoljena so razmerja stranic od 1:8 do 8:1, zato je pri podolgovati kompoziciji dolžina stranice odvisna tudi od izbrane oblike kadra. Predvideno je dodatno preoblikovanje navodila pred ustvarjanjem.
POST /v1/images/generationstextimage| Polje | Vrsta | Zahteva | Vrednosti in omejitve | Privzeto |
|---|---|---|---|---|
Poljemodel | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve qwen-image | Privzeto— |
Poljeprompt | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve Najmanjša dolžina: 1 | Privzeto— |
Poljen | Vrstainteger | ZahtevaIzbirno | Vrednosti in omejitve Najmanj: 1 | Privzeto1 |
Poljeresponse_format | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve url, b64_json | Privzeto— |
Poljestream | Vrstaboolean | ZahtevaIzbirno | Vrednosti in omejitve | Privzetofalse |
Poljesize | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljepartial_images | Vrstainteger | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljeimages[].image_url | Vrstastring | ZahtevaNi podprto | Vrednosti in omejitve Največ dekodiranih bajtov: 10.485.760 Vrste MIME: image/png, image/jpeg Največ slik na polje: 3 Pogoji: En dejanski URL na objekt images[]. Število elementov polja je ločeno od te listne vrednosti niza. Velja, ko: Samo JSON images/edits; JSON images/generations ne razčleni referenc images. | Privzeto— |
Poljeimage | Vrstafile | ZahtevaIzbirno | Vrednosti in omejitve Največ dekodiranih bajtov: 10.485.760 Vrste MIME: image/png, image/jpeg Velja, ko: ustvarjanje prek multipart/form-data | Privzeto— |
Poljeimage[] | Vrstafile[] | ZahtevaIzbirno | Vrednosti in omejitve Največ elementov: 3 Največ dekodiranih bajtov: 10.485.760 Vrste MIME: image/png, image/jpeg Velja, ko: ustvarjanje prek multipart/form-data | Privzeto— |
Iz besedila v sliko · Obvezno: prompt
reference_images_generation · Obvezno: prompt
| Parameter | Specifikacija |
|---|---|
Parametermaterial_types | Specifikacijatext |
Parameterrequired | Specifikacijamodel, prompt |
Parameteroptional_controls | Specifikacijanull |
Parametercontent_type | Specifikacijaapplication/json |
Ž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}
Strukture metod in ID so natančno določeni; zmožnost ponudnika je ločena od sprejema zahteve.
POST /v1/images/generationsAiloot 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\nexport AILOOT_API_KEY\n: "${AILOOT_PROMPT_FILE:?Set your actual UTF-8 image brief}"\nexport AILOOT_PROMPT_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "qwen-image", "prompt": ""}')\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Choose your actual UTF-8 brief")\np['prompt']=f.read_text(encoding="utf-8")\nif not p['prompt'].strip():raise SystemExit("Brief must contain text")\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\nfrom openai import OpenAI\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")\n\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Set your actual UTF-8 image brief file")\nrequest={'model': 'qwen-image', 'prompt': ''}\nrequest["prompt"]=f.read_text(encoding="utf-8")\nclient=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)\nresult=client.images.generate(**request)\nPath("sdk-result.txt").write_text(str(result),encoding="utf-8")\nsave_images([{"b64_json":getattr(item,"b64_json",None),"url":getattr(item,"url",None)} for item in result.data])\nimport OpenAI from "openai";\nimport { readFileSync, writeFileSync } from "node:fs";\nconst key=process.env.AILOOT_API_KEY;\nif(!key) throw new Error("Set your actual Ailoot API key");\nconst client=new OpenAI({baseURL:"https://api.ailoot.ai/v1",apiKey:key,maxRetries:0});\nconst request={"model": "qwen-image", "prompt": ""};\nif(!process.env.AILOOT_PROMPT_FILE)throw new Error("Set your actual UTF-8 image brief file");\nrequest.prompt=readFileSync(process.env.AILOOT_PROMPT_FILE,"utf8");\nconst result=await client.images.generate(request);\nwriteFileSync("sdk-result.json",JSON.stringify(result,null,2));\nif(!result.data?.length) throw new Error("No completed images");\nfor(let index=0;index<result.data.length;index++) {\n const item=result.data[index];let encoded=item.b64_json,uri=item.url||"",raw;\n if(!encoded && uri.startsWith("data:image/")) {\n const comma=uri.indexOf(",");if(comma<0 || !uri.slice(0,comma).includes(";base64")) throw new Error("Unsupported image data URI");\n encoded=uri.slice(comma+1);\n }\n if(encoded) {\n if(encoded.length%4!==0 || !/^[A-Za-z0-9+/]*={0,2}$/.test(encoded)) throw new Error("Invalid Base64");\n raw=Buffer.from(encoded,"base64");\n } else if(uri) {\n const u=new URL(uri,"https://api.ailoot.ai");\n if(u.protocol!=="https:" || u.username || u.password) throw new Error("Invalid returned URL");\n const owned=u.origin==="https://api.ailoot.ai" && u.pathname.startsWith("/v1/media/assets/") && u.pathname.endsWith("/content");\n const response=await fetch(u,{headers:owned?{Authorization:"Bearer "+key}:{},redirect:"manual"});\n if(!response.ok) throw new Error("Image content download failed: "+response.status);\n raw=Buffer.from(await response.arrayBuffer());\n } else throw new Error("Image has neither bytes nor URL");\n if(!raw.length) throw new Error("Empty image result");\n const ext=raw.subarray(0,4).equals(Buffer.from([137,80,78,71]))?"png":raw[0]===255&&raw[1]===216?"jpg":raw.toString("ascii",0,4)==="RIFF"&&raw.toString("ascii",8,12)==="WEBP"?"webp":raw.toString("utf8").trimStart().startsWith("<svg")||raw.toString("utf8").trimStart().startsWith("<?xml")?"svg":"bin";\n writeFileSync(`image-${index}.${ext}`,raw);\n}\nconsole.log("Every returned image saved; sdk-result.json retains complete metadata");\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}Shranite vsako dokončano sliko; pridobite vsebino z vsake vrnjene URL ali dekodirajte njeno vsebino Base64.
Shranite vsak podatkovni element. Dekodirajte vsak b64_json ali pridobite vsebino z vsakega vrnjenega podpisanega URL. Končnico imena datoteke izberite glede na dejanski tip MIME oziroma bajte.
Če je treba preveriti rezultat generiranja ali urejanja slike, shranite izvirni operation_id/X-Client-Request-ID in vrnjene podatke o rezultatu. Obstoječe rezultate, ki vam pripadajo, pridobite prek medijske knjižnice z dejanskimi vrednostmi task_id ali asset_id. Zahteve za generiranje/urejanje ne pošiljajte znova in iz operation_id ne sestavljajte URL za periodično preverjanje stanja.
| Polje | Vrsta |
|---|---|
Poljecreated | Vrstainteger |
Poljedata[].url | Vrstastring |
Poljedata[].b64_json | Vrstabase64 string |
Poljeusage | Vrstaobject |
| Odgovor | Pogoj | Naslednji korak |
|---|---|---|
Odgovor400 · invalid_request_error | PogojNeveljavna obvezna polja, predstavitev gradiva ali vrednost parametra | Naslednji korakPred novo zahtevo za ustvarjanje popravite navedena polja. |
Odgovorserver_error | PogojVrnjeni odgovor navaja, da je treba operacijo ali rezultat preveriti | Naslednji korakShranite izvirni vrnjeni ID operacije/opravila, glave zahteve in odgovor; nadaljujte s podprtimi branji te izvirne operacije. Zahteve za ustvarjanje ne pošiljajte znova. |
Ailoot qwen-image-3.0-pro, qwen-image, qwen-image-latest
Uporabite zgoraj navedene poti metod.
qwen-image-latestModel za ustvarjanje slik iz besedila s poudarkom na zahtevnih postavitvah, napisih in realističnih podrobnostih. Primeren je za plakate, snemalne knjige, jedilnike in gradivo z gosto kompozicijo.
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 model družbe Alibaba za ustvarjanje in urejanje slik, pri katerih so pomembni kompozicija, napisi in drobne podrobnosti. Njegova področja uporabe vključujejo goste postavitve, sliko v sliki, časopisni prelom, snemalne knjige, jedilnike in učne liste. Trenutna kartica Ailoot predstavlja način ustvarjanja slike na podlagi besedilnega navodila. Alibaba predvideva tudi urejanje in delo z referenčnimi slikami; ti operaciji zahtevata ločeno podporo vhodnim slikam in nista predstavljeni v trenutnem načinu dostopa na kartici.
Proizvajalec izpostavlja dolga navodila do 4,5 tisoč tokenov, napise v 12 jezikih in delo z več pisavami. To je opisana zmožnost obdelave navodila in ne objavljena velikost formalnega kontekstnega okna. Med navedenimi lastnostmi so prikaz drobnih napisov velikosti 10 slikovnih pik, teksture kože in las ter majhnih sprememb obraznega izraza. Takšne podrobnosti so koristne pri pripravi gradiva, ki si ga ogledujemo od blizu.
Qwen-Image-3.0-Pro je namenjen tudi vizualnim konceptom spletnih strani, iger in zaslonov prenosov v živo. Takšen rezultat lahko združi ilustracijo, strukturo zaslona in oblikovane napise. Model ustvari sliko postavitve; delujoča aplikacija zahteva ločeno izvedbo.
Alibaba za način urejanja navaja od ene do treh slik. Pri tem načinu proizvajalec omogoča povezavo objekta s številko reference in opis kombinacije gradiva. Predvideni so dodajanje, odstranjevanje in premikanje objektov ter spreminjanje dogajanja, sloga, podrobnosti in besedila. Negativni opis pomaga opredeliti neželene elemente.
Proizvajalec v načinu urejanja sprejema vhodno gradivo v formatih JPG, JPEG, PNG, BMP, TIFF, WEBP in GIF. Pri animiranem GIF se uporabi prvi kader. Velikost posamezne datoteke je do 10 MB; proizvajalec priporoča slike s stranicami od 384 do 3072 slikovnih pik. To so priporočila za vhod in ne mere končnega rezultata.
Specifikacija proizvajalca predvideva od ene do šest izhodnih slik v formatu PNG na zahtevo. Površina rezultata je od 262 144 do 4 194 304 slikovnih pik, kar ustreza kvadratnim slikam od 512 × 512 do 2048 × 2048. Dovoljena so razmerja stranic od 1:8 do 8:1, zato je pri podolgovati kompoziciji dolžina stranice odvisna tudi od izbrane oblike kadra. Predvideno je dodatno preoblikovanje navodila pred ustvarjanjem.
POST /v1/images/generationstextimage| Polje | Vrsta | Zahteva | Vrednosti in omejitve | Privzeto |
|---|---|---|---|---|
Poljemodel | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve qwen-image-latest | Privzeto— |
Poljeprompt | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve Najmanjša dolžina: 1 | Privzeto— |
Poljen | Vrstainteger | ZahtevaIzbirno | Vrednosti in omejitve Najmanj: 1 | Privzeto1 |
Poljeresponse_format | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve url, b64_json | Privzeto— |
Poljestream | Vrstaboolean | ZahtevaIzbirno | Vrednosti in omejitve | Privzetofalse |
Poljesize | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljepartial_images | Vrstainteger | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljeimages[].image_url | Vrstastring | ZahtevaNi podprto | Vrednosti in omejitve Največ dekodiranih bajtov: 10.485.760 Vrste MIME: image/png, image/jpeg Največ slik na polje: 3 Pogoji: En dejanski URL na objekt images[]. Število elementov polja je ločeno od te listne vrednosti niza. Velja, ko: Samo JSON images/edits; JSON images/generations ne razčleni referenc images. | Privzeto— |
Poljeimage | Vrstafile | ZahtevaIzbirno | Vrednosti in omejitve Največ dekodiranih bajtov: 10.485.760 Vrste MIME: image/png, image/jpeg Velja, ko: ustvarjanje prek multipart/form-data | Privzeto— |
Poljeimage[] | Vrstafile[] | ZahtevaIzbirno | Vrednosti in omejitve Največ elementov: 3 Največ dekodiranih bajtov: 10.485.760 Vrste MIME: image/png, image/jpeg Velja, ko: ustvarjanje prek multipart/form-data | Privzeto— |
Iz besedila v sliko · Obvezno: prompt
reference_images_generation · Obvezno: prompt
| Parameter | Specifikacija |
|---|---|
Parametermaterial_types | Specifikacijatext |
Parameterrequired | Specifikacijamodel, prompt |
Parameteroptional_controls | Specifikacijanull |
Parametercontent_type | Specifikacijaapplication/json |
Ž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}
Strukture metod in ID so natančno določeni; zmožnost ponudnika je ločena od sprejema zahteve.
POST /v1/images/generationsAiloot 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\nexport AILOOT_API_KEY\n: "${AILOOT_PROMPT_FILE:?Set your actual UTF-8 image brief}"\nexport AILOOT_PROMPT_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "qwen-image-latest", "prompt": ""}')\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Choose your actual UTF-8 brief")\np['prompt']=f.read_text(encoding="utf-8")\nif not p['prompt'].strip():raise SystemExit("Brief must contain text")\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\nfrom openai import OpenAI\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")\n\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Set your actual UTF-8 image brief file")\nrequest={'model': 'qwen-image-latest', 'prompt': ''}\nrequest["prompt"]=f.read_text(encoding="utf-8")\nclient=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)\nresult=client.images.generate(**request)\nPath("sdk-result.txt").write_text(str(result),encoding="utf-8")\nsave_images([{"b64_json":getattr(item,"b64_json",None),"url":getattr(item,"url",None)} for item in result.data])\nimport OpenAI from "openai";\nimport { readFileSync, writeFileSync } from "node:fs";\nconst key=process.env.AILOOT_API_KEY;\nif(!key) throw new Error("Set your actual Ailoot API key");\nconst client=new OpenAI({baseURL:"https://api.ailoot.ai/v1",apiKey:key,maxRetries:0});\nconst request={"model": "qwen-image-latest", "prompt": ""};\nif(!process.env.AILOOT_PROMPT_FILE)throw new Error("Set your actual UTF-8 image brief file");\nrequest.prompt=readFileSync(process.env.AILOOT_PROMPT_FILE,"utf8");\nconst result=await client.images.generate(request);\nwriteFileSync("sdk-result.json",JSON.stringify(result,null,2));\nif(!result.data?.length) throw new Error("No completed images");\nfor(let index=0;index<result.data.length;index++) {\n const item=result.data[index];let encoded=item.b64_json,uri=item.url||"",raw;\n if(!encoded && uri.startsWith("data:image/")) {\n const comma=uri.indexOf(",");if(comma<0 || !uri.slice(0,comma).includes(";base64")) throw new Error("Unsupported image data URI");\n encoded=uri.slice(comma+1);\n }\n if(encoded) {\n if(encoded.length%4!==0 || !/^[A-Za-z0-9+/]*={0,2}$/.test(encoded)) throw new Error("Invalid Base64");\n raw=Buffer.from(encoded,"base64");\n } else if(uri) {\n const u=new URL(uri,"https://api.ailoot.ai");\n if(u.protocol!=="https:" || u.username || u.password) throw new Error("Invalid returned URL");\n const owned=u.origin==="https://api.ailoot.ai" && u.pathname.startsWith("/v1/media/assets/") && u.pathname.endsWith("/content");\n const response=await fetch(u,{headers:owned?{Authorization:"Bearer "+key}:{},redirect:"manual"});\n if(!response.ok) throw new Error("Image content download failed: "+response.status);\n raw=Buffer.from(await response.arrayBuffer());\n } else throw new Error("Image has neither bytes nor URL");\n if(!raw.length) throw new Error("Empty image result");\n const ext=raw.subarray(0,4).equals(Buffer.from([137,80,78,71]))?"png":raw[0]===255&&raw[1]===216?"jpg":raw.toString("ascii",0,4)==="RIFF"&&raw.toString("ascii",8,12)==="WEBP"?"webp":raw.toString("utf8").trimStart().startsWith("<svg")||raw.toString("utf8").trimStart().startsWith("<?xml")?"svg":"bin";\n writeFileSync(`image-${index}.${ext}`,raw);\n}\nconsole.log("Every returned image saved; sdk-result.json retains complete metadata");\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}Shranite vsako dokončano sliko; pridobite vsebino z vsake vrnjene URL ali dekodirajte njeno vsebino Base64.
Shranite vsak podatkovni element. Dekodirajte vsak b64_json ali pridobite vsebino z vsakega vrnjenega podpisanega URL. Končnico imena datoteke izberite glede na dejanski tip MIME oziroma bajte.
Če je treba preveriti rezultat generiranja ali urejanja slike, shranite izvirni operation_id/X-Client-Request-ID in vrnjene podatke o rezultatu. Obstoječe rezultate, ki vam pripadajo, pridobite prek medijske knjižnice z dejanskimi vrednostmi task_id ali asset_id. Zahteve za generiranje/urejanje ne pošiljajte znova in iz operation_id ne sestavljajte URL za periodično preverjanje stanja.
| Polje | Vrsta |
|---|---|
Poljecreated | Vrstainteger |
Poljedata[].url | Vrstastring |
Poljedata[].b64_json | Vrstabase64 string |
Poljeusage | Vrstaobject |
| Odgovor | Pogoj | Naslednji korak |
|---|---|---|
Odgovor400 · invalid_request_error | PogojNeveljavna obvezna polja, predstavitev gradiva ali vrednost parametra | Naslednji korakPred novo zahtevo za ustvarjanje popravite navedena polja. |
Odgovorserver_error | PogojVrnjeni odgovor navaja, da je treba operacijo ali rezultat preveriti | Naslednji korakShranite izvirni vrnjeni ID operacije/opravila, glave zahteve in odgovor; nadaljujte s podprtimi branji te izvirne operacije. Zahteve za ustvarjanje ne pošiljajte znova. |
Ailoot qwen-image-3.0-pro, qwen-image, qwen-image-latest
Uporabite zgoraj navedene poti metod.