Qwen-Image-3.0-Pro ist ein Modell von Alibaba zur Erstellung und Bearbeitung von Bildern, bei denen Komposition, Schrift und kleine Details wichtig sind. Zu seinen Anwendungsbereichen gehören dichte Layouts, Bilder im Bild, Zeitungslayouts, Storyboards, Speisekarten und Arbeitsblätter. Die aktuelle Ailoot-Karte bietet den Modus zur Bildgenerierung aus einer Textvorgabe. Alibaba sieht auch Bearbeitung und die Arbeit mit Referenzbildern vor; diese Operationen erfordern eine separate Unterstützung für Eingabebilder und sind in der aktuellen Methode der Karte nicht enthalten.
Der Hersteller hebt lange Vorgaben mit bis zu 4,5 Tausend Tokens, Schrift in 12 Sprachen und die Arbeit mit mehreren Schriftarten hervor. Das beschreibt die Verarbeitung von Vorgaben, nicht eine veröffentlichte Größe des formalen Kontextfensters. Zu den genannten Eigenschaften gehören die Wiedergabe kleiner Schrift mit 10 Pixeln, Haut- und Haartexturen sowie geringfügiger Veränderungen des Gesichtsausdrucks. Solche Details sind für Materialien hilfreich, deren Bilder aus der Nähe betrachtet werden.
Qwen-Image-3.0-Pro ist außerdem für visuelle Konzepte von Webseiten, Spielen und Livestream-Oberflächen vorgesehen. In einem solchen Ergebnis lassen sich Illustration, Bildschirmstruktur und gestaltete Schrift verbinden. Das Modell erzeugt ein Bild des Layouts; eine funktionsfähige Anwendung erfordert eine separate Umsetzung.
Für den Bearbeitungsmodus gibt Alibaba ein bis drei Bilder an. Bei diesem Verfahren erlaubt der Hersteller, ein Objekt mit der Nummer einer Referenz zu verknüpfen und die Kombination von Materialien zu beschreiben. Vorgesehen sind das Hinzufügen, Entfernen und Verschieben von Objekten sowie Änderungen an Handlung, Stil, Details und Text. Eine negative Beschreibung hilft, unerwünschte Elemente zu benennen.
Der Bearbeitungsmodus des Herstellers akzeptiert Eingabematerial in JPG, JPEG, PNG, BMP, TIFF, WEBP und GIF. Bei einem animierten GIF wird das erste Bild verwendet. Jede Datei darf bis zu 10 MB groß sein; der Hersteller empfiehlt Bilder mit Seitenlängen von 384 bis 3072 Pixeln. Das sind Empfehlungen für die Eingabe, nicht die Abmessungen des fertigen Ergebnisses.
Die Herstellerspezifikation sieht ein bis sechs Ausgabebilder in PNG pro Anfrage vor. Die Bildfläche des Ergebnisses reicht von 262 144 bis 4 194 304 Pixeln; das entspricht quadratischen Bildern von 512 × 512 bis 2048 × 2048. Seitenverhältnisse von 1:8 bis 8:1 sind zulässig. Bei langgezogenen Kompositionen hängt die Seitenlänge daher auch vom gewählten Bildformat ab. Eine zusätzliche Überarbeitung der Vorgabe vor der Generierung ist vorgesehen.
", "aboutText": "Qwen-Image-3.0-Pro ist ein Modell von Alibaba zur Erstellung und Bearbeitung von Bildern, bei denen Komposition, Schrift und kleine Details wichtig sind. Zu seinen Anwendungsbereichen gehören dichte Layouts, Bilder im Bild, Zeitungslayouts, Storyboards, Speisekarten und Arbeitsblätter. Die aktuelle Ailoot-Karte bietet den Modus zur Bildgenerierung aus einer Textvorgabe. Alibaba sieht auch Bearbeitung und die Arbeit mit Referenzbildern vor; diese Operationen erfordern eine separate Unterstützung für Eingabebilder und sind in der aktuellen Methode der Karte nicht enthalten.\n\n### Text und Details im Bild\n\nDer Hersteller hebt lange Vorgaben mit bis zu 4,5 Tausend Tokens, Schrift in 12 Sprachen und die Arbeit mit mehreren Schriftarten hervor. Das beschreibt die Verarbeitung von Vorgaben, nicht eine veröffentlichte Größe des formalen Kontextfensters. Zu den genannten Eigenschaften gehören die Wiedergabe kleiner Schrift mit 10 Pixeln, Haut- und Haartexturen sowie geringfügiger Veränderungen des Gesichtsausdrucks. Solche Details sind für Materialien hilfreich, deren Bilder aus der Nähe betrachtet werden.\n\nQwen-Image-3.0-Pro ist außerdem für visuelle Konzepte von Webseiten, Spielen und Livestream-Oberflächen vorgesehen. In einem solchen Ergebnis lassen sich Illustration, Bildschirmstruktur und gestaltete Schrift verbinden. Das Modell erzeugt ein Bild des Layouts; eine funktionsfähige Anwendung erfordert eine separate Umsetzung.\n\n### Bearbeitung in der Alibaba-Spezifikation\n\nFür den Bearbeitungsmodus gibt Alibaba ein bis drei Bilder an. Bei diesem Verfahren erlaubt der Hersteller, ein Objekt mit der Nummer einer Referenz zu verknüpfen und die Kombination von Materialien zu beschreiben. Vorgesehen sind das Hinzufügen, Entfernen und Verschieben von Objekten sowie Änderungen an Handlung, Stil, Details und Text. Eine negative Beschreibung hilft, unerwünschte Elemente zu benennen.\n\nDer Bearbeitungsmodus des Herstellers akzeptiert Eingabematerial in JPG, JPEG, PNG, BMP, TIFF, WEBP und GIF. Bei einem animierten GIF wird das erste Bild verwendet. Jede Datei darf bis zu 10 MB groß sein; der Hersteller empfiehlt Bilder mit Seitenlängen von 384 bis 3072 Pixeln. Das sind Empfehlungen für die Eingabe, nicht die Abmessungen des fertigen Ergebnisses.\n\nDie Herstellerspezifikation sieht ein bis sechs Ausgabebilder in PNG pro Anfrage vor. Die Bildfläche des Ergebnisses reicht von 262 144 bis 4 194 304 Pixeln; das entspricht quadratischen Bildern von 512 × 512 bis 2048 × 2048. Seitenverhältnisse von 1:8 bis 8:1 sind zulässig. Bei langgezogenen Kompositionen hängt die Seitenlänge daher auch vom gewählten Bildformat ab. Eine zusätzliche Überarbeitung der Vorgabe vor der Generierung ist vorgesehen.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "d1b3df99cf177cd2127c034ebc6961854f22e12a3910f7a6fd51b4746849e5f3", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "de", "methods": [ { "html": "qwen-image-3.0-proModell zur Bildgenerierung aus Text mit Schwerpunkt auf komplexen Layouts, Schrift und realistischen Details. Geeignet für Poster, Storyboards, Speisekarten und Materialien mit dichter Komposition.
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.
Qwen-Image-3.0-Pro ist ein Modell von Alibaba zur Erstellung und Bearbeitung von Bildern, bei denen Komposition, Schrift und kleine Details wichtig sind. Zu seinen Anwendungsbereichen gehören dichte Layouts, Bilder im Bild, Zeitungslayouts, Storyboards, Speisekarten und Arbeitsblätter. Die aktuelle Ailoot-Karte bietet den Modus zur Bildgenerierung aus einer Textvorgabe. Alibaba sieht auch Bearbeitung und die Arbeit mit Referenzbildern vor; diese Operationen erfordern eine separate Unterstützung für Eingabebilder und sind in der aktuellen Methode der Karte nicht enthalten.
Der Hersteller hebt lange Vorgaben mit bis zu 4,5 Tausend Tokens, Schrift in 12 Sprachen und die Arbeit mit mehreren Schriftarten hervor. Das beschreibt die Verarbeitung von Vorgaben, nicht eine veröffentlichte Größe des formalen Kontextfensters. Zu den genannten Eigenschaften gehören die Wiedergabe kleiner Schrift mit 10 Pixeln, Haut- und Haartexturen sowie geringfügiger Veränderungen des Gesichtsausdrucks. Solche Details sind für Materialien hilfreich, deren Bilder aus der Nähe betrachtet werden.
Qwen-Image-3.0-Pro ist außerdem für visuelle Konzepte von Webseiten, Spielen und Livestream-Oberflächen vorgesehen. In einem solchen Ergebnis lassen sich Illustration, Bildschirmstruktur und gestaltete Schrift verbinden. Das Modell erzeugt ein Bild des Layouts; eine funktionsfähige Anwendung erfordert eine separate Umsetzung.
Für den Bearbeitungsmodus gibt Alibaba ein bis drei Bilder an. Bei diesem Verfahren erlaubt der Hersteller, ein Objekt mit der Nummer einer Referenz zu verknüpfen und die Kombination von Materialien zu beschreiben. Vorgesehen sind das Hinzufügen, Entfernen und Verschieben von Objekten sowie Änderungen an Handlung, Stil, Details und Text. Eine negative Beschreibung hilft, unerwünschte Elemente zu benennen.
Der Bearbeitungsmodus des Herstellers akzeptiert Eingabematerial in JPG, JPEG, PNG, BMP, TIFF, WEBP und GIF. Bei einem animierten GIF wird das erste Bild verwendet. Jede Datei darf bis zu 10 MB groß sein; der Hersteller empfiehlt Bilder mit Seitenlängen von 384 bis 3072 Pixeln. Das sind Empfehlungen für die Eingabe, nicht die Abmessungen des fertigen Ergebnisses.
Die Herstellerspezifikation sieht ein bis sechs Ausgabebilder in PNG pro Anfrage vor. Die Bildfläche des Ergebnisses reicht von 262 144 bis 4 194 304 Pixeln; das entspricht quadratischen Bildern von 512 × 512 bis 2048 × 2048. Seitenverhältnisse von 1:8 bis 8:1 sind zulässig. Bei langgezogenen Kompositionen hängt die Seitenlänge daher auch vom gewählten Bildformat ab. Eine zusätzliche Überarbeitung der Vorgabe vor der Generierung ist vorgesehen.
POST /v1/images/generationstextimage| Feld | Typ | Anforderung | Werte und Limits | Standard |
|---|---|---|---|---|
Feldmodel | Typstring | AnforderungErforderlich | Werte und Limits qwen-image-3.0-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: 10.485.760 MIME-Typen: image/png, image/jpeg Maximale Anzahl Bilder je Array: 3 Bedingungen: Eine tatsächliche URL pro images[]-Objekt. Die Anzahl der Arrayelemente ist von diesem Zeichenfolgen-Endknoten zu unterscheiden. Gilt, wenn: Nur JSON images/edits; JSON images/generations parst keine Bildreferenzen. | Standard— |
Feldimage | Typfile | AnforderungOptional | Werte und Limits Maximale Anzahl dekodierter Bytes: 10.485.760 MIME-Typen: image/png, image/jpeg Gilt, wenn: Generierung mit multipart/form-data | Standard— |
Feldimage[] | Typfile[] | AnforderungOptional | Werte und Limits Maximale Anzahl Elemente: 3 Maximale Anzahl dekodierter Bytes: 10.485.760 MIME-Typen: image/png, image/jpeg Gilt, wenn: Generierung 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 abschließenden Verbrauchsdatensatzes. So funktionieren Reservierung und Abrechnung →
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": "qwen-image-3.0-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': 'qwen-image-3.0-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": "qwen-image-3.0-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 qwen-image-3.0-pro, qwen-image, qwen-image-latest
Verwenden Sie die oben angezeigten Methodenpfade.
qwen-imageModell zur Bildgenerierung aus Text mit Schwerpunkt auf komplexen Layouts, Schrift und realistischen Details. Geeignet für Poster, Storyboards, Speisekarten und Materialien mit dichter Komposition.
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.
Qwen-Image-3.0-Pro ist ein Modell von Alibaba zur Erstellung und Bearbeitung von Bildern, bei denen Komposition, Schrift und kleine Details wichtig sind. Zu seinen Anwendungsbereichen gehören dichte Layouts, Bilder im Bild, Zeitungslayouts, Storyboards, Speisekarten und Arbeitsblätter. Die aktuelle Ailoot-Karte bietet den Modus zur Bildgenerierung aus einer Textvorgabe. Alibaba sieht auch Bearbeitung und die Arbeit mit Referenzbildern vor; diese Operationen erfordern eine separate Unterstützung für Eingabebilder und sind in der aktuellen Methode der Karte nicht enthalten.
Der Hersteller hebt lange Vorgaben mit bis zu 4,5 Tausend Tokens, Schrift in 12 Sprachen und die Arbeit mit mehreren Schriftarten hervor. Das beschreibt die Verarbeitung von Vorgaben, nicht eine veröffentlichte Größe des formalen Kontextfensters. Zu den genannten Eigenschaften gehören die Wiedergabe kleiner Schrift mit 10 Pixeln, Haut- und Haartexturen sowie geringfügiger Veränderungen des Gesichtsausdrucks. Solche Details sind für Materialien hilfreich, deren Bilder aus der Nähe betrachtet werden.
Qwen-Image-3.0-Pro ist außerdem für visuelle Konzepte von Webseiten, Spielen und Livestream-Oberflächen vorgesehen. In einem solchen Ergebnis lassen sich Illustration, Bildschirmstruktur und gestaltete Schrift verbinden. Das Modell erzeugt ein Bild des Layouts; eine funktionsfähige Anwendung erfordert eine separate Umsetzung.
Für den Bearbeitungsmodus gibt Alibaba ein bis drei Bilder an. Bei diesem Verfahren erlaubt der Hersteller, ein Objekt mit der Nummer einer Referenz zu verknüpfen und die Kombination von Materialien zu beschreiben. Vorgesehen sind das Hinzufügen, Entfernen und Verschieben von Objekten sowie Änderungen an Handlung, Stil, Details und Text. Eine negative Beschreibung hilft, unerwünschte Elemente zu benennen.
Der Bearbeitungsmodus des Herstellers akzeptiert Eingabematerial in JPG, JPEG, PNG, BMP, TIFF, WEBP und GIF. Bei einem animierten GIF wird das erste Bild verwendet. Jede Datei darf bis zu 10 MB groß sein; der Hersteller empfiehlt Bilder mit Seitenlängen von 384 bis 3072 Pixeln. Das sind Empfehlungen für die Eingabe, nicht die Abmessungen des fertigen Ergebnisses.
Die Herstellerspezifikation sieht ein bis sechs Ausgabebilder in PNG pro Anfrage vor. Die Bildfläche des Ergebnisses reicht von 262 144 bis 4 194 304 Pixeln; das entspricht quadratischen Bildern von 512 × 512 bis 2048 × 2048. Seitenverhältnisse von 1:8 bis 8:1 sind zulässig. Bei langgezogenen Kompositionen hängt die Seitenlänge daher auch vom gewählten Bildformat ab. Eine zusätzliche Überarbeitung der Vorgabe vor der Generierung ist vorgesehen.
POST /v1/images/generationstextimage| Feld | Typ | Anforderung | Werte und Limits | Standard |
|---|---|---|---|---|
Feldmodel | Typstring | AnforderungErforderlich | Werte und Limits qwen-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: 10.485.760 MIME-Typen: image/png, image/jpeg Maximale Anzahl Bilder je Array: 3 Bedingungen: Eine tatsächliche URL pro images[]-Objekt. Die Anzahl der Arrayelemente ist von diesem Zeichenfolgen-Endknoten zu unterscheiden. Gilt, wenn: Nur JSON images/edits; JSON images/generations parst keine Bildreferenzen. | Standard— |
Feldimage | Typfile | AnforderungOptional | Werte und Limits Maximale Anzahl dekodierter Bytes: 10.485.760 MIME-Typen: image/png, image/jpeg Gilt, wenn: Generierung mit multipart/form-data | Standard— |
Feldimage[] | Typfile[] | AnforderungOptional | Werte und Limits Maximale Anzahl Elemente: 3 Maximale Anzahl dekodierter Bytes: 10.485.760 MIME-Typen: image/png, image/jpeg Gilt, wenn: Generierung 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 abschließenden Verbrauchsdatensatzes. So funktionieren Reservierung und Abrechnung →
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": "qwen-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': 'qwen-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": "qwen-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 qwen-image-3.0-pro, qwen-image, qwen-image-latest
Verwenden Sie die oben angezeigten Methodenpfade.
qwen-image-latestModell zur Bildgenerierung aus Text mit Schwerpunkt auf komplexen Layouts, Schrift und realistischen Details. Geeignet für Poster, Storyboards, Speisekarten und Materialien mit dichter Komposition.
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.
Qwen-Image-3.0-Pro ist ein Modell von Alibaba zur Erstellung und Bearbeitung von Bildern, bei denen Komposition, Schrift und kleine Details wichtig sind. Zu seinen Anwendungsbereichen gehören dichte Layouts, Bilder im Bild, Zeitungslayouts, Storyboards, Speisekarten und Arbeitsblätter. Die aktuelle Ailoot-Karte bietet den Modus zur Bildgenerierung aus einer Textvorgabe. Alibaba sieht auch Bearbeitung und die Arbeit mit Referenzbildern vor; diese Operationen erfordern eine separate Unterstützung für Eingabebilder und sind in der aktuellen Methode der Karte nicht enthalten.
Der Hersteller hebt lange Vorgaben mit bis zu 4,5 Tausend Tokens, Schrift in 12 Sprachen und die Arbeit mit mehreren Schriftarten hervor. Das beschreibt die Verarbeitung von Vorgaben, nicht eine veröffentlichte Größe des formalen Kontextfensters. Zu den genannten Eigenschaften gehören die Wiedergabe kleiner Schrift mit 10 Pixeln, Haut- und Haartexturen sowie geringfügiger Veränderungen des Gesichtsausdrucks. Solche Details sind für Materialien hilfreich, deren Bilder aus der Nähe betrachtet werden.
Qwen-Image-3.0-Pro ist außerdem für visuelle Konzepte von Webseiten, Spielen und Livestream-Oberflächen vorgesehen. In einem solchen Ergebnis lassen sich Illustration, Bildschirmstruktur und gestaltete Schrift verbinden. Das Modell erzeugt ein Bild des Layouts; eine funktionsfähige Anwendung erfordert eine separate Umsetzung.
Für den Bearbeitungsmodus gibt Alibaba ein bis drei Bilder an. Bei diesem Verfahren erlaubt der Hersteller, ein Objekt mit der Nummer einer Referenz zu verknüpfen und die Kombination von Materialien zu beschreiben. Vorgesehen sind das Hinzufügen, Entfernen und Verschieben von Objekten sowie Änderungen an Handlung, Stil, Details und Text. Eine negative Beschreibung hilft, unerwünschte Elemente zu benennen.
Der Bearbeitungsmodus des Herstellers akzeptiert Eingabematerial in JPG, JPEG, PNG, BMP, TIFF, WEBP und GIF. Bei einem animierten GIF wird das erste Bild verwendet. Jede Datei darf bis zu 10 MB groß sein; der Hersteller empfiehlt Bilder mit Seitenlängen von 384 bis 3072 Pixeln. Das sind Empfehlungen für die Eingabe, nicht die Abmessungen des fertigen Ergebnisses.
Die Herstellerspezifikation sieht ein bis sechs Ausgabebilder in PNG pro Anfrage vor. Die Bildfläche des Ergebnisses reicht von 262 144 bis 4 194 304 Pixeln; das entspricht quadratischen Bildern von 512 × 512 bis 2048 × 2048. Seitenverhältnisse von 1:8 bis 8:1 sind zulässig. Bei langgezogenen Kompositionen hängt die Seitenlänge daher auch vom gewählten Bildformat ab. Eine zusätzliche Überarbeitung der Vorgabe vor der Generierung ist vorgesehen.
POST /v1/images/generationstextimage| Feld | Typ | Anforderung | Werte und Limits | Standard |
|---|---|---|---|---|
Feldmodel | Typstring | AnforderungErforderlich | Werte und Limits qwen-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: 10.485.760 MIME-Typen: image/png, image/jpeg Maximale Anzahl Bilder je Array: 3 Bedingungen: Eine tatsächliche URL pro images[]-Objekt. Die Anzahl der Arrayelemente ist von diesem Zeichenfolgen-Endknoten zu unterscheiden. Gilt, wenn: Nur JSON images/edits; JSON images/generations parst keine Bildreferenzen. | Standard— |
Feldimage | Typfile | AnforderungOptional | Werte und Limits Maximale Anzahl dekodierter Bytes: 10.485.760 MIME-Typen: image/png, image/jpeg Gilt, wenn: Generierung mit multipart/form-data | Standard— |
Feldimage[] | Typfile[] | AnforderungOptional | Werte und Limits Maximale Anzahl Elemente: 3 Maximale Anzahl dekodierter Bytes: 10.485.760 MIME-Typen: image/png, image/jpeg Gilt, wenn: Generierung 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 abschließenden Verbrauchsdatensatzes. So funktionieren Reservierung und Abrechnung →
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": "qwen-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': 'qwen-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": "qwen-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 qwen-image-3.0-pro, qwen-image, qwen-image-latest
Verwenden Sie die oben angezeigten Methodenpfade.