Wan2.7-Image luo kuvia tekstiohjeesta. Ailootin nykyinen kortti esittää nimenomaan tekstisyötteen ja kuvatuloksen. Alibaban mukaan versio painottaa vaihtoehtojen nopeampaa tuottamista. Valmistajan määrittely tarjoaa myös muokkausta, referenssien yhdistelyä ja paikallisia muutoksia; ne vaativat erillisen kuvasyötetuen, jota nykyinen korttimenetelmä ei tarjoa.
Referenssitilaan Alibaba tarjoaa enintään yhdeksän lähtökuvaa. Ne ohjaavat kohteen ulkonäköä, sommittelua ja yksityiskohtia. Malli voi yhdistää aineistoja uudeksi kohtaukseksi tai muuttaa lähtökuvaa säilyttäen pääkohteen. Paikallismuokkaukseen voidaan merkitä enintään kaksi suorakulmaista aluetta yhdellä kuvalla.
Alibaban määrittelyssä tavallinen tila muodostaa yhdestä neljään tulosta. Vaiheittaista sarjaa varten voidaan pyytää enintään 12 kuvaa, joita yhdistää tarina tai hahmojen yhteiset piirteet. Määrä on sarjan yläraja: malli valitsee tarvittavat ruudut ja voi palauttaa vähemmän. Ohje ja lähtömateriaali auttavat yhtenäisen juonen säilyttämisessä.
Tavalliselle tekstigeneroinnille ilman referenssejä tai kuvasarjaa on päättelytila, jossa monimutkainen kuvaus analysoidaan tarkemmin ennen luontia. Tilaa ei käytetä kuvamuokkauksessa tai vaiheittaisessa sarjassa. 3–10 värin paletti on käytettävissä sarjojen ulkopuolella.
Valmistajan lähtökuvatiloissa tuetaan JPEG, JPG, läpinäkymätön PNG, BMP ja WEBP. Sivu voi olla 240–8000 pikseliä, tiedosto enintään 20 Mt ja kuvasuhde 1:8–8:1.
Tekstiohje tukee kiinaa ja englantia ja on rajattu 5000 merkkiin; ylittävä osa poistetaan. Versio ei tarjoa negatiivista kuvausta tai ohjeen lisälaajennusta.
Tiedostomuoto on PNG ja tarkkuus enintään 2K. Merkintä tarkoittaa kokonaispikselipinta-alaa, ei kiinteää sivun enimmäispituutta; kuvasuhde voi olla 1:8–8:1. Esiasetetulla tarkkuudella tehty muokkaus säilyttää viimeisen referenssin kuvasuhteen. Sama siemenarvo auttaa saamaan samankaltaisia vaihtoehtoja, mutta ei takaa täydellistä yhtäläisyyttä.
", "aboutText": "Wan2.7-Image luo kuvia tekstiohjeesta. Ailootin nykyinen kortti esittää nimenomaan tekstisyötteen ja kuvatuloksen. Alibaban mukaan versio painottaa vaihtoehtojen nopeampaa tuottamista. Valmistajan määrittely tarjoaa myös muokkausta, referenssien yhdistelyä ja paikallisia muutoksia; ne vaativat erillisen kuvasyötetuen, jota nykyinen korttimenetelmä ei tarjoa.\n\n### Alibaban kuvaamat tilat\n\nReferenssitilaan Alibaba tarjoaa enintään yhdeksän lähtökuvaa. Ne ohjaavat kohteen ulkonäköä, sommittelua ja yksityiskohtia. Malli voi yhdistää aineistoja uudeksi kohtaukseksi tai muuttaa lähtökuvaa säilyttäen pääkohteen. Paikallismuokkaukseen voidaan merkitä enintään kaksi suorakulmaista aluetta yhdellä kuvalla.\n\nAlibaban määrittelyssä tavallinen tila muodostaa yhdestä neljään tulosta. Vaiheittaista sarjaa varten voidaan pyytää enintään 12 kuvaa, joita yhdistää tarina tai hahmojen yhteiset piirteet. Määrä on sarjan yläraja: malli valitsee tarvittavat ruudut ja voi palauttaa vähemmän. Ohje ja lähtömateriaali auttavat yhtenäisen juonen säilyttämisessä.\n\nTavalliselle tekstigeneroinnille ilman referenssejä tai kuvasarjaa on päättelytila, jossa monimutkainen kuvaus analysoidaan tarkemmin ennen luontia. Tilaa ei käytetä kuvamuokkauksessa tai vaiheittaisessa sarjassa. 3–10 värin paletti on käytettävissä sarjojen ulkopuolella.\n\n### Syöte ja tulos\n\nValmistajan lähtökuvatiloissa tuetaan JPEG, JPG, läpinäkymätön PNG, BMP ja WEBP. Sivu voi olla 240–8000 pikseliä, tiedosto enintään 20 Mt ja kuvasuhde 1:8–8:1.\n\nTekstiohje tukee kiinaa ja englantia ja on rajattu 5000 merkkiin; ylittävä osa poistetaan. Versio ei tarjoa negatiivista kuvausta tai ohjeen lisälaajennusta.\n\nTiedostomuoto on PNG ja tarkkuus enintään 2K. Merkintä tarkoittaa kokonaispikselipinta-alaa, ei kiinteää sivun enimmäispituutta; kuvasuhde voi olla 1:8–8:1. Esiasetetulla tarkkuudella tehty muokkaus säilyttää viimeisen referenssin kuvasuhteen. Sama siemenarvo auttaa saamaan samankaltaisia vaihtoehtoja, mutta ei takaa täydellistä yhtäläisyyttä.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "6993e73c49bb158a91f89a885be2443da96a4d4e9a5e1723460adc6feb923554", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "fi", "methods": [ { "html": "wan2.7-imageTekstistä kuvia luova malli suunnitteluvaihtoehtoihin ja kuvituksiin. Alibaban mukaan tämä versio painottaa nopeampaa kuvien luomista.
Tämä kuvaus kattaa mallin ominaisuudet. Ailootissa saatavilla olevat syötteet, tulosteet ja asetukset luetellaan alla valitulle menetelmälle.
Wan2.7-Image luo kuvia tekstiohjeesta. Ailootin nykyinen kortti esittää nimenomaan tekstisyötteen ja kuvatuloksen. Alibaban mukaan versio painottaa vaihtoehtojen nopeampaa tuottamista. Valmistajan määrittely tarjoaa myös muokkausta, referenssien yhdistelyä ja paikallisia muutoksia; ne vaativat erillisen kuvasyötetuen, jota nykyinen korttimenetelmä ei tarjoa.
Referenssitilaan Alibaba tarjoaa enintään yhdeksän lähtökuvaa. Ne ohjaavat kohteen ulkonäköä, sommittelua ja yksityiskohtia. Malli voi yhdistää aineistoja uudeksi kohtaukseksi tai muuttaa lähtökuvaa säilyttäen pääkohteen. Paikallismuokkaukseen voidaan merkitä enintään kaksi suorakulmaista aluetta yhdellä kuvalla.
Alibaban määrittelyssä tavallinen tila muodostaa yhdestä neljään tulosta. Vaiheittaista sarjaa varten voidaan pyytää enintään 12 kuvaa, joita yhdistää tarina tai hahmojen yhteiset piirteet. Määrä on sarjan yläraja: malli valitsee tarvittavat ruudut ja voi palauttaa vähemmän. Ohje ja lähtömateriaali auttavat yhtenäisen juonen säilyttämisessä.
Tavalliselle tekstigeneroinnille ilman referenssejä tai kuvasarjaa on päättelytila, jossa monimutkainen kuvaus analysoidaan tarkemmin ennen luontia. Tilaa ei käytetä kuvamuokkauksessa tai vaiheittaisessa sarjassa. 3–10 värin paletti on käytettävissä sarjojen ulkopuolella.
Valmistajan lähtökuvatiloissa tuetaan JPEG, JPG, läpinäkymätön PNG, BMP ja WEBP. Sivu voi olla 240–8000 pikseliä, tiedosto enintään 20 Mt ja kuvasuhde 1:8–8:1.
Tekstiohje tukee kiinaa ja englantia ja on rajattu 5000 merkkiin; ylittävä osa poistetaan. Versio ei tarjoa negatiivista kuvausta tai ohjeen lisälaajennusta.
Tiedostomuoto on PNG ja tarkkuus enintään 2K. Merkintä tarkoittaa kokonaispikselipinta-alaa, ei kiinteää sivun enimmäispituutta; kuvasuhde voi olla 1:8–8:1. Esiasetetulla tarkkuudella tehty muokkaus säilyttää viimeisen referenssin kuvasuhteen. Sama siemenarvo auttaa saamaan samankaltaisia vaihtoehtoja, mutta ei takaa täydellistä yhtäläisyyttä.
POST /v1/images/generationstextimage| Kenttä | Tyyppi | Vaatimus | Arvot & rajat | Oletus |
|---|---|---|---|---|
Kenttämodel | Tyyppistring | VaatimusPakollinen | Arvot & rajat wan2.7-image | Oletus— |
Kenttäprompt | Tyyppistring | VaatimusPakollinen | Arvot & rajat Vähimmäispituus: 1 | Oletus— |
Kenttän | Tyyppiinteger | VaatimusValinnainen | Arvot & rajat Vähimmäismäärä: 1 | Oletus1 |
Kenttäresponse_format | Tyyppistring | VaatimusValinnainen | Arvot & rajat url, b64_json | Oletus— |
Kenttästream | Tyyppiboolean | VaatimusValinnainen | Arvot & rajat | Oletusfalse |
Kenttäsize | Tyyppistring | VaatimusValinnainen | Arvot & rajat Riippuu mallista | Oletus— |
Kenttäpartial_images | Tyyppiinteger | VaatimusValinnainen | Arvot & rajat Riippuu mallista | Oletus— |
Kenttäimages[].image_url | Tyyppistring | VaatimusEi tuettu | Arvot & rajat Purettujen tavujen enimmäismäärä: 20 971 520 MIME-tyypit: image/png, image/jpeg Kuvien enimmäismäärä taulukossa: 9 Ehdot: Yksi todellinen URL kutakin images[]-oliota kohden. Taulukon alkioiden määrä on eri asia kuin tämä merkkijonon sisältävä lehtisolmu. Sovelletaan, kun: Vain JSON images/edits; JSON images/generations ei jäsennä images-viitteitä. | Oletus— |
Kenttäimage | Tyyppifile | VaatimusValinnainen | Arvot & rajat Purettujen tavujen enimmäismäärä: 20 971 520 MIME-tyypit: image/png, image/jpeg Sovelletaan, kun: multipart/form-data-luontipyyntö | Oletus— |
Kenttäimage[] | Tyyppifile[] | VaatimusValinnainen | Arvot & rajat Kohteiden enimmäismäärä: 9 Purettujen tavujen enimmäismäärä: 20 971 520 MIME-tyypit: image/png, image/jpeg Sovelletaan, kun: multipart/form-data-luontipyyntö | Oletus— |
Tekstistä kuvaksi · Pakollinen: prompt
reference_images_generation · Pakollinen: prompt
| Parametri | Sopimus |
|---|---|
Parametrimaterial_types | Sopimustext |
Parametrirequired | Sopimusmodel, prompt |
Parametrioptional_controls | Sopimusnull |
Parametricontent_type | Sopimusapplication/json |
Elinkaari: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · todellisuudessa palautettu task_id tai mediakirjaston tietue
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Menetelmien rakenteet ja ID:t ovat täsmällisiä; toimittajan kyvykkyys on erillinen pyynnön hyväksymisestä.
POST /v1/images/generationsAiloot varaa arvioidun summan ennen pyyntöä. Tuloksen jälkeen lopullinen veloitus toteutetaan mitatun käytön perusteella. Suoratoiston veloituksessa käytetään lopullista käyttötietuetta. Varauksen ja lopullisen veloituksen toiminta →
Mallitason viitehinnastot eivät muuta menetelmän valintaa, hinta-arvioita tai veloituksia. Käytössä olevat veloitukset käyttävät valitun Ailoot-menetelmän hintoja.
| Asetukset | Laskutusehdot | Veloitus |
|---|---|---|
| Asetuksetwan2.7-image · Oletusasetukset | LaskutusehdotOletuskokoonpano | Veloitus Syöte · Syöte 0,00 $ kutsua kohti Tuloste · Tuloste 0,06 $ kutsua kohti |
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");\nLataa jokainen palautettu kuva tai tallenna sen Base64-sisältö
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}Tallenna jokainen valmistunut kuva; nouda jokainen palautettu URL tai pura sen Base64-sisältö.
Tallenna jokainen data-alkio. Pura jokainen b64_json-arvo tai lataa jokaisen palautetun allekirjoitetun URL-osoitteen sisältö. Valitse tiedostopääte todellisen MIME-tyypin tai tavusisällön perusteella.
Jos kuvan generoinnin tai muokkauksen tulos edellyttää tarkistusta, säilytä alkuperäinen operation_id/X-Client-Request-ID ja palautetut tulostiedot. Hae olemassa olevat omistamasi tulokset mediakirjastosta käyttämällä todellisia task_id- tai asset_id-arvoja. Älä lähetä generointi- tai muokkauspyyntöä uudelleen äläkä muodosta tilakyselyn URL-osoitetta operation_id-arvosta.
| Kenttä | Tyyppi |
|---|---|
Kenttäcreated | Tyyppiinteger |
Kenttädata[].url | Tyyppistring |
Kenttädata[].b64_json | Tyyppibase64 string |
Kenttäusage | Tyyppiobject |
| Vastaus | Ehto | Seuraava vaihe |
|---|---|---|
Vastaus400 · invalid_request_error | EhtoVirheelliset pakolliset kentät, aineiston esitysmuoto tai parametrin arvo | Seuraava vaiheKorjaa ilmoitetut kentät ennen uutta luontipyyntöä. |
Vastausserver_error | EhtoPalautettu vastaus ilmoittaa, että operaatio tai tulos edellyttää tarkistusta | Seuraava vaiheSäilytä alkuperäinen palautettu operaation tai tehtävän ID, pyynnön otsakkeet ja vastaus; jatka kyseisen alkuperäisen operaation tuettuja lukutoimintoja. Älä lähetä luontipyyntöä uudelleen. |
Ailoot wan2.7-image
Käytä yllä näytettyjä menetelmäpolkuja.