Wan2.7-Image-Pro is een model van Alibaba om afbeeldingen uit tekst te maken. De huidige Ailoot-kaart publiceert tekstinvoer en een resultaat als afbeelding. De fabrikant voorziet ook in bewerking, het combineren van referenties en lokale wijzigingen; die werkwijzen vereisen afzonderlijke ondersteuning voor invoerafbeeldingen en worden niet aangeboden door de huidige methode van de kaart.
In de referentiemodus van de fabrikant kunnen maximaal negen bronafbeeldingen worden aangeleverd met een beschrijving van welke elementen uit elk moeten worden gebruikt. Bij bewerking behoudt het model het hoofdonderwerp, verandert het geselecteerde details of bouwt het een nieuwe compositie uit meerdere materialen. Om wijzigingen nauwkeuriger te sturen, kunnen maximaal twee rechthoekige gebieden op één invoerafbeelding worden gemarkeerd.
Buiten opeenvolgende reeksen kan een palet van 3–10 kleuren worden opgegeven. De redeneermodus is bedoeld voor gewone beeldgeneratie op basis van tekst zonder referenties en zonder opeenvolgende reeks: het model analyseert vooraf de scènebeschrijving.
In de specificatie van Alibaba bevat de gewone uitvoer één tot vier afbeeldingen. Voor een verhalende reeks kan een bovengrens tot 12 worden ingesteld; het model kiest het feitelijke aantal op basis van de opdracht. De reeks kan tekst en referenties gebruiken om personagekenmerken te delen en het verhaal samenhangend te laten ontwikkelen. Het palet en redeneren worden in deze modus niet toegepast.
4K wordt ondersteund bij gewone beeldgeneratie op basis van tekst zonder referenties en zonder opeenvolgende reeks. Bewerking op basis van afbeeldingen en opeenvolgende reeksen zijn beperkt tot 2K. Deze aanduidingen bepalen het pixeloppervlak, niet een gelijke lengte voor elke zijde. Het beeldformaat kan worden gekozen van 1:8 tot 8:1; bij bewerking met een vooraf ingestelde resolutie volgt de beeldverhouding de laatste referentie. De resultaten worden opgeslagen als PNG.
Voor werkwijzen met invoerafbeeldingen accepteert Alibaba JPEG, JPG, PNG zonder transparantie, BMP en WEBP. De grenzen zijn 20 MB per bestand, 240 tot 8000 pixels per zijde en een verhouding van 1:8 tot 8:1. De tekstuele opdracht ondersteunt Chinees en Engels; het maximum is 5000 tekens en het overtollige deel wordt verwijderd. Een negatieve beschrijving en uitbreiding van de opdracht zijn niet voorzien voor deze versie. Een willekeurige seed helpt de gelijkenis tussen varianten te behouden, maar zorgt niet voor een exacte herhaling.
", "aboutText": "Wan2.7-Image-Pro is een model van Alibaba om afbeeldingen uit tekst te maken. De huidige Ailoot-kaart publiceert tekstinvoer en een resultaat als afbeelding. De fabrikant voorziet ook in bewerking, het combineren van referenties en lokale wijzigingen; die werkwijzen vereisen afzonderlijke ondersteuning voor invoerafbeeldingen en worden niet aangeboden door de huidige methode van de kaart.\n\nIn de referentiemodus van de fabrikant kunnen maximaal negen bronafbeeldingen worden aangeleverd met een beschrijving van welke elementen uit elk moeten worden gebruikt. Bij bewerking behoudt het model het hoofdonderwerp, verandert het geselecteerde details of bouwt het een nieuwe compositie uit meerdere materialen. Om wijzigingen nauwkeuriger te sturen, kunnen maximaal twee rechthoekige gebieden op één invoerafbeelding worden gemarkeerd.\n\n### Het palet en een complexe opdracht\n\nBuiten opeenvolgende reeksen kan een palet van 3–10 kleuren worden opgegeven. De redeneermodus is bedoeld voor gewone beeldgeneratie op basis van tekst zonder referenties en zonder opeenvolgende reeks: het model analyseert vooraf de scènebeschrijving.\n\nIn de specificatie van Alibaba bevat de gewone uitvoer één tot vier afbeeldingen. Voor een verhalende reeks kan een bovengrens tot 12 worden ingesteld; het model kiest het feitelijke aantal op basis van de opdracht. De reeks kan tekst en referenties gebruiken om personagekenmerken te delen en het verhaal samenhangend te laten ontwikkelen. Het palet en redeneren worden in deze modus niet toegepast.\n\n### De resolutie hangt af van de modus\n\n4K wordt ondersteund bij gewone beeldgeneratie op basis van tekst zonder referenties en zonder opeenvolgende reeks. Bewerking op basis van afbeeldingen en opeenvolgende reeksen zijn beperkt tot 2K. Deze aanduidingen bepalen het pixeloppervlak, niet een gelijke lengte voor elke zijde. Het beeldformaat kan worden gekozen van 1:8 tot 8:1; bij bewerking met een vooraf ingestelde resolutie volgt de beeldverhouding de laatste referentie. De resultaten worden opgeslagen als PNG.\n\nVoor werkwijzen met invoerafbeeldingen accepteert Alibaba JPEG, JPG, PNG zonder transparantie, BMP en WEBP. De grenzen zijn 20 MB per bestand, 240 tot 8000 pixels per zijde en een verhouding van 1:8 tot 8:1. De tekstuele opdracht ondersteunt Chinees en Engels; het maximum is 5000 tekens en het overtollige deel wordt verwijderd. Een negatieve beschrijving en uitbreiding van de opdracht zijn niet voorzien voor deze versie. Een willekeurige seed helpt de gelijkenis tussen varianten te behouden, maar zorgt niet voor een exacte herhaling.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "040e13f4ab20b36f48e2ac5fb7f641fa8907813dad5185a041cf38051fedc749", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "nl-be", "methods": [ { "html": "wan2.7-image-proEen model om afbeeldingen te maken op basis van een tekstuele opdracht. De fabrikant biedt sturing van het kleurenpalet en resolutie tot 4K voor gewone tekst-naar-beeldgeneratie.
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-Pro is een model van Alibaba om afbeeldingen uit tekst te maken. De huidige Ailoot-kaart publiceert tekstinvoer en een resultaat als afbeelding. De fabrikant voorziet ook in bewerking, het combineren van referenties en lokale wijzigingen; die werkwijzen vereisen afzonderlijke ondersteuning voor invoerafbeeldingen en worden niet aangeboden door de huidige methode van de kaart.
In de referentiemodus van de fabrikant kunnen maximaal negen bronafbeeldingen worden aangeleverd met een beschrijving van welke elementen uit elk moeten worden gebruikt. Bij bewerking behoudt het model het hoofdonderwerp, verandert het geselecteerde details of bouwt het een nieuwe compositie uit meerdere materialen. Om wijzigingen nauwkeuriger te sturen, kunnen maximaal twee rechthoekige gebieden op één invoerafbeelding worden gemarkeerd.
Buiten opeenvolgende reeksen kan een palet van 3–10 kleuren worden opgegeven. De redeneermodus is bedoeld voor gewone beeldgeneratie op basis van tekst zonder referenties en zonder opeenvolgende reeks: het model analyseert vooraf de scènebeschrijving.
In de specificatie van Alibaba bevat de gewone uitvoer één tot vier afbeeldingen. Voor een verhalende reeks kan een bovengrens tot 12 worden ingesteld; het model kiest het feitelijke aantal op basis van de opdracht. De reeks kan tekst en referenties gebruiken om personagekenmerken te delen en het verhaal samenhangend te laten ontwikkelen. Het palet en redeneren worden in deze modus niet toegepast.
4K wordt ondersteund bij gewone beeldgeneratie op basis van tekst zonder referenties en zonder opeenvolgende reeks. Bewerking op basis van afbeeldingen en opeenvolgende reeksen zijn beperkt tot 2K. Deze aanduidingen bepalen het pixeloppervlak, niet een gelijke lengte voor elke zijde. Het beeldformaat kan worden gekozen van 1:8 tot 8:1; bij bewerking met een vooraf ingestelde resolutie volgt de beeldverhouding de laatste referentie. De resultaten worden opgeslagen als PNG.
Voor werkwijzen met invoerafbeeldingen accepteert Alibaba JPEG, JPG, PNG zonder transparantie, BMP en WEBP. De grenzen zijn 20 MB per bestand, 240 tot 8000 pixels per zijde en een verhouding van 1:8 tot 8:1. De tekstuele opdracht ondersteunt Chinees en Engels; het maximum is 5000 tekens en het overtollige deel wordt verwijderd. Een negatieve beschrijving en uitbreiding van de opdracht zijn niet voorzien voor deze versie. Een willekeurige seed helpt de gelijkenis tussen varianten te behouden, maar zorgt niet voor een exacte herhaling.
POST /v1/images/generationstextimage| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten wan2.7-image-pro | 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-pro · Standaardconfiguratie | FactureringsvoorwaardenStandaardconfiguratie | Kosten Invoer · Invoer US$ 0,00 per aanroep Uitvoer · Uitvoer US$ 0,16 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-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");\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-pro, wan-image, wan-image-latest
Gebruik de hierboven getoonde methodepaden.
wan-imageEen model om afbeeldingen te maken op basis van een tekstuele opdracht. De fabrikant biedt sturing van het kleurenpalet en resolutie tot 4K voor gewone tekst-naar-beeldgeneratie.
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-Pro is een model van Alibaba om afbeeldingen uit tekst te maken. De huidige Ailoot-kaart publiceert tekstinvoer en een resultaat als afbeelding. De fabrikant voorziet ook in bewerking, het combineren van referenties en lokale wijzigingen; die werkwijzen vereisen afzonderlijke ondersteuning voor invoerafbeeldingen en worden niet aangeboden door de huidige methode van de kaart.
In de referentiemodus van de fabrikant kunnen maximaal negen bronafbeeldingen worden aangeleverd met een beschrijving van welke elementen uit elk moeten worden gebruikt. Bij bewerking behoudt het model het hoofdonderwerp, verandert het geselecteerde details of bouwt het een nieuwe compositie uit meerdere materialen. Om wijzigingen nauwkeuriger te sturen, kunnen maximaal twee rechthoekige gebieden op één invoerafbeelding worden gemarkeerd.
Buiten opeenvolgende reeksen kan een palet van 3–10 kleuren worden opgegeven. De redeneermodus is bedoeld voor gewone beeldgeneratie op basis van tekst zonder referenties en zonder opeenvolgende reeks: het model analyseert vooraf de scènebeschrijving.
In de specificatie van Alibaba bevat de gewone uitvoer één tot vier afbeeldingen. Voor een verhalende reeks kan een bovengrens tot 12 worden ingesteld; het model kiest het feitelijke aantal op basis van de opdracht. De reeks kan tekst en referenties gebruiken om personagekenmerken te delen en het verhaal samenhangend te laten ontwikkelen. Het palet en redeneren worden in deze modus niet toegepast.
4K wordt ondersteund bij gewone beeldgeneratie op basis van tekst zonder referenties en zonder opeenvolgende reeks. Bewerking op basis van afbeeldingen en opeenvolgende reeksen zijn beperkt tot 2K. Deze aanduidingen bepalen het pixeloppervlak, niet een gelijke lengte voor elke zijde. Het beeldformaat kan worden gekozen van 1:8 tot 8:1; bij bewerking met een vooraf ingestelde resolutie volgt de beeldverhouding de laatste referentie. De resultaten worden opgeslagen als PNG.
Voor werkwijzen met invoerafbeeldingen accepteert Alibaba JPEG, JPG, PNG zonder transparantie, BMP en WEBP. De grenzen zijn 20 MB per bestand, 240 tot 8000 pixels per zijde en een verhouding van 1:8 tot 8:1. De tekstuele opdracht ondersteunt Chinees en Engels; het maximum is 5000 tekens en het overtollige deel wordt verwijderd. Een negatieve beschrijving en uitbreiding van de opdracht zijn niet voorzien voor deze versie. Een willekeurige seed helpt de gelijkenis tussen varianten te behouden, maar zorgt niet voor een exacte herhaling.
POST /v1/images/generationstextimage| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten wan-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-pro · Standaardconfiguratie | FactureringsvoorwaardenStandaardconfiguratie | Kosten Invoer · Invoer US$ 0,00 per aanroep Uitvoer · Uitvoer US$ 0,16 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": "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");\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-pro, wan-image, wan-image-latest
Gebruik de hierboven getoonde methodepaden.
wan-image-latestEen model om afbeeldingen te maken op basis van een tekstuele opdracht. De fabrikant biedt sturing van het kleurenpalet en resolutie tot 4K voor gewone tekst-naar-beeldgeneratie.
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-Pro is een model van Alibaba om afbeeldingen uit tekst te maken. De huidige Ailoot-kaart publiceert tekstinvoer en een resultaat als afbeelding. De fabrikant voorziet ook in bewerking, het combineren van referenties en lokale wijzigingen; die werkwijzen vereisen afzonderlijke ondersteuning voor invoerafbeeldingen en worden niet aangeboden door de huidige methode van de kaart.
In de referentiemodus van de fabrikant kunnen maximaal negen bronafbeeldingen worden aangeleverd met een beschrijving van welke elementen uit elk moeten worden gebruikt. Bij bewerking behoudt het model het hoofdonderwerp, verandert het geselecteerde details of bouwt het een nieuwe compositie uit meerdere materialen. Om wijzigingen nauwkeuriger te sturen, kunnen maximaal twee rechthoekige gebieden op één invoerafbeelding worden gemarkeerd.
Buiten opeenvolgende reeksen kan een palet van 3–10 kleuren worden opgegeven. De redeneermodus is bedoeld voor gewone beeldgeneratie op basis van tekst zonder referenties en zonder opeenvolgende reeks: het model analyseert vooraf de scènebeschrijving.
In de specificatie van Alibaba bevat de gewone uitvoer één tot vier afbeeldingen. Voor een verhalende reeks kan een bovengrens tot 12 worden ingesteld; het model kiest het feitelijke aantal op basis van de opdracht. De reeks kan tekst en referenties gebruiken om personagekenmerken te delen en het verhaal samenhangend te laten ontwikkelen. Het palet en redeneren worden in deze modus niet toegepast.
4K wordt ondersteund bij gewone beeldgeneratie op basis van tekst zonder referenties en zonder opeenvolgende reeks. Bewerking op basis van afbeeldingen en opeenvolgende reeksen zijn beperkt tot 2K. Deze aanduidingen bepalen het pixeloppervlak, niet een gelijke lengte voor elke zijde. Het beeldformaat kan worden gekozen van 1:8 tot 8:1; bij bewerking met een vooraf ingestelde resolutie volgt de beeldverhouding de laatste referentie. De resultaten worden opgeslagen als PNG.
Voor werkwijzen met invoerafbeeldingen accepteert Alibaba JPEG, JPG, PNG zonder transparantie, BMP en WEBP. De grenzen zijn 20 MB per bestand, 240 tot 8000 pixels per zijde en een verhouding van 1:8 tot 8:1. De tekstuele opdracht ondersteunt Chinees en Engels; het maximum is 5000 tekens en het overtollige deel wordt verwijderd. Een negatieve beschrijving en uitbreiding van de opdracht zijn niet voorzien voor deze versie. Een willekeurige seed helpt de gelijkenis tussen varianten te behouden, maar zorgt niet voor een exacte herhaling.
POST /v1/images/generationstextimage| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten wan-image-latest | 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-pro · Standaardconfiguratie | FactureringsvoorwaardenStandaardconfiguratie | Kosten Invoer · Invoer US$ 0,00 per aanroep Uitvoer · Uitvoer US$ 0,16 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": "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");\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-pro, wan-image, wan-image-latest
Gebruik de hierboven getoonde methodepaden.