Wan2.7-Image maakt afbeeldingen op basis van een tekstuele opdracht. De huidige Ailoot-kaart biedt specifiek tekstinvoer en een resultaat als afbeelding. Volgens Alibaba is deze versie gericht op het sneller verkrijgen van varianten. De specificatie van de fabrikant voorziet ook in bewerking, het combineren van referenties en lokale wijzigingen; die vereisen afzonderlijke ondersteuning voor invoerafbeeldingen, die de huidige methode van de kaart niet biedt.
Voor de referentiemodus voorziet Alibaba in maximaal negen bronafbeeldingen in de opdracht. Die dienen als houvast voor het uiterlijk van een object, de compositie en de details. Het model kan meerdere materialen combineren in een nieuwe scène of de bronafbeelding wijzigen met behoud van het hoofdonderwerp. Voor gerichte bewerking zijn expliciet gemarkeerde gebieden voorzien: op één afbeelding kunnen maximaal twee rechthoekige gebieden worden aangegeven.
In de specificatie van Alibaba levert de gewone modus één tot vier resultaten op. Een opeenvolgende reeks kan maximaal 12 afbeeldingen vragen die verbonden zijn door een verhaal of gedeelde personagekenmerken. Voor een reeks is dit de bovengrens: het model bepaalt zelf het benodigde aantal beelden en kan er minder teruggeven. De opdracht en het bronmateriaal helpen een gezamenlijke verhaallijn te behouden.
Voor gewone beeldgeneratie op basis van tekst zonder referenties en zonder opeenvolgende reeks is een redeneermodus voorzien. Daarin analyseert het model een complexe beschrijving uitgebreider voordat het de afbeelding maakt. Deze modus wordt niet gebruikt bij bewerking op basis van afbeeldingen of in een opeenvolgende reeks. Een opgegeven palet van 3–10 kleuren is beschikbaar buiten opeenvolgende reeksen.
In de modi met bronafbeeldingen ondersteunt de fabrikant JPEG, JPG, PNG zonder transparantie, BMP en WEBP. Elke zijde kan 240 tot 8000 pixels bevatten, de bestandsgrootte is maximaal 20 MB en de beeldverhouding loopt van 1:8 tot 8:1.
De tekstuele opdracht ondersteunt Chinees en Engels en is beperkt tot 5000 tekens; het overtollige deel wordt verwijderd. Voor deze versie zijn een negatieve beschrijving en aanvullende uitbreiding van de opdracht niet voorzien.
Het uitvoerformaat is PNG en de resolutie gaat tot 2K. Die aanduiding betreft het totale pixeloppervlak, niet een vaste maximale zijlengte; de vorm kan worden gekozen tussen 1:8 en 8:1. Bij bewerking met een vooraf ingestelde resolutie behoudt het resultaat de beeldverhouding van de laatste referentie. Dezelfde willekeurige seed helpt vergelijkbare varianten te krijgen, maar garandeert geen volledige overeenkomst.
", "aboutText": "Wan2.7-Image maakt afbeeldingen op basis van een tekstuele opdracht. De huidige Ailoot-kaart biedt specifiek tekstinvoer en een resultaat als afbeelding. Volgens Alibaba is deze versie gericht op het sneller verkrijgen van varianten. De specificatie van de fabrikant voorziet ook in bewerking, het combineren van referenties en lokale wijzigingen; die vereisen afzonderlijke ondersteuning voor invoerafbeeldingen, die de huidige methode van de kaart niet biedt.\n\n### De door Alibaba beschreven modi\n\nVoor de referentiemodus voorziet Alibaba in maximaal negen bronafbeeldingen in de opdracht. Die dienen als houvast voor het uiterlijk van een object, de compositie en de details. Het model kan meerdere materialen combineren in een nieuwe scène of de bronafbeelding wijzigen met behoud van het hoofdonderwerp. Voor gerichte bewerking zijn expliciet gemarkeerde gebieden voorzien: op één afbeelding kunnen maximaal twee rechthoekige gebieden worden aangegeven.\n\nIn de specificatie van Alibaba levert de gewone modus één tot vier resultaten op. Een opeenvolgende reeks kan maximaal 12 afbeeldingen vragen die verbonden zijn door een verhaal of gedeelde personagekenmerken. Voor een reeks is dit de bovengrens: het model bepaalt zelf het benodigde aantal beelden en kan er minder teruggeven. De opdracht en het bronmateriaal helpen een gezamenlijke verhaallijn te behouden.\n\nVoor gewone beeldgeneratie op basis van tekst zonder referenties en zonder opeenvolgende reeks is een redeneermodus voorzien. Daarin analyseert het model een complexe beschrijving uitgebreider voordat het de afbeelding maakt. Deze modus wordt niet gebruikt bij bewerking op basis van afbeeldingen of in een opeenvolgende reeks. Een opgegeven palet van 3–10 kleuren is beschikbaar buiten opeenvolgende reeksen.\n\n### Invoer en resultaat\n\nIn de modi met bronafbeeldingen ondersteunt de fabrikant JPEG, JPG, PNG zonder transparantie, BMP en WEBP. Elke zijde kan 240 tot 8000 pixels bevatten, de bestandsgrootte is maximaal 20 MB en de beeldverhouding loopt van 1:8 tot 8:1.\n\nDe tekstuele opdracht ondersteunt Chinees en Engels en is beperkt tot 5000 tekens; het overtollige deel wordt verwijderd. Voor deze versie zijn een negatieve beschrijving en aanvullende uitbreiding van de opdracht niet voorzien.\n\nHet uitvoerformaat is PNG en de resolutie gaat tot 2K. Die aanduiding betreft het totale pixeloppervlak, niet een vaste maximale zijlengte; de vorm kan worden gekozen tussen 1:8 en 8:1. Bij bewerking met een vooraf ingestelde resolutie behoudt het resultaat de beeldverhouding van de laatste referentie. Dezelfde willekeurige seed helpt vergelijkbare varianten te krijgen, maar garandeert geen volledige overeenkomst.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "75b1d5be57eacaacf2db56a43725241edcaff0fd8394b353444dd71140c2d8af", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "nl-be", "methods": [ { "html": "wan2.7-imageEen model voor beeldgeneratie uit tekst, bedoeld voor ontwerpvarianten en illustraties. Volgens Alibaba is deze versie gericht op snellere beeldcreatie.
Deze beschrijving gaat over de mogelijkheden van het model. De via Ailoot beschikbare invoer, uitvoer en opties staan hieronder voor de geselecteerde methode.
Wan2.7-Image maakt afbeeldingen op basis van een tekstuele opdracht. De huidige Ailoot-kaart biedt specifiek tekstinvoer en een resultaat als afbeelding. Volgens Alibaba is deze versie gericht op het sneller verkrijgen van varianten. De specificatie van de fabrikant voorziet ook in bewerking, het combineren van referenties en lokale wijzigingen; die vereisen afzonderlijke ondersteuning voor invoerafbeeldingen, die de huidige methode van de kaart niet biedt.
Voor de referentiemodus voorziet Alibaba in maximaal negen bronafbeeldingen in de opdracht. Die dienen als houvast voor het uiterlijk van een object, de compositie en de details. Het model kan meerdere materialen combineren in een nieuwe scène of de bronafbeelding wijzigen met behoud van het hoofdonderwerp. Voor gerichte bewerking zijn expliciet gemarkeerde gebieden voorzien: op één afbeelding kunnen maximaal twee rechthoekige gebieden worden aangegeven.
In de specificatie van Alibaba levert de gewone modus één tot vier resultaten op. Een opeenvolgende reeks kan maximaal 12 afbeeldingen vragen die verbonden zijn door een verhaal of gedeelde personagekenmerken. Voor een reeks is dit de bovengrens: het model bepaalt zelf het benodigde aantal beelden en kan er minder teruggeven. De opdracht en het bronmateriaal helpen een gezamenlijke verhaallijn te behouden.
Voor gewone beeldgeneratie op basis van tekst zonder referenties en zonder opeenvolgende reeks is een redeneermodus voorzien. Daarin analyseert het model een complexe beschrijving uitgebreider voordat het de afbeelding maakt. Deze modus wordt niet gebruikt bij bewerking op basis van afbeeldingen of in een opeenvolgende reeks. Een opgegeven palet van 3–10 kleuren is beschikbaar buiten opeenvolgende reeksen.
In de modi met bronafbeeldingen ondersteunt de fabrikant JPEG, JPG, PNG zonder transparantie, BMP en WEBP. Elke zijde kan 240 tot 8000 pixels bevatten, de bestandsgrootte is maximaal 20 MB en de beeldverhouding loopt van 1:8 tot 8:1.
De tekstuele opdracht ondersteunt Chinees en Engels en is beperkt tot 5000 tekens; het overtollige deel wordt verwijderd. Voor deze versie zijn een negatieve beschrijving en aanvullende uitbreiding van de opdracht niet voorzien.
Het uitvoerformaat is PNG en de resolutie gaat tot 2K. Die aanduiding betreft het totale pixeloppervlak, niet een vaste maximale zijlengte; de vorm kan worden gekozen tussen 1:8 en 8:1. Bij bewerking met een vooraf ingestelde resolutie behoudt het resultaat de beeldverhouding van de laatste referentie. Dezelfde willekeurige seed helpt vergelijkbare varianten te krijgen, maar garandeert geen volledige overeenkomst.
POST /v1/images/generationstextimage| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten wan2.7-image | Standaard— |
Veldprompt | Typestring | VereisteVereist | Waarden en limieten Minimumlengte: 1 | Standaard— |
Veldn | Typeinteger | VereisteOptioneel | Waarden en limieten Minimum: 1 | Standaard1 |
Veldresponse_format | Typestring | VereisteOptioneel | Waarden en limieten url, b64_json | Standaard— |
Veldstream | Typeboolean | VereisteOptioneel | Waarden en limieten | Standaardfalse |
Veldsize | Typestring | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Veldpartial_images | Typeinteger | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Veldimages[].image_url | Typestring | VereisteNiet ondersteund | Waarden en limieten Maximumaantal gedecodeerde bytes: 20.971.520 MIME-typen: image/png, image/jpeg Maximumaantal afbeeldingen per array: 9 Voorwaarden: Eén werkelijke URL per images[]-object. Het aantal array-items staat los van dit bladveld met een tekenreeks. Geldt wanneer: Alleen JSON images/edits; JSON images/generations verwerkt geen afbeeldingsreferenties. | Standaard— |
Veldimage | Typefile | VereisteOptioneel | Waarden en limieten Maximumaantal gedecodeerde bytes: 20.971.520 MIME-typen: image/png, image/jpeg Geldt wanneer: generatie via multipart/form-data | Standaard— |
Veldimage[] | Typefile[] | VereisteOptioneel | Waarden en limieten Maximumaantal items: 9 Maximumaantal gedecodeerde bytes: 20.971.520 MIME-typen: image/png, image/jpeg Geldt wanneer: generatie via multipart/form-data | Standaard— |
Tekst naar afbeelding · Vereist: prompt
reference_images_generation · Vereist: prompt
| Parameter | Contract |
|---|---|
Parametermaterial_types | Contracttext |
Parameterrequired | Contractmodel, prompt |
Parameteroptional_controls | Contractnull |
Parametercontent_type | Contractapplication/json |
Levenscyclus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · daadwerkelijk teruggegeven task_id of record in de mediabibliotheek
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
De methodestructuren en ID’s zijn exact; de mogelijkheden van de leverancier staan los van toelating.
POST /v1/images/generationsAiloot reserveert vóór een verzoek een geschat bedrag. Na het resultaat worden de uiteindelijke kosten afgerekend op basis van het gemeten verbruik. Bij streaming gebeurt de afrekening op basis van de definitieve verbruiksregistratie. Zo werken reservering en afrekening →
Referentiestaffels op modelniveau veranderen de methodeselectie, kostenramingen of afschrijvingen niet. Voor de actieve kostenberekening gelden de tarieven van de geselecteerde Ailoot-methode.
| Configuratie | Factureringsvoorwaarden | Kosten |
|---|---|---|
| Configuratiewan2.7-image · Standaardconfiguratie | FactureringsvoorwaardenStandaardconfiguratie | Kosten Invoer · Invoer US$ 0,00 per aanroep Uitvoer · Uitvoer US$ 0,06 per aanroep |
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");\nDownload elke teruggegeven afbeelding of sla de Base64-inhoud ervan op
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}Sla elke voltooide afbeelding op; haal elke teruggegeven URL op of decodeer de bijbehorende Base64-inhoud.
Sla elk gegevensitem op. Decodeer elke b64_json of haal elke teruggegeven ondertekende URL op. Kies een bestandsextensie op basis van de daadwerkelijke MIME/bytes.
Als het resultaat van een afbeeldingsgeneratie of -bewerking gecontroleerd moet worden, bewaar dan de oorspronkelijke operation_id/X-Client-Request-ID en de teruggegeven resultaatinformatie. Haal bestaande eigen resultaten terug via de mediabibliotheek met daadwerkelijk teruggegeven task_id- of asset_id-waarden. Dien de generatie- of bewerkingsaanvraag niet opnieuw in en stel geen polling-URL samen op basis van operation_id.
| Veld | Type |
|---|---|
Veldcreated | Typeinteger |
Velddata[].url | Typestring |
Velddata[].b64_json | Typebase64 string |
Veldusage | Typeobject |
| Antwoord | Voorwaarde | Volgende stap |
|---|---|---|
Antwoord400 · invalid_request_error | VoorwaardeVerplichte velden, de materiaalrepresentatie of een parameterwaarde zijn ongeldig | Volgende stapCorrigeer de aangegeven velden vóór een nieuwe aanmaakaanvraag. |
Antwoordserver_error | VoorwaardeDe teruggegeven respons geeft aan dat de bewerking of het resultaat gecontroleerd moet worden | Volgende stapBewaar de oorspronkelijk teruggegeven bewerkings-/taak-ID, aanvraagheaders en respons; blijf de oorspronkelijke bewerking uitlezen via de ondersteunde leesaanvragen. Dien de aanmaakaanvraag niet opnieuw in. |
Ailoot wan2.7-image
Gebruik de hierboven getoonde methodepaden.