Wan2.7-Image ustvarja slike na podlagi besedilnega navodila. Trenutna kartica Ailoot predstavlja prav besedilni vhod in rezultat v obliki slike. Po podatkih družbe Alibaba je ta različica usmerjena v hitrejše pridobivanje različic. Specifikacija proizvajalca predvideva tudi urejanje, kombiniranje referenc in lokalne spremembe; zanje je potrebna ločena podpora vhodnim slikam, ki ni predstavljena v trenutnem načinu dostopa na kartici.
Alibaba za način z referencami predvideva do devet izvirnih slik v navodilu. Te služijo kot opora za videz objekta, kompozicijo in podrobnosti. Model lahko več gradiv združi v novo sceno ali spremeni izvirno sliko ob ohranitvi glavnega predmeta. Za ciljno urejanje so predvidena izrecno označena območja: na eni sliki lahko določite do dve pravokotni območji.
V specifikaciji družbe Alibaba običajni način ustvari od enega do štirih rezultatov. Zaporedna serija omogoča zahtevo za do 12 slik, povezanih z zgodbo ali skupnimi značilnostmi likov. Za serijo je to zgornja meja: model sam določi potrebno število kadrov in jih lahko vrne manj. Navodilo in izvirno gradivo pomagata ohranjati skupno zgodbeno nit.
Za običajno ustvarjanje iz besedila brez referenc in zaporedne serije je predviden način sklepanja. V njem model pred ustvarjanjem slike podrobneje analizira zahteven opis. Pri urejanju na podlagi slik in v zaporedni seriji se ta način ne uporablja. Določena paleta iz 3–10 barv je na voljo zunaj zaporednih serij.
V načinih z izvirnimi slikami proizvajalec podpira JPEG, JPG, PNG brez prosojnosti, BMP in WEBP. Vsaka stranica lahko obsega od 240 do 8000 slikovnih pik, velikost datoteke je do 20 MB, razmerje stranic pa od 1:8 do 8:1.
Besedilno navodilo podpira kitajščino in angleščino ter je omejeno na 5000 znakov; presežni del se zavrže. Pri tej različici negativni opis in dodatna razširitev navodila nista predvidena.
Izhodni format je PNG, ločljivost pa do ravni 2K. Oznaka se nanaša na skupno površino slikovnih pik in ne na fiksno največjo dolžino stranice; obliko lahko izbirate v razponu od 1:8 do 8:1. Pri urejanju s prednastavljeno ločljivostjo rezultat ohrani razmerje stranic zadnje reference. Enako začetno naključno seme pomaga ustvariti podobne različice, ne zagotavlja pa popolnega ujemanja.
", "aboutText": "Wan2.7-Image ustvarja slike na podlagi besedilnega navodila. Trenutna kartica Ailoot predstavlja prav besedilni vhod in rezultat v obliki slike. Po podatkih družbe Alibaba je ta različica usmerjena v hitrejše pridobivanje različic. Specifikacija proizvajalca predvideva tudi urejanje, kombiniranje referenc in lokalne spremembe; zanje je potrebna ločena podpora vhodnim slikam, ki ni predstavljena v trenutnem načinu dostopa na kartici.\n\n### Načini, ki jih opisuje Alibaba\n\nAlibaba za način z referencami predvideva do devet izvirnih slik v navodilu. Te služijo kot opora za videz objekta, kompozicijo in podrobnosti. Model lahko več gradiv združi v novo sceno ali spremeni izvirno sliko ob ohranitvi glavnega predmeta. Za ciljno urejanje so predvidena izrecno označena območja: na eni sliki lahko določite do dve pravokotni območji.\n\nV specifikaciji družbe Alibaba običajni način ustvari od enega do štirih rezultatov. Zaporedna serija omogoča zahtevo za do 12 slik, povezanih z zgodbo ali skupnimi značilnostmi likov. Za serijo je to zgornja meja: model sam določi potrebno število kadrov in jih lahko vrne manj. Navodilo in izvirno gradivo pomagata ohranjati skupno zgodbeno nit.\n\nZa običajno ustvarjanje iz besedila brez referenc in zaporedne serije je predviden način sklepanja. V njem model pred ustvarjanjem slike podrobneje analizira zahteven opis. Pri urejanju na podlagi slik in v zaporedni seriji se ta način ne uporablja. Določena paleta iz 3–10 barv je na voljo zunaj zaporednih serij.\n\n### Vhod in rezultat\n\nV načinih z izvirnimi slikami proizvajalec podpira JPEG, JPG, PNG brez prosojnosti, BMP in WEBP. Vsaka stranica lahko obsega od 240 do 8000 slikovnih pik, velikost datoteke je do 20 MB, razmerje stranic pa od 1:8 do 8:1.\n\nBesedilno navodilo podpira kitajščino in angleščino ter je omejeno na 5000 znakov; presežni del se zavrže. Pri tej različici negativni opis in dodatna razširitev navodila nista predvidena.\n\nIzhodni format je PNG, ločljivost pa do ravni 2K. Oznaka se nanaša na skupno površino slikovnih pik in ne na fiksno največjo dolžino stranice; obliko lahko izbirate v razponu od 1:8 do 8:1. Pri urejanju s prednastavljeno ločljivostjo rezultat ohrani razmerje stranic zadnje reference. Enako začetno naključno seme pomaga ustvariti podobne različice, ne zagotavlja pa popolnega ujemanja.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "4a3715faad51228f73f29774075ac644f8e82de091d2632f57f41004dde87356", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "sl", "methods": [ { "html": "wan2.7-imageModel za ustvarjanje slik iz besedila za pripravo oblikovalskih različic in ilustracij. Po podatkih družbe Alibaba je ta različica usmerjena v hitrejše ustvarjanje slik.
Ta opis zajema zmožnosti modela. Vhodi, izhodi in možnosti, ki so na voljo v Ailoot, so spodaj navedeni za izbrano metodo.
Wan2.7-Image ustvarja slike na podlagi besedilnega navodila. Trenutna kartica Ailoot predstavlja prav besedilni vhod in rezultat v obliki slike. Po podatkih družbe Alibaba je ta različica usmerjena v hitrejše pridobivanje različic. Specifikacija proizvajalca predvideva tudi urejanje, kombiniranje referenc in lokalne spremembe; zanje je potrebna ločena podpora vhodnim slikam, ki ni predstavljena v trenutnem načinu dostopa na kartici.
Alibaba za način z referencami predvideva do devet izvirnih slik v navodilu. Te služijo kot opora za videz objekta, kompozicijo in podrobnosti. Model lahko več gradiv združi v novo sceno ali spremeni izvirno sliko ob ohranitvi glavnega predmeta. Za ciljno urejanje so predvidena izrecno označena območja: na eni sliki lahko določite do dve pravokotni območji.
V specifikaciji družbe Alibaba običajni način ustvari od enega do štirih rezultatov. Zaporedna serija omogoča zahtevo za do 12 slik, povezanih z zgodbo ali skupnimi značilnostmi likov. Za serijo je to zgornja meja: model sam določi potrebno število kadrov in jih lahko vrne manj. Navodilo in izvirno gradivo pomagata ohranjati skupno zgodbeno nit.
Za običajno ustvarjanje iz besedila brez referenc in zaporedne serije je predviden način sklepanja. V njem model pred ustvarjanjem slike podrobneje analizira zahteven opis. Pri urejanju na podlagi slik in v zaporedni seriji se ta način ne uporablja. Določena paleta iz 3–10 barv je na voljo zunaj zaporednih serij.
V načinih z izvirnimi slikami proizvajalec podpira JPEG, JPG, PNG brez prosojnosti, BMP in WEBP. Vsaka stranica lahko obsega od 240 do 8000 slikovnih pik, velikost datoteke je do 20 MB, razmerje stranic pa od 1:8 do 8:1.
Besedilno navodilo podpira kitajščino in angleščino ter je omejeno na 5000 znakov; presežni del se zavrže. Pri tej različici negativni opis in dodatna razširitev navodila nista predvidena.
Izhodni format je PNG, ločljivost pa do ravni 2K. Oznaka se nanaša na skupno površino slikovnih pik in ne na fiksno največjo dolžino stranice; obliko lahko izbirate v razponu od 1:8 do 8:1. Pri urejanju s prednastavljeno ločljivostjo rezultat ohrani razmerje stranic zadnje reference. Enako začetno naključno seme pomaga ustvariti podobne različice, ne zagotavlja pa popolnega ujemanja.
POST /v1/images/generationstextimage| Polje | Vrsta | Zahteva | Vrednosti in omejitve | Privzeto |
|---|---|---|---|---|
Poljemodel | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve wan2.7-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: 20.971.520 Vrste MIME: image/png, image/jpeg Največ slik na polje: 9 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: 20.971.520 Vrste MIME: image/png, image/jpeg Velja, ko: ustvarjanje prek multipart/form-data | Privzeto— |
Poljeimage[] | Vrstafile[] | ZahtevaIzbirno | Vrednosti in omejitve Največ elementov: 9 Največ dekodiranih bajtov: 20.971.520 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 →
Referenčne lestvice modela ne spreminjajo izbire metode, ocen cen ali stroškov. Veljavni stroški uporabljajo cene izbrane metode Ailoot.
| Nastavitev | Obračunski pogoji | Strošek |
|---|---|---|
| Nastavitevwan2.7-image · Privzeta konfiguracija | Obračunski pogojiPrivzeta konfiguracija | Strošek Vhod · Vhod 0,00 $ na klic Izhod · Izhod 0,06 $ na klic |
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": "wan2.7-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': 'wan2.7-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": "wan2.7-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 wan2.7-image
Uporabite zgoraj navedene poti metod.