Wan2.7-Image-Pro ist ein Modell von Alibaba zur Bilderstellung aus Text. Die aktuelle Ailoot-Karte veröffentlicht Texteingabe und ein Bild als Ergebnis. Der Hersteller sieht auch Bearbeitung, die Kombination von Referenzen und lokale Änderungen vor. Diese Verfahren benötigen separate Unterstützung für Eingabebilder und sind in der aktuellen Methode der Karte nicht enthalten.
Im Referenzmodus des Herstellers können bis zu neun Ausgangsbilder übermittelt werden, zusammen mit einer Beschreibung der Elemente, die aus jedem Bild verwendet werden sollen. Bei der Bearbeitung erhält das Modell das Hauptobjekt, verändert ausgewählte Details oder erstellt eine neue Komposition aus mehreren Materialien. Zur genaueren Lenkung der Änderungen dürfen bis zu zwei rechteckige Bereiche in einem Eingabebild markiert werden.
Ausserhalb fortlaufender Serien lässt sich eine Palette mit 3–10 Farben vorgeben. Der Reasoning-Modus dient normaler Textgenerierung ohne Referenzen oder fortlaufende Serie: Das Modell analysiert die Szenenbeschreibung vorab.
In der Alibaba-Spezifikation umfasst die normale Ausgabe ein bis vier Bilder. Für eine erzählerische Serie kann eine Obergrenze von bis zu 12 festgelegt werden; die tatsächliche Anzahl wählt das Modell anhand der Vorgabe. Eine Serie kann Text und Referenzen berücksichtigen, um gemeinsame Figurenmerkmale und eine zusammenhängende Geschichte zu erhalten. Palette und Reasoning werden in diesem Modus nicht angewandt.
Die Auflösungsstufe 4K wird bei normaler Textgenerierung ohne Referenzen oder fortlaufende Serie unterstützt. Bildbasierte Bearbeitung und fortlaufende Serien sind auf 2K begrenzt. Diese Bezeichnungen bestimmen die Pixelfläche und nicht eine einheitliche Länge jeder Seite. Das Bildformat lässt sich zwischen 1:8 und 8:1 wählen; bei Bearbeitung mit voreingestellter Auflösung folgt das Seitenverhältnis der letzten Referenz. Die Ergebnisse werden als PNG gespeichert.
Für Verfahren mit Eingabebildern erlaubt Alibaba JPEG, JPG, PNG ohne Transparenz, BMP und WEBP. Die Grenzen betragen 20 MB pro Datei, 240 bis 8000 Pixel für jede Seite und ein Seitenverhältnis zwischen 1:8 und 8:1. Für die Textvorgabe werden Chinesisch und Englisch unterstützt; höchstens 5000 Zeichen sind zulässig, der überzählige Teil wird abgeschnitten. Eine negative Beschreibung und eine Erweiterung der Vorgabe sind in dieser Version nicht vorgesehen. Der anfängliche Zufallswert hilft, ähnliche Varianten zu erhalten, ermöglicht aber keine exakte Wiederholung.
", "aboutText": "Wan2.7-Image-Pro ist ein Modell von Alibaba zur Bilderstellung aus Text. Die aktuelle Ailoot-Karte veröffentlicht Texteingabe und ein Bild als Ergebnis. Der Hersteller sieht auch Bearbeitung, die Kombination von Referenzen und lokale Änderungen vor. Diese Verfahren benötigen separate Unterstützung für Eingabebilder und sind in der aktuellen Methode der Karte nicht enthalten.\n\nIm Referenzmodus des Herstellers können bis zu neun Ausgangsbilder übermittelt werden, zusammen mit einer Beschreibung der Elemente, die aus jedem Bild verwendet werden sollen. Bei der Bearbeitung erhält das Modell das Hauptobjekt, verändert ausgewählte Details oder erstellt eine neue Komposition aus mehreren Materialien. Zur genaueren Lenkung der Änderungen dürfen bis zu zwei rechteckige Bereiche in einem Eingabebild markiert werden.\n\n### Palette und komplexe Vorgaben\n\nAusserhalb fortlaufender Serien lässt sich eine Palette mit 3–10 Farben vorgeben. Der Reasoning-Modus dient normaler Textgenerierung ohne Referenzen oder fortlaufende Serie: Das Modell analysiert die Szenenbeschreibung vorab.\n\nIn der Alibaba-Spezifikation umfasst die normale Ausgabe ein bis vier Bilder. Für eine erzählerische Serie kann eine Obergrenze von bis zu 12 festgelegt werden; die tatsächliche Anzahl wählt das Modell anhand der Vorgabe. Eine Serie kann Text und Referenzen berücksichtigen, um gemeinsame Figurenmerkmale und eine zusammenhängende Geschichte zu erhalten. Palette und Reasoning werden in diesem Modus nicht angewandt.\n\n### Die Auflösung hängt vom Modus ab\n\nDie Auflösungsstufe 4K wird bei normaler Textgenerierung ohne Referenzen oder fortlaufende Serie unterstützt. Bildbasierte Bearbeitung und fortlaufende Serien sind auf 2K begrenzt. Diese Bezeichnungen bestimmen die Pixelfläche und nicht eine einheitliche Länge jeder Seite. Das Bildformat lässt sich zwischen 1:8 und 8:1 wählen; bei Bearbeitung mit voreingestellter Auflösung folgt das Seitenverhältnis der letzten Referenz. Die Ergebnisse werden als PNG gespeichert.\n\nFür Verfahren mit Eingabebildern erlaubt Alibaba JPEG, JPG, PNG ohne Transparenz, BMP und WEBP. Die Grenzen betragen 20 MB pro Datei, 240 bis 8000 Pixel für jede Seite und ein Seitenverhältnis zwischen 1:8 und 8:1. Für die Textvorgabe werden Chinesisch und Englisch unterstützt; höchstens 5000 Zeichen sind zulässig, der überzählige Teil wird abgeschnitten. Eine negative Beschreibung und eine Erweiterung der Vorgabe sind in dieser Version nicht vorgesehen. Der anfängliche Zufallswert hilft, ähnliche Varianten zu erhalten, ermöglicht aber keine exakte Wiederholung.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "71b975d6158d41a54a4913895dea5aed947efb2e63019748bedc883ab27046fd", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "de-ch", "methods": [ { "html": "wan2.7-image-proModell zur Bilderstellung aus einer Textvorgabe. Der Hersteller sieht die Steuerung der Farbpalette und für normale Textgenerierung Auflösungen bis 4K vor.
Diese Beschreibung erläutert die Fähigkeiten des Modells. Die über Ailoot verfügbaren Eingaben, Ausgaben und Optionen sind unten für die ausgewählte Methode aufgeführt.
Wan2.7-Image-Pro ist ein Modell von Alibaba zur Bilderstellung aus Text. Die aktuelle Ailoot-Karte veröffentlicht Texteingabe und ein Bild als Ergebnis. Der Hersteller sieht auch Bearbeitung, die Kombination von Referenzen und lokale Änderungen vor. Diese Verfahren benötigen separate Unterstützung für Eingabebilder und sind in der aktuellen Methode der Karte nicht enthalten.
Im Referenzmodus des Herstellers können bis zu neun Ausgangsbilder übermittelt werden, zusammen mit einer Beschreibung der Elemente, die aus jedem Bild verwendet werden sollen. Bei der Bearbeitung erhält das Modell das Hauptobjekt, verändert ausgewählte Details oder erstellt eine neue Komposition aus mehreren Materialien. Zur genaueren Lenkung der Änderungen dürfen bis zu zwei rechteckige Bereiche in einem Eingabebild markiert werden.
Ausserhalb fortlaufender Serien lässt sich eine Palette mit 3–10 Farben vorgeben. Der Reasoning-Modus dient normaler Textgenerierung ohne Referenzen oder fortlaufende Serie: Das Modell analysiert die Szenenbeschreibung vorab.
In der Alibaba-Spezifikation umfasst die normale Ausgabe ein bis vier Bilder. Für eine erzählerische Serie kann eine Obergrenze von bis zu 12 festgelegt werden; die tatsächliche Anzahl wählt das Modell anhand der Vorgabe. Eine Serie kann Text und Referenzen berücksichtigen, um gemeinsame Figurenmerkmale und eine zusammenhängende Geschichte zu erhalten. Palette und Reasoning werden in diesem Modus nicht angewandt.
Die Auflösungsstufe 4K wird bei normaler Textgenerierung ohne Referenzen oder fortlaufende Serie unterstützt. Bildbasierte Bearbeitung und fortlaufende Serien sind auf 2K begrenzt. Diese Bezeichnungen bestimmen die Pixelfläche und nicht eine einheitliche Länge jeder Seite. Das Bildformat lässt sich zwischen 1:8 und 8:1 wählen; bei Bearbeitung mit voreingestellter Auflösung folgt das Seitenverhältnis der letzten Referenz. Die Ergebnisse werden als PNG gespeichert.
Für Verfahren mit Eingabebildern erlaubt Alibaba JPEG, JPG, PNG ohne Transparenz, BMP und WEBP. Die Grenzen betragen 20 MB pro Datei, 240 bis 8000 Pixel für jede Seite und ein Seitenverhältnis zwischen 1:8 und 8:1. Für die Textvorgabe werden Chinesisch und Englisch unterstützt; höchstens 5000 Zeichen sind zulässig, der überzählige Teil wird abgeschnitten. Eine negative Beschreibung und eine Erweiterung der Vorgabe sind in dieser Version nicht vorgesehen. Der anfängliche Zufallswert hilft, ähnliche Varianten zu erhalten, ermöglicht aber keine exakte Wiederholung.
POST /v1/images/generationstextimage| Feld | Typ | Anforderung | Werte und Limits | Standard |
|---|---|---|---|---|
Feldmodel | Typstring | AnforderungErforderlich | Werte und Limits wan2.7-image-pro | Standard— |
Feldprompt | Typstring | AnforderungErforderlich | Werte und Limits Mindestlänge: 1 | Standard— |
Feldn | Typinteger | AnforderungOptional | Werte und Limits Minimum: 1 | Standard1 |
Feldresponse_format | Typstring | AnforderungOptional | Werte und Limits url, b64_json | Standard— |
Feldstream | Typboolean | AnforderungOptional | Werte und Limits | Standardfalse |
Feldsize | Typstring | AnforderungOptional | Werte und Limits Modellabhängig | Standard— |
Feldpartial_images | Typinteger | AnforderungOptional | Werte und Limits Modellabhängig | Standard— |
Feldimages[].image_url | Typstring | AnforderungNicht unterstützt | Werte und Limits Maximale Anzahl dekodierter Bytes: 20'971'520 MIME-Typen: image/png, image/jpeg Maximale Anzahl Bilder je Array: 9 Bedingungen: Eine tatsächliche URL pro images[]-Objekt. Die Anzahl im Array ist von diesem Zeichenketten-Endwert zu unterscheiden. Gilt, wenn: Nur JSON images/edits; JSON images/generations liest keine images-Referenzen ein. | Standard— |
Feldimage | Typfile | AnforderungOptional | Werte und Limits Maximale Anzahl dekodierter Bytes: 20'971'520 MIME-Typen: image/png, image/jpeg Gilt, wenn: Erzeugung mit multipart/form-data | Standard— |
Feldimage[] | Typfile[] | AnforderungOptional | Werte und Limits Maximale Anzahl Elemente: 9 Maximale Anzahl dekodierter Bytes: 20'971'520 MIME-Typen: image/png, image/jpeg Gilt, wenn: Erzeugung mit multipart/form-data | Standard— |
Text zu Bild · Erforderlich: prompt
reference_images_generation · Erforderlich: prompt
| Parameter | Vertrag |
|---|---|
Parametermaterial_types | Vertragtext |
Parameterrequired | Vertragmodel, prompt |
Parameteroptional_controls | Vertragnull |
Parametercontent_type | Vertragapplication/json |
Lebenszyklus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · die tatsächlich zurückgegebene task_id oder ein Eintrag in der Medienbibliothek
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Methodenstrukturen und IDs sind exakt; die Fähigkeiten des Anbieters sind von der Zulassung einer Anfrage zu unterscheiden.
POST /v1/images/generationsAiloot reserviert vor einer Anfrage einen geschätzten Betrag. Nach dem Ergebnis rechnet Ailoot die endgültige Gebühr anhand des gemessenen Verbrauchs ab. Bei Streaming erfolgt die Abrechnung anhand des abschliessenden Verbrauchsdatensatzes. So funktionieren Reservierung und Abrechnung →
Referenztarifstaffeln auf Modellebene ändern weder Methodenauswahl noch Kostenvoranschläge oder Gebühren. Für die aktive Abrechnung gelten die Tarife der ausgewählten Ailoot-Methode.
| Konfiguration | Abrechnungsbedingungen | Gebühr |
|---|---|---|
| Konfigurationwan2.7-image-pro · Standardkonfiguration | AbrechnungsbedingungenStandardkonfiguration | Gebühr Eingabe · Eingabe $ 0.00 pro Aufruf Ausgabe · Ausgabe $ 0.16 pro Aufruf |
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");\nLaden Sie jedes zurückgegebene Bild herunter oder speichern Sie seinen Base64-Inhalt
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}Speichern Sie jedes fertiggestellte Bild; rufen Sie jede zurückgegebene URL ab oder dekodieren Sie seinen Base64-Inhalt.
Jedes Datenelement speichern. Jedes b64_json dekodieren oder jede zurückgegebene signierte URL abrufen. Die Dateiendung anhand des tatsächlichen MIME-Typs bzw. der Bytes wählen.
Wenn das Ergebnis einer Bildgenerierung oder -bearbeitung geprüft werden muss, die ursprüngliche operation_id/X-Client-Request-ID und die zurückgegebenen Ergebnisinformationen aufbewahren. Bereits vorhandene eigene Ergebnisse über die Medienbibliothek anhand tatsächlicher task_id- oder asset_id-Werte wiederherstellen. Die Generierungs-/Bearbeitungsanfrage nicht erneut senden und keine Abfrage-URL aus operation_id bilden.
| Feld | Typ |
|---|---|
Feldcreated | Typinteger |
Felddata[].url | Typstring |
Felddata[].b64_json | Typbase64 string |
Feldusage | Typobject |
| Antwort | Bedingung | Nächster Schritt |
|---|---|---|
Antwort400 · invalid_request_error | BedingungPflichtfelder, Darstellung des Eingabematerials oder Parameterwert ungültig | Nächster SchrittDie angegebenen Felder vor einer neuen Erstellungsanfrage korrigieren. |
Antwortserver_error | BedingungDie zurückgegebene Antwort gibt an, dass der Vorgang oder das Ergebnis eine Prüfung erfordert | Nächster SchrittDie ursprünglich zurückgegebene Vorgangs-/Aufgaben-ID, die Anfrageheader und die Antwort aufbewahren; mit unterstützten Leseaufrufen für diesen ursprünglichen Vorgang fortfahren. Die Erstellungsanfrage nicht erneut senden. |
Ailoot wan2.7-image-pro, wan-image, wan-image-latest
Verwenden Sie die oben angezeigten Methodenpfade.
wan-imageModell zur Bilderstellung aus einer Textvorgabe. Der Hersteller sieht die Steuerung der Farbpalette und für normale Textgenerierung Auflösungen bis 4K vor.
Diese Beschreibung erläutert die Fähigkeiten des Modells. Die über Ailoot verfügbaren Eingaben, Ausgaben und Optionen sind unten für die ausgewählte Methode aufgeführt.
Wan2.7-Image-Pro ist ein Modell von Alibaba zur Bilderstellung aus Text. Die aktuelle Ailoot-Karte veröffentlicht Texteingabe und ein Bild als Ergebnis. Der Hersteller sieht auch Bearbeitung, die Kombination von Referenzen und lokale Änderungen vor. Diese Verfahren benötigen separate Unterstützung für Eingabebilder und sind in der aktuellen Methode der Karte nicht enthalten.
Im Referenzmodus des Herstellers können bis zu neun Ausgangsbilder übermittelt werden, zusammen mit einer Beschreibung der Elemente, die aus jedem Bild verwendet werden sollen. Bei der Bearbeitung erhält das Modell das Hauptobjekt, verändert ausgewählte Details oder erstellt eine neue Komposition aus mehreren Materialien. Zur genaueren Lenkung der Änderungen dürfen bis zu zwei rechteckige Bereiche in einem Eingabebild markiert werden.
Ausserhalb fortlaufender Serien lässt sich eine Palette mit 3–10 Farben vorgeben. Der Reasoning-Modus dient normaler Textgenerierung ohne Referenzen oder fortlaufende Serie: Das Modell analysiert die Szenenbeschreibung vorab.
In der Alibaba-Spezifikation umfasst die normale Ausgabe ein bis vier Bilder. Für eine erzählerische Serie kann eine Obergrenze von bis zu 12 festgelegt werden; die tatsächliche Anzahl wählt das Modell anhand der Vorgabe. Eine Serie kann Text und Referenzen berücksichtigen, um gemeinsame Figurenmerkmale und eine zusammenhängende Geschichte zu erhalten. Palette und Reasoning werden in diesem Modus nicht angewandt.
Die Auflösungsstufe 4K wird bei normaler Textgenerierung ohne Referenzen oder fortlaufende Serie unterstützt. Bildbasierte Bearbeitung und fortlaufende Serien sind auf 2K begrenzt. Diese Bezeichnungen bestimmen die Pixelfläche und nicht eine einheitliche Länge jeder Seite. Das Bildformat lässt sich zwischen 1:8 und 8:1 wählen; bei Bearbeitung mit voreingestellter Auflösung folgt das Seitenverhältnis der letzten Referenz. Die Ergebnisse werden als PNG gespeichert.
Für Verfahren mit Eingabebildern erlaubt Alibaba JPEG, JPG, PNG ohne Transparenz, BMP und WEBP. Die Grenzen betragen 20 MB pro Datei, 240 bis 8000 Pixel für jede Seite und ein Seitenverhältnis zwischen 1:8 und 8:1. Für die Textvorgabe werden Chinesisch und Englisch unterstützt; höchstens 5000 Zeichen sind zulässig, der überzählige Teil wird abgeschnitten. Eine negative Beschreibung und eine Erweiterung der Vorgabe sind in dieser Version nicht vorgesehen. Der anfängliche Zufallswert hilft, ähnliche Varianten zu erhalten, ermöglicht aber keine exakte Wiederholung.
POST /v1/images/generationstextimage| Feld | Typ | Anforderung | Werte und Limits | Standard |
|---|---|---|---|---|
Feldmodel | Typstring | AnforderungErforderlich | Werte und Limits wan-image | Standard— |
Feldprompt | Typstring | AnforderungErforderlich | Werte und Limits Mindestlänge: 1 | Standard— |
Feldn | Typinteger | AnforderungOptional | Werte und Limits Minimum: 1 | Standard1 |
Feldresponse_format | Typstring | AnforderungOptional | Werte und Limits url, b64_json | Standard— |
Feldstream | Typboolean | AnforderungOptional | Werte und Limits | Standardfalse |
Feldsize | Typstring | AnforderungOptional | Werte und Limits Modellabhängig | Standard— |
Feldpartial_images | Typinteger | AnforderungOptional | Werte und Limits Modellabhängig | Standard— |
Feldimages[].image_url | Typstring | AnforderungNicht unterstützt | Werte und Limits Maximale Anzahl dekodierter Bytes: 20'971'520 MIME-Typen: image/png, image/jpeg Maximale Anzahl Bilder je Array: 9 Bedingungen: Eine tatsächliche URL pro images[]-Objekt. Die Anzahl im Array ist von diesem Zeichenketten-Endwert zu unterscheiden. Gilt, wenn: Nur JSON images/edits; JSON images/generations liest keine images-Referenzen ein. | Standard— |
Feldimage | Typfile | AnforderungOptional | Werte und Limits Maximale Anzahl dekodierter Bytes: 20'971'520 MIME-Typen: image/png, image/jpeg Gilt, wenn: Erzeugung mit multipart/form-data | Standard— |
Feldimage[] | Typfile[] | AnforderungOptional | Werte und Limits Maximale Anzahl Elemente: 9 Maximale Anzahl dekodierter Bytes: 20'971'520 MIME-Typen: image/png, image/jpeg Gilt, wenn: Erzeugung mit multipart/form-data | Standard— |
Text zu Bild · Erforderlich: prompt
reference_images_generation · Erforderlich: prompt
| Parameter | Vertrag |
|---|---|
Parametermaterial_types | Vertragtext |
Parameterrequired | Vertragmodel, prompt |
Parameteroptional_controls | Vertragnull |
Parametercontent_type | Vertragapplication/json |
Lebenszyklus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · die tatsächlich zurückgegebene task_id oder ein Eintrag in der Medienbibliothek
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Methodenstrukturen und IDs sind exakt; die Fähigkeiten des Anbieters sind von der Zulassung einer Anfrage zu unterscheiden.
POST /v1/images/generationsAiloot reserviert vor einer Anfrage einen geschätzten Betrag. Nach dem Ergebnis rechnet Ailoot die endgültige Gebühr anhand des gemessenen Verbrauchs ab. Bei Streaming erfolgt die Abrechnung anhand des abschliessenden Verbrauchsdatensatzes. So funktionieren Reservierung und Abrechnung →
Referenztarifstaffeln auf Modellebene ändern weder Methodenauswahl noch Kostenvoranschläge oder Gebühren. Für die aktive Abrechnung gelten die Tarife der ausgewählten Ailoot-Methode.
| Konfiguration | Abrechnungsbedingungen | Gebühr |
|---|---|---|
| Konfigurationwan2.7-image-pro · Standardkonfiguration | AbrechnungsbedingungenStandardkonfiguration | Gebühr Eingabe · Eingabe $ 0.00 pro Aufruf Ausgabe · Ausgabe $ 0.16 pro Aufruf |
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");\nLaden Sie jedes zurückgegebene Bild herunter oder speichern Sie seinen Base64-Inhalt
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}Speichern Sie jedes fertiggestellte Bild; rufen Sie jede zurückgegebene URL ab oder dekodieren Sie seinen Base64-Inhalt.
Jedes Datenelement speichern. Jedes b64_json dekodieren oder jede zurückgegebene signierte URL abrufen. Die Dateiendung anhand des tatsächlichen MIME-Typs bzw. der Bytes wählen.
Wenn das Ergebnis einer Bildgenerierung oder -bearbeitung geprüft werden muss, die ursprüngliche operation_id/X-Client-Request-ID und die zurückgegebenen Ergebnisinformationen aufbewahren. Bereits vorhandene eigene Ergebnisse über die Medienbibliothek anhand tatsächlicher task_id- oder asset_id-Werte wiederherstellen. Die Generierungs-/Bearbeitungsanfrage nicht erneut senden und keine Abfrage-URL aus operation_id bilden.
| Feld | Typ |
|---|---|
Feldcreated | Typinteger |
Felddata[].url | Typstring |
Felddata[].b64_json | Typbase64 string |
Feldusage | Typobject |
| Antwort | Bedingung | Nächster Schritt |
|---|---|---|
Antwort400 · invalid_request_error | BedingungPflichtfelder, Darstellung des Eingabematerials oder Parameterwert ungültig | Nächster SchrittDie angegebenen Felder vor einer neuen Erstellungsanfrage korrigieren. |
Antwortserver_error | BedingungDie zurückgegebene Antwort gibt an, dass der Vorgang oder das Ergebnis eine Prüfung erfordert | Nächster SchrittDie ursprünglich zurückgegebene Vorgangs-/Aufgaben-ID, die Anfrageheader und die Antwort aufbewahren; mit unterstützten Leseaufrufen für diesen ursprünglichen Vorgang fortfahren. Die Erstellungsanfrage nicht erneut senden. |
Ailoot wan2.7-image-pro, wan-image, wan-image-latest
Verwenden Sie die oben angezeigten Methodenpfade.
wan-image-latestModell zur Bilderstellung aus einer Textvorgabe. Der Hersteller sieht die Steuerung der Farbpalette und für normale Textgenerierung Auflösungen bis 4K vor.
Diese Beschreibung erläutert die Fähigkeiten des Modells. Die über Ailoot verfügbaren Eingaben, Ausgaben und Optionen sind unten für die ausgewählte Methode aufgeführt.
Wan2.7-Image-Pro ist ein Modell von Alibaba zur Bilderstellung aus Text. Die aktuelle Ailoot-Karte veröffentlicht Texteingabe und ein Bild als Ergebnis. Der Hersteller sieht auch Bearbeitung, die Kombination von Referenzen und lokale Änderungen vor. Diese Verfahren benötigen separate Unterstützung für Eingabebilder und sind in der aktuellen Methode der Karte nicht enthalten.
Im Referenzmodus des Herstellers können bis zu neun Ausgangsbilder übermittelt werden, zusammen mit einer Beschreibung der Elemente, die aus jedem Bild verwendet werden sollen. Bei der Bearbeitung erhält das Modell das Hauptobjekt, verändert ausgewählte Details oder erstellt eine neue Komposition aus mehreren Materialien. Zur genaueren Lenkung der Änderungen dürfen bis zu zwei rechteckige Bereiche in einem Eingabebild markiert werden.
Ausserhalb fortlaufender Serien lässt sich eine Palette mit 3–10 Farben vorgeben. Der Reasoning-Modus dient normaler Textgenerierung ohne Referenzen oder fortlaufende Serie: Das Modell analysiert die Szenenbeschreibung vorab.
In der Alibaba-Spezifikation umfasst die normale Ausgabe ein bis vier Bilder. Für eine erzählerische Serie kann eine Obergrenze von bis zu 12 festgelegt werden; die tatsächliche Anzahl wählt das Modell anhand der Vorgabe. Eine Serie kann Text und Referenzen berücksichtigen, um gemeinsame Figurenmerkmale und eine zusammenhängende Geschichte zu erhalten. Palette und Reasoning werden in diesem Modus nicht angewandt.
Die Auflösungsstufe 4K wird bei normaler Textgenerierung ohne Referenzen oder fortlaufende Serie unterstützt. Bildbasierte Bearbeitung und fortlaufende Serien sind auf 2K begrenzt. Diese Bezeichnungen bestimmen die Pixelfläche und nicht eine einheitliche Länge jeder Seite. Das Bildformat lässt sich zwischen 1:8 und 8:1 wählen; bei Bearbeitung mit voreingestellter Auflösung folgt das Seitenverhältnis der letzten Referenz. Die Ergebnisse werden als PNG gespeichert.
Für Verfahren mit Eingabebildern erlaubt Alibaba JPEG, JPG, PNG ohne Transparenz, BMP und WEBP. Die Grenzen betragen 20 MB pro Datei, 240 bis 8000 Pixel für jede Seite und ein Seitenverhältnis zwischen 1:8 und 8:1. Für die Textvorgabe werden Chinesisch und Englisch unterstützt; höchstens 5000 Zeichen sind zulässig, der überzählige Teil wird abgeschnitten. Eine negative Beschreibung und eine Erweiterung der Vorgabe sind in dieser Version nicht vorgesehen. Der anfängliche Zufallswert hilft, ähnliche Varianten zu erhalten, ermöglicht aber keine exakte Wiederholung.
POST /v1/images/generationstextimage| Feld | Typ | Anforderung | Werte und Limits | Standard |
|---|---|---|---|---|
Feldmodel | Typstring | AnforderungErforderlich | Werte und Limits wan-image-latest | Standard— |
Feldprompt | Typstring | AnforderungErforderlich | Werte und Limits Mindestlänge: 1 | Standard— |
Feldn | Typinteger | AnforderungOptional | Werte und Limits Minimum: 1 | Standard1 |
Feldresponse_format | Typstring | AnforderungOptional | Werte und Limits url, b64_json | Standard— |
Feldstream | Typboolean | AnforderungOptional | Werte und Limits | Standardfalse |
Feldsize | Typstring | AnforderungOptional | Werte und Limits Modellabhängig | Standard— |
Feldpartial_images | Typinteger | AnforderungOptional | Werte und Limits Modellabhängig | Standard— |
Feldimages[].image_url | Typstring | AnforderungNicht unterstützt | Werte und Limits Maximale Anzahl dekodierter Bytes: 20'971'520 MIME-Typen: image/png, image/jpeg Maximale Anzahl Bilder je Array: 9 Bedingungen: Eine tatsächliche URL pro images[]-Objekt. Die Anzahl im Array ist von diesem Zeichenketten-Endwert zu unterscheiden. Gilt, wenn: Nur JSON images/edits; JSON images/generations liest keine images-Referenzen ein. | Standard— |
Feldimage | Typfile | AnforderungOptional | Werte und Limits Maximale Anzahl dekodierter Bytes: 20'971'520 MIME-Typen: image/png, image/jpeg Gilt, wenn: Erzeugung mit multipart/form-data | Standard— |
Feldimage[] | Typfile[] | AnforderungOptional | Werte und Limits Maximale Anzahl Elemente: 9 Maximale Anzahl dekodierter Bytes: 20'971'520 MIME-Typen: image/png, image/jpeg Gilt, wenn: Erzeugung mit multipart/form-data | Standard— |
Text zu Bild · Erforderlich: prompt
reference_images_generation · Erforderlich: prompt
| Parameter | Vertrag |
|---|---|
Parametermaterial_types | Vertragtext |
Parameterrequired | Vertragmodel, prompt |
Parameteroptional_controls | Vertragnull |
Parametercontent_type | Vertragapplication/json |
Lebenszyklus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · die tatsächlich zurückgegebene task_id oder ein Eintrag in der Medienbibliothek
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Methodenstrukturen und IDs sind exakt; die Fähigkeiten des Anbieters sind von der Zulassung einer Anfrage zu unterscheiden.
POST /v1/images/generationsAiloot reserviert vor einer Anfrage einen geschätzten Betrag. Nach dem Ergebnis rechnet Ailoot die endgültige Gebühr anhand des gemessenen Verbrauchs ab. Bei Streaming erfolgt die Abrechnung anhand des abschliessenden Verbrauchsdatensatzes. So funktionieren Reservierung und Abrechnung →
Referenztarifstaffeln auf Modellebene ändern weder Methodenauswahl noch Kostenvoranschläge oder Gebühren. Für die aktive Abrechnung gelten die Tarife der ausgewählten Ailoot-Methode.
| Konfiguration | Abrechnungsbedingungen | Gebühr |
|---|---|---|
| Konfigurationwan2.7-image-pro · Standardkonfiguration | AbrechnungsbedingungenStandardkonfiguration | Gebühr Eingabe · Eingabe $ 0.00 pro Aufruf Ausgabe · Ausgabe $ 0.16 pro Aufruf |
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");\nLaden Sie jedes zurückgegebene Bild herunter oder speichern Sie seinen Base64-Inhalt
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}Speichern Sie jedes fertiggestellte Bild; rufen Sie jede zurückgegebene URL ab oder dekodieren Sie seinen Base64-Inhalt.
Jedes Datenelement speichern. Jedes b64_json dekodieren oder jede zurückgegebene signierte URL abrufen. Die Dateiendung anhand des tatsächlichen MIME-Typs bzw. der Bytes wählen.
Wenn das Ergebnis einer Bildgenerierung oder -bearbeitung geprüft werden muss, die ursprüngliche operation_id/X-Client-Request-ID und die zurückgegebenen Ergebnisinformationen aufbewahren. Bereits vorhandene eigene Ergebnisse über die Medienbibliothek anhand tatsächlicher task_id- oder asset_id-Werte wiederherstellen. Die Generierungs-/Bearbeitungsanfrage nicht erneut senden und keine Abfrage-URL aus operation_id bilden.
| Feld | Typ |
|---|---|
Feldcreated | Typinteger |
Felddata[].url | Typstring |
Felddata[].b64_json | Typbase64 string |
Feldusage | Typobject |
| Antwort | Bedingung | Nächster Schritt |
|---|---|---|
Antwort400 · invalid_request_error | BedingungPflichtfelder, Darstellung des Eingabematerials oder Parameterwert ungültig | Nächster SchrittDie angegebenen Felder vor einer neuen Erstellungsanfrage korrigieren. |
Antwortserver_error | BedingungDie zurückgegebene Antwort gibt an, dass der Vorgang oder das Ergebnis eine Prüfung erfordert | Nächster SchrittDie ursprünglich zurückgegebene Vorgangs-/Aufgaben-ID, die Anfrageheader und die Antwort aufbewahren; mit unterstützten Leseaufrufen für diesen ursprünglichen Vorgang fortfahren. Die Erstellungsanfrage nicht erneut senden. |
Ailoot wan2.7-image-pro, wan-image, wan-image-latest
Verwenden Sie die oben angezeigten Methodenpfade.