Wan2.7-Image-Pro — Alibaba modelis vaizdams pagal tekstą kurti. Dabartinėje Ailoot kortelėje skelbiama tekstinė įvestis ir vaizdinis rezultatas. Gamintojas taip pat numato redagavimą, pavyzdinių vaizdų sujungimą ir vietinius pakeitimus; šiems būdams reikia atskiro įvesties vaizdų palaikymo, o dabartinis kortelės metodas jų nepateikia.
Gamintojo režime su pavyzdiniais vaizdais galima perduoti iki devynių pradinių vaizdų ir aprašyti, kuriuos kiekvieno elementus reikia naudoti. Redaguodamas modelis išlaiko pagrindinį objektą, keičia pasirinktas detales arba surenka naują kompoziciją iš kelių medžiagos vienetų. Norint tiksliau nukreipti pakeitimus, leidžiama viename įvesties vaizde pažymėti iki dviejų stačiakampių sričių.
Ne nuosekliose serijose galima nustatyti 3–10 spalvų paletę. Samprotavimo režimas skirtas įprastam generavimui pagal tekstą be pavyzdinių vaizdų ir nuoseklios serijos: modelis iš anksto analizuoja scenos aprašymą.
Alibaba specifikacijoje įprasta išvestis apima nuo vieno iki keturių vaizdų. Siužetinei serijai galima nustatyti viršutinę ribą iki 12; faktinį skaičių modelis pasirenka pagal užduotį. Serija gali naudoti tekstą bei pavyzdinius vaizdus bendriems veikėjų bruožams ir nuosekliai istorijos raidai. Paletė ir samprotavimas šiuo režimu netaikomi.
4K lygis palaikomas įprastai generuojant pagal tekstą be pavyzdinių vaizdų ir nuoseklios serijos. Redagavimas pagal vaizdus ir nuoseklios serijos apriboti 2K lygiu. Šie žymėjimai nustato pikselių plotą, o ne vienodą kiekvienos kraštinės ilgį. Kadro formatą galima rinktis nuo 1:8 iki 8:1; redaguojant su iš anksto nustatyta raiška, kraštinių santykis atitinka paskutinį pavyzdinį vaizdą. Rezultatai išsaugomi PNG formatu.
Būdams su įvesties vaizdais Alibaba leidžia JPEG, JPG, PNG be skaidrumo, BMP ir WEBP. Ribos — 20 MB vienam failui, nuo 240 iki 8000 pikselių kiekvienai kraštinei ir santykis nuo 1:8 iki 8:1. Tekstinei užduočiai palaikomos kinų ir anglų kalbos; didžiausia apimtis — 5000 rašmenų, perteklinė dalis atmetama. Neigiamas aprašymas ir užduoties išplėtimas šioje versijoje nenumatyti. Pradinė atsitiktinumo reikšmė padeda išlaikyti variantų panašumą, tačiau neužtikrina tikslaus pakartojimo.
", "aboutText": "Wan2.7-Image-Pro — Alibaba modelis vaizdams pagal tekstą kurti. Dabartinėje Ailoot kortelėje skelbiama tekstinė įvestis ir vaizdinis rezultatas. Gamintojas taip pat numato redagavimą, pavyzdinių vaizdų sujungimą ir vietinius pakeitimus; šiems būdams reikia atskiro įvesties vaizdų palaikymo, o dabartinis kortelės metodas jų nepateikia.\n\nGamintojo režime su pavyzdiniais vaizdais galima perduoti iki devynių pradinių vaizdų ir aprašyti, kuriuos kiekvieno elementus reikia naudoti. Redaguodamas modelis išlaiko pagrindinį objektą, keičia pasirinktas detales arba surenka naują kompoziciją iš kelių medžiagos vienetų. Norint tiksliau nukreipti pakeitimus, leidžiama viename įvesties vaizde pažymėti iki dviejų stačiakampių sričių.\n\n### Paletė ir sudėtinga užduotis\n\nNe nuosekliose serijose galima nustatyti 3–10 spalvų paletę. Samprotavimo režimas skirtas įprastam generavimui pagal tekstą be pavyzdinių vaizdų ir nuoseklios serijos: modelis iš anksto analizuoja scenos aprašymą.\n\nAlibaba specifikacijoje įprasta išvestis apima nuo vieno iki keturių vaizdų. Siužetinei serijai galima nustatyti viršutinę ribą iki 12; faktinį skaičių modelis pasirenka pagal užduotį. Serija gali naudoti tekstą bei pavyzdinius vaizdus bendriems veikėjų bruožams ir nuosekliai istorijos raidai. Paletė ir samprotavimas šiuo režimu netaikomi.\n\n### Raiška priklauso nuo režimo\n\n4K lygis palaikomas įprastai generuojant pagal tekstą be pavyzdinių vaizdų ir nuoseklios serijos. Redagavimas pagal vaizdus ir nuoseklios serijos apriboti 2K lygiu. Šie žymėjimai nustato pikselių plotą, o ne vienodą kiekvienos kraštinės ilgį. Kadro formatą galima rinktis nuo 1:8 iki 8:1; redaguojant su iš anksto nustatyta raiška, kraštinių santykis atitinka paskutinį pavyzdinį vaizdą. Rezultatai išsaugomi PNG formatu.\n\nBūdams su įvesties vaizdais Alibaba leidžia JPEG, JPG, PNG be skaidrumo, BMP ir WEBP. Ribos — 20 MB vienam failui, nuo 240 iki 8000 pikselių kiekvienai kraštinei ir santykis nuo 1:8 iki 8:1. Tekstinei užduočiai palaikomos kinų ir anglų kalbos; didžiausia apimtis — 5000 rašmenų, perteklinė dalis atmetama. Neigiamas aprašymas ir užduoties išplėtimas šioje versijoje nenumatyti. Pradinė atsitiktinumo reikšmė padeda išlaikyti variantų panašumą, tačiau neužtikrina tikslaus pakartojimo.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "7b0a986a2d8aa9a8141e2f92234b02cdbd33716d1604bfb26c057546e9f84eb8", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "lt", "methods": [ { "html": "wan2.7-image-proModelis, kuriantis vaizdus pagal tekstinę užduotį. Gamintojas numato spalvų paletės valdymą ir iki 4K raišką įprastam generavimui pagal tekstą.
Šis aprašas apima modelio galimybes. Pasirinktam metodui Ailoot prieinamos įvestys, išvestys ir parinktys nurodytos toliau.
Wan2.7-Image-Pro — Alibaba modelis vaizdams pagal tekstą kurti. Dabartinėje Ailoot kortelėje skelbiama tekstinė įvestis ir vaizdinis rezultatas. Gamintojas taip pat numato redagavimą, pavyzdinių vaizdų sujungimą ir vietinius pakeitimus; šiems būdams reikia atskiro įvesties vaizdų palaikymo, o dabartinis kortelės metodas jų nepateikia.
Gamintojo režime su pavyzdiniais vaizdais galima perduoti iki devynių pradinių vaizdų ir aprašyti, kuriuos kiekvieno elementus reikia naudoti. Redaguodamas modelis išlaiko pagrindinį objektą, keičia pasirinktas detales arba surenka naują kompoziciją iš kelių medžiagos vienetų. Norint tiksliau nukreipti pakeitimus, leidžiama viename įvesties vaizde pažymėti iki dviejų stačiakampių sričių.
Ne nuosekliose serijose galima nustatyti 3–10 spalvų paletę. Samprotavimo režimas skirtas įprastam generavimui pagal tekstą be pavyzdinių vaizdų ir nuoseklios serijos: modelis iš anksto analizuoja scenos aprašymą.
Alibaba specifikacijoje įprasta išvestis apima nuo vieno iki keturių vaizdų. Siužetinei serijai galima nustatyti viršutinę ribą iki 12; faktinį skaičių modelis pasirenka pagal užduotį. Serija gali naudoti tekstą bei pavyzdinius vaizdus bendriems veikėjų bruožams ir nuosekliai istorijos raidai. Paletė ir samprotavimas šiuo režimu netaikomi.
4K lygis palaikomas įprastai generuojant pagal tekstą be pavyzdinių vaizdų ir nuoseklios serijos. Redagavimas pagal vaizdus ir nuoseklios serijos apriboti 2K lygiu. Šie žymėjimai nustato pikselių plotą, o ne vienodą kiekvienos kraštinės ilgį. Kadro formatą galima rinktis nuo 1:8 iki 8:1; redaguojant su iš anksto nustatyta raiška, kraštinių santykis atitinka paskutinį pavyzdinį vaizdą. Rezultatai išsaugomi PNG formatu.
Būdams su įvesties vaizdais Alibaba leidžia JPEG, JPG, PNG be skaidrumo, BMP ir WEBP. Ribos — 20 MB vienam failui, nuo 240 iki 8000 pikselių kiekvienai kraštinei ir santykis nuo 1:8 iki 8:1. Tekstinei užduočiai palaikomos kinų ir anglų kalbos; didžiausia apimtis — 5000 rašmenų, perteklinė dalis atmetama. Neigiamas aprašymas ir užduoties išplėtimas šioje versijoje nenumatyti. Pradinė atsitiktinumo reikšmė padeda išlaikyti variantų panašumą, tačiau neužtikrina tikslaus pakartojimo.
POST /v1/images/generationstextimage| Laukas | Tipas | Reikalavimas | Reikšmės ir ribos | Numatyta |
|---|---|---|---|---|
Laukasmodel | Tipasstring | ReikalavimasPrivaloma | Reikšmės ir ribos wan2.7-image-pro | Numatyta— |
Laukasprompt | Tipasstring | ReikalavimasPrivaloma | Reikšmės ir ribos Mažiausias ilgis: 1 | Numatyta— |
Laukasn | Tipasinteger | ReikalavimasNeprivaloma | Reikšmės ir ribos Mažiausia reikšmė: 1 | Numatyta1 |
Laukasresponse_format | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos url, b64_json | Numatyta— |
Laukasstream | Tipasboolean | ReikalavimasNeprivaloma | Reikšmės ir ribos | Numatytafalse |
Laukassize | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos Priklauso nuo modelio | Numatyta— |
Laukaspartial_images | Tipasinteger | ReikalavimasNeprivaloma | Reikšmės ir ribos Priklauso nuo modelio | Numatyta— |
Laukasimages[].image_url | Tipasstring | ReikalavimasNepalaikoma | Reikšmės ir ribos Didžiausias dekoduotų baitų skaičius: 20 971 520 MIME tipai: image/png, image/jpeg Didžiausias vaizdų skaičius masyve: 9 Sąlygos: Vienas tikras URL kiekviename images[] objekte. Masyvo elementų skaičius nesutapatinamas su šiuo galiniu eilutės tipo lauku. Taikoma, kai: Tik JSON images/edits; JSON images/generations neanalizuoja per images pateiktų paveikslėlių nuorodų. | Numatyta— |
Laukasimage | Tipasfile | ReikalavimasNeprivaloma | Reikšmės ir ribos Didžiausias dekoduotų baitų skaičius: 20 971 520 MIME tipai: image/png, image/jpeg Taikoma, kai: generavimas naudojant multipart/form-data | Numatyta— |
Laukasimage[] | Tipasfile[] | ReikalavimasNeprivaloma | Reikšmės ir ribos Didžiausias elementų skaičius: 9 Didžiausias dekoduotų baitų skaičius: 20 971 520 MIME tipai: image/png, image/jpeg Taikoma, kai: generavimas naudojant multipart/form-data | Numatyta— |
Iš teksto į vaizdą · Privaloma: prompt
reference_images_generation · Privaloma: prompt
| Parametras | Specifikacija |
|---|---|
Parametrasmaterial_types | Specifikacijatext |
Parametrasrequired | Specifikacijamodel, prompt |
Parametrasoptional_controls | Specifikacijanull |
Parametrascontent_type | Specifikacijaapplication/json |
Gyvavimo ciklas: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · faktiškai grąžinta task_id reikšmė arba medijos bibliotekos įrašas
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Metodų struktūros ir ID yra tikslūs; tiekėjo galimybės yra atskirtos nuo užklausos priėmimo.
POST /v1/images/generationsAiloot prieš užklausą rezervuoja numatomą sumą. Gavus rezultatą, galutinis mokestis nuskaitomas pagal išmatuotą naudojimą. Srautinio atsakymo atsiskaitymui naudojamas galutinis naudojimo įrašas. Kaip veikia rezervavimas ir atsiskaitymas →
Modelio informacinės lentelės nekeičia metodo pasirinkimo, kainos įverčių ar mokesčių. Galiojantys mokesčiai nustatomi pagal pasirinkto Ailoot metodo įkainius.
| Konfigūracija | Apmokestinimo sąlygos | Mokestis |
|---|---|---|
| Konfigūracijawan2.7-image-pro · Numatytoji konfigūracija | Apmokestinimo sąlygosNumatytoji konfigūracija | Mokestis Įvestis · Įvestis 0,00 USD už iškvietimą Išvestis · Išvestis 0,16 USD už iškvietimą |
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-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': 'wan2.7-image-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": "wan2.7-image-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");\nAtsisiųskite kiekvieną grąžintą vaizdą arba išsaugokite jo Base64 turinį
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}Išsaugokite kiekvieną baigtą vaizdą; gaukite turinį iš kiekvieno grąžinto URL arba dekoduokite jo Base64 turinį.
Išsaugokite kiekvieną duomenų elementą. Iškoduokite kiekvieną b64_json arba atsisiųskite turinį pagal kiekvieną grąžintą pasirašytą URL. Failo plėtinį pasirinkite pagal faktinį MIME tipą ir baitus.
Jei vaizdo generavimo ar redagavimo rezultatą reikia patikrinti, išsaugokite pradinį operation_id/X-Client-Request-ID ir grąžintą informaciją apie rezultatą. Atkurkite prieigą prie esamų jums priklausančių rezultatų per medijos biblioteką, naudodami faktines task_id arba asset_id reikšmes. Pakartotinai neteikite generavimo ar redagavimo užklausos ir nekurkite būsenos tikrinimo URL iš operation_id.
| Laukas | Tipas |
|---|---|
Laukascreated | Tipasinteger |
Laukasdata[].url | Tipasstring |
Laukasdata[].b64_json | Tipasbase64 string |
Laukasusage | Tipasobject |
| Atsakymas | Sąlyga | Kitas žingsnis |
|---|---|---|
Atsakymas400 · invalid_request_error | SąlygaNetinkami privalomi laukai, medžiagos pateikimo forma arba parametro reikšmė | Kitas žingsnisPrieš naują kūrimo užklausą pataisykite nurodytus laukus. |
Atsakymasserver_error | SąlygaGrąžintame atsakyme nurodoma, kad operaciją arba rezultatą reikia patikrinti | Kitas žingsnisIšsaugokite pradinį grąžintą operacijos ar užduoties ID, užklausos antraštes ir atsakymą; toliau tikrinkite tos pačios pradinės operacijos duomenis palaikomais būdais. Kūrimo užklausos pakartotinai neteikite. |
Ailoot wan2.7-image-pro, wan-image, wan-image-latest
Naudokite aukščiau nurodytus metodų kelius.
wan-imageModelis, kuriantis vaizdus pagal tekstinę užduotį. Gamintojas numato spalvų paletės valdymą ir iki 4K raišką įprastam generavimui pagal tekstą.
Šis aprašas apima modelio galimybes. Pasirinktam metodui Ailoot prieinamos įvestys, išvestys ir parinktys nurodytos toliau.
Wan2.7-Image-Pro — Alibaba modelis vaizdams pagal tekstą kurti. Dabartinėje Ailoot kortelėje skelbiama tekstinė įvestis ir vaizdinis rezultatas. Gamintojas taip pat numato redagavimą, pavyzdinių vaizdų sujungimą ir vietinius pakeitimus; šiems būdams reikia atskiro įvesties vaizdų palaikymo, o dabartinis kortelės metodas jų nepateikia.
Gamintojo režime su pavyzdiniais vaizdais galima perduoti iki devynių pradinių vaizdų ir aprašyti, kuriuos kiekvieno elementus reikia naudoti. Redaguodamas modelis išlaiko pagrindinį objektą, keičia pasirinktas detales arba surenka naują kompoziciją iš kelių medžiagos vienetų. Norint tiksliau nukreipti pakeitimus, leidžiama viename įvesties vaizde pažymėti iki dviejų stačiakampių sričių.
Ne nuosekliose serijose galima nustatyti 3–10 spalvų paletę. Samprotavimo režimas skirtas įprastam generavimui pagal tekstą be pavyzdinių vaizdų ir nuoseklios serijos: modelis iš anksto analizuoja scenos aprašymą.
Alibaba specifikacijoje įprasta išvestis apima nuo vieno iki keturių vaizdų. Siužetinei serijai galima nustatyti viršutinę ribą iki 12; faktinį skaičių modelis pasirenka pagal užduotį. Serija gali naudoti tekstą bei pavyzdinius vaizdus bendriems veikėjų bruožams ir nuosekliai istorijos raidai. Paletė ir samprotavimas šiuo režimu netaikomi.
4K lygis palaikomas įprastai generuojant pagal tekstą be pavyzdinių vaizdų ir nuoseklios serijos. Redagavimas pagal vaizdus ir nuoseklios serijos apriboti 2K lygiu. Šie žymėjimai nustato pikselių plotą, o ne vienodą kiekvienos kraštinės ilgį. Kadro formatą galima rinktis nuo 1:8 iki 8:1; redaguojant su iš anksto nustatyta raiška, kraštinių santykis atitinka paskutinį pavyzdinį vaizdą. Rezultatai išsaugomi PNG formatu.
Būdams su įvesties vaizdais Alibaba leidžia JPEG, JPG, PNG be skaidrumo, BMP ir WEBP. Ribos — 20 MB vienam failui, nuo 240 iki 8000 pikselių kiekvienai kraštinei ir santykis nuo 1:8 iki 8:1. Tekstinei užduočiai palaikomos kinų ir anglų kalbos; didžiausia apimtis — 5000 rašmenų, perteklinė dalis atmetama. Neigiamas aprašymas ir užduoties išplėtimas šioje versijoje nenumatyti. Pradinė atsitiktinumo reikšmė padeda išlaikyti variantų panašumą, tačiau neužtikrina tikslaus pakartojimo.
POST /v1/images/generationstextimage| Laukas | Tipas | Reikalavimas | Reikšmės ir ribos | Numatyta |
|---|---|---|---|---|
Laukasmodel | Tipasstring | ReikalavimasPrivaloma | Reikšmės ir ribos wan-image | Numatyta— |
Laukasprompt | Tipasstring | ReikalavimasPrivaloma | Reikšmės ir ribos Mažiausias ilgis: 1 | Numatyta— |
Laukasn | Tipasinteger | ReikalavimasNeprivaloma | Reikšmės ir ribos Mažiausia reikšmė: 1 | Numatyta1 |
Laukasresponse_format | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos url, b64_json | Numatyta— |
Laukasstream | Tipasboolean | ReikalavimasNeprivaloma | Reikšmės ir ribos | Numatytafalse |
Laukassize | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos Priklauso nuo modelio | Numatyta— |
Laukaspartial_images | Tipasinteger | ReikalavimasNeprivaloma | Reikšmės ir ribos Priklauso nuo modelio | Numatyta— |
Laukasimages[].image_url | Tipasstring | ReikalavimasNepalaikoma | Reikšmės ir ribos Didžiausias dekoduotų baitų skaičius: 20 971 520 MIME tipai: image/png, image/jpeg Didžiausias vaizdų skaičius masyve: 9 Sąlygos: Vienas tikras URL kiekviename images[] objekte. Masyvo elementų skaičius nesutapatinamas su šiuo galiniu eilutės tipo lauku. Taikoma, kai: Tik JSON images/edits; JSON images/generations neanalizuoja per images pateiktų paveikslėlių nuorodų. | Numatyta— |
Laukasimage | Tipasfile | ReikalavimasNeprivaloma | Reikšmės ir ribos Didžiausias dekoduotų baitų skaičius: 20 971 520 MIME tipai: image/png, image/jpeg Taikoma, kai: generavimas naudojant multipart/form-data | Numatyta— |
Laukasimage[] | Tipasfile[] | ReikalavimasNeprivaloma | Reikšmės ir ribos Didžiausias elementų skaičius: 9 Didžiausias dekoduotų baitų skaičius: 20 971 520 MIME tipai: image/png, image/jpeg Taikoma, kai: generavimas naudojant multipart/form-data | Numatyta— |
Iš teksto į vaizdą · Privaloma: prompt
reference_images_generation · Privaloma: prompt
| Parametras | Specifikacija |
|---|---|
Parametrasmaterial_types | Specifikacijatext |
Parametrasrequired | Specifikacijamodel, prompt |
Parametrasoptional_controls | Specifikacijanull |
Parametrascontent_type | Specifikacijaapplication/json |
Gyvavimo ciklas: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · faktiškai grąžinta task_id reikšmė arba medijos bibliotekos įrašas
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Metodų struktūros ir ID yra tikslūs; tiekėjo galimybės yra atskirtos nuo užklausos priėmimo.
POST /v1/images/generationsAiloot prieš užklausą rezervuoja numatomą sumą. Gavus rezultatą, galutinis mokestis nuskaitomas pagal išmatuotą naudojimą. Srautinio atsakymo atsiskaitymui naudojamas galutinis naudojimo įrašas. Kaip veikia rezervavimas ir atsiskaitymas →
Modelio informacinės lentelės nekeičia metodo pasirinkimo, kainos įverčių ar mokesčių. Galiojantys mokesčiai nustatomi pagal pasirinkto Ailoot metodo įkainius.
| Konfigūracija | Apmokestinimo sąlygos | Mokestis |
|---|---|---|
| Konfigūracijawan2.7-image-pro · Numatytoji konfigūracija | Apmokestinimo sąlygosNumatytoji konfigūracija | Mokestis Įvestis · Įvestis 0,00 USD už iškvietimą Išvestis · Išvestis 0,16 USD už iškvietimą |
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": "wan-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': 'wan-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": "wan-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");\nAtsisiųskite kiekvieną grąžintą vaizdą arba išsaugokite jo Base64 turinį
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}Išsaugokite kiekvieną baigtą vaizdą; gaukite turinį iš kiekvieno grąžinto URL arba dekoduokite jo Base64 turinį.
Išsaugokite kiekvieną duomenų elementą. Iškoduokite kiekvieną b64_json arba atsisiųskite turinį pagal kiekvieną grąžintą pasirašytą URL. Failo plėtinį pasirinkite pagal faktinį MIME tipą ir baitus.
Jei vaizdo generavimo ar redagavimo rezultatą reikia patikrinti, išsaugokite pradinį operation_id/X-Client-Request-ID ir grąžintą informaciją apie rezultatą. Atkurkite prieigą prie esamų jums priklausančių rezultatų per medijos biblioteką, naudodami faktines task_id arba asset_id reikšmes. Pakartotinai neteikite generavimo ar redagavimo užklausos ir nekurkite būsenos tikrinimo URL iš operation_id.
| Laukas | Tipas |
|---|---|
Laukascreated | Tipasinteger |
Laukasdata[].url | Tipasstring |
Laukasdata[].b64_json | Tipasbase64 string |
Laukasusage | Tipasobject |
| Atsakymas | Sąlyga | Kitas žingsnis |
|---|---|---|
Atsakymas400 · invalid_request_error | SąlygaNetinkami privalomi laukai, medžiagos pateikimo forma arba parametro reikšmė | Kitas žingsnisPrieš naują kūrimo užklausą pataisykite nurodytus laukus. |
Atsakymasserver_error | SąlygaGrąžintame atsakyme nurodoma, kad operaciją arba rezultatą reikia patikrinti | Kitas žingsnisIšsaugokite pradinį grąžintą operacijos ar užduoties ID, užklausos antraštes ir atsakymą; toliau tikrinkite tos pačios pradinės operacijos duomenis palaikomais būdais. Kūrimo užklausos pakartotinai neteikite. |
Ailoot wan2.7-image-pro, wan-image, wan-image-latest
Naudokite aukščiau nurodytus metodų kelius.
wan-image-latestModelis, kuriantis vaizdus pagal tekstinę užduotį. Gamintojas numato spalvų paletės valdymą ir iki 4K raišką įprastam generavimui pagal tekstą.
Šis aprašas apima modelio galimybes. Pasirinktam metodui Ailoot prieinamos įvestys, išvestys ir parinktys nurodytos toliau.
Wan2.7-Image-Pro — Alibaba modelis vaizdams pagal tekstą kurti. Dabartinėje Ailoot kortelėje skelbiama tekstinė įvestis ir vaizdinis rezultatas. Gamintojas taip pat numato redagavimą, pavyzdinių vaizdų sujungimą ir vietinius pakeitimus; šiems būdams reikia atskiro įvesties vaizdų palaikymo, o dabartinis kortelės metodas jų nepateikia.
Gamintojo režime su pavyzdiniais vaizdais galima perduoti iki devynių pradinių vaizdų ir aprašyti, kuriuos kiekvieno elementus reikia naudoti. Redaguodamas modelis išlaiko pagrindinį objektą, keičia pasirinktas detales arba surenka naują kompoziciją iš kelių medžiagos vienetų. Norint tiksliau nukreipti pakeitimus, leidžiama viename įvesties vaizde pažymėti iki dviejų stačiakampių sričių.
Ne nuosekliose serijose galima nustatyti 3–10 spalvų paletę. Samprotavimo režimas skirtas įprastam generavimui pagal tekstą be pavyzdinių vaizdų ir nuoseklios serijos: modelis iš anksto analizuoja scenos aprašymą.
Alibaba specifikacijoje įprasta išvestis apima nuo vieno iki keturių vaizdų. Siužetinei serijai galima nustatyti viršutinę ribą iki 12; faktinį skaičių modelis pasirenka pagal užduotį. Serija gali naudoti tekstą bei pavyzdinius vaizdus bendriems veikėjų bruožams ir nuosekliai istorijos raidai. Paletė ir samprotavimas šiuo režimu netaikomi.
4K lygis palaikomas įprastai generuojant pagal tekstą be pavyzdinių vaizdų ir nuoseklios serijos. Redagavimas pagal vaizdus ir nuoseklios serijos apriboti 2K lygiu. Šie žymėjimai nustato pikselių plotą, o ne vienodą kiekvienos kraštinės ilgį. Kadro formatą galima rinktis nuo 1:8 iki 8:1; redaguojant su iš anksto nustatyta raiška, kraštinių santykis atitinka paskutinį pavyzdinį vaizdą. Rezultatai išsaugomi PNG formatu.
Būdams su įvesties vaizdais Alibaba leidžia JPEG, JPG, PNG be skaidrumo, BMP ir WEBP. Ribos — 20 MB vienam failui, nuo 240 iki 8000 pikselių kiekvienai kraštinei ir santykis nuo 1:8 iki 8:1. Tekstinei užduočiai palaikomos kinų ir anglų kalbos; didžiausia apimtis — 5000 rašmenų, perteklinė dalis atmetama. Neigiamas aprašymas ir užduoties išplėtimas šioje versijoje nenumatyti. Pradinė atsitiktinumo reikšmė padeda išlaikyti variantų panašumą, tačiau neužtikrina tikslaus pakartojimo.
POST /v1/images/generationstextimage| Laukas | Tipas | Reikalavimas | Reikšmės ir ribos | Numatyta |
|---|---|---|---|---|
Laukasmodel | Tipasstring | ReikalavimasPrivaloma | Reikšmės ir ribos wan-image-latest | Numatyta— |
Laukasprompt | Tipasstring | ReikalavimasPrivaloma | Reikšmės ir ribos Mažiausias ilgis: 1 | Numatyta— |
Laukasn | Tipasinteger | ReikalavimasNeprivaloma | Reikšmės ir ribos Mažiausia reikšmė: 1 | Numatyta1 |
Laukasresponse_format | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos url, b64_json | Numatyta— |
Laukasstream | Tipasboolean | ReikalavimasNeprivaloma | Reikšmės ir ribos | Numatytafalse |
Laukassize | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos Priklauso nuo modelio | Numatyta— |
Laukaspartial_images | Tipasinteger | ReikalavimasNeprivaloma | Reikšmės ir ribos Priklauso nuo modelio | Numatyta— |
Laukasimages[].image_url | Tipasstring | ReikalavimasNepalaikoma | Reikšmės ir ribos Didžiausias dekoduotų baitų skaičius: 20 971 520 MIME tipai: image/png, image/jpeg Didžiausias vaizdų skaičius masyve: 9 Sąlygos: Vienas tikras URL kiekviename images[] objekte. Masyvo elementų skaičius nesutapatinamas su šiuo galiniu eilutės tipo lauku. Taikoma, kai: Tik JSON images/edits; JSON images/generations neanalizuoja per images pateiktų paveikslėlių nuorodų. | Numatyta— |
Laukasimage | Tipasfile | ReikalavimasNeprivaloma | Reikšmės ir ribos Didžiausias dekoduotų baitų skaičius: 20 971 520 MIME tipai: image/png, image/jpeg Taikoma, kai: generavimas naudojant multipart/form-data | Numatyta— |
Laukasimage[] | Tipasfile[] | ReikalavimasNeprivaloma | Reikšmės ir ribos Didžiausias elementų skaičius: 9 Didžiausias dekoduotų baitų skaičius: 20 971 520 MIME tipai: image/png, image/jpeg Taikoma, kai: generavimas naudojant multipart/form-data | Numatyta— |
Iš teksto į vaizdą · Privaloma: prompt
reference_images_generation · Privaloma: prompt
| Parametras | Specifikacija |
|---|---|
Parametrasmaterial_types | Specifikacijatext |
Parametrasrequired | Specifikacijamodel, prompt |
Parametrasoptional_controls | Specifikacijanull |
Parametrascontent_type | Specifikacijaapplication/json |
Gyvavimo ciklas: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · faktiškai grąžinta task_id reikšmė arba medijos bibliotekos įrašas
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Metodų struktūros ir ID yra tikslūs; tiekėjo galimybės yra atskirtos nuo užklausos priėmimo.
POST /v1/images/generationsAiloot prieš užklausą rezervuoja numatomą sumą. Gavus rezultatą, galutinis mokestis nuskaitomas pagal išmatuotą naudojimą. Srautinio atsakymo atsiskaitymui naudojamas galutinis naudojimo įrašas. Kaip veikia rezervavimas ir atsiskaitymas →
Modelio informacinės lentelės nekeičia metodo pasirinkimo, kainos įverčių ar mokesčių. Galiojantys mokesčiai nustatomi pagal pasirinkto Ailoot metodo įkainius.
| Konfigūracija | Apmokestinimo sąlygos | Mokestis |
|---|---|---|
| Konfigūracijawan2.7-image-pro · Numatytoji konfigūracija | Apmokestinimo sąlygosNumatytoji konfigūracija | Mokestis Įvestis · Įvestis 0,00 USD už iškvietimą Išvestis · Išvestis 0,16 USD už iškvietimą |
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": "wan-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': 'wan-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": "wan-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");\nAtsisiųskite kiekvieną grąžintą vaizdą arba išsaugokite jo Base64 turinį
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}Išsaugokite kiekvieną baigtą vaizdą; gaukite turinį iš kiekvieno grąžinto URL arba dekoduokite jo Base64 turinį.
Išsaugokite kiekvieną duomenų elementą. Iškoduokite kiekvieną b64_json arba atsisiųskite turinį pagal kiekvieną grąžintą pasirašytą URL. Failo plėtinį pasirinkite pagal faktinį MIME tipą ir baitus.
Jei vaizdo generavimo ar redagavimo rezultatą reikia patikrinti, išsaugokite pradinį operation_id/X-Client-Request-ID ir grąžintą informaciją apie rezultatą. Atkurkite prieigą prie esamų jums priklausančių rezultatų per medijos biblioteką, naudodami faktines task_id arba asset_id reikšmes. Pakartotinai neteikite generavimo ar redagavimo užklausos ir nekurkite būsenos tikrinimo URL iš operation_id.
| Laukas | Tipas |
|---|---|
Laukascreated | Tipasinteger |
Laukasdata[].url | Tipasstring |
Laukasdata[].b64_json | Tipasbase64 string |
Laukasusage | Tipasobject |
| Atsakymas | Sąlyga | Kitas žingsnis |
|---|---|---|
Atsakymas400 · invalid_request_error | SąlygaNetinkami privalomi laukai, medžiagos pateikimo forma arba parametro reikšmė | Kitas žingsnisPrieš naują kūrimo užklausą pataisykite nurodytus laukus. |
Atsakymasserver_error | SąlygaGrąžintame atsakyme nurodoma, kad operaciją arba rezultatą reikia patikrinti | Kitas žingsnisIšsaugokite pradinį grąžintą operacijos ar užduoties ID, užklausos antraštes ir atsakymą; toliau tikrinkite tos pačios pradinės operacijos duomenis palaikomais būdais. Kūrimo užklausos pakartotinai neteikite. |
Ailoot wan2.7-image-pro, wan-image, wan-image-latest
Naudokite aukščiau nurodytus metodų kelius.