Qwen-Image-3.0-Pro is een model van Alibaba voor het maken en bewerken van afbeeldingen waarin compositie, tekst en kleine details belangrijk zijn. De toepassingen omvatten rijke lay-outs, een afbeelding binnen een afbeelding, krantenopmaak, storyboards, menu's en werkbladen. De huidige Ailoot-kaart biedt beeldgeneratie op basis van een tekstuele opdracht. Alibaba biedt ook bewerking en het gebruik van referentieafbeeldingen; die bewerkingen vereisen afzonderlijke ondersteuning voor invoerafbeeldingen en worden niet aangeboden door de huidige methode van de kaart.
De fabrikant benadrukt lange opdrachten tot 4,5 duizend tokens, tekst in 12 talen en het gebruik van meerdere lettertypen. Dit beschrijft het vermogen om de opdracht te verwerken en is geen gepubliceerde omvang van het formele contextvenster. Tot de genoemde eigenschappen behoren het weergeven van kleine tekst van 10 pixels, huid- en haartexturen en kleine veranderingen in gezichtsuitdrukkingen. Die details zijn nuttig bij materiaal dat van dichtbij wordt bekeken.
Qwen-Image-3.0-Pro is ook bedoeld voor visuele concepten van webpagina's, games en livestreamschermen. Zo'n resultaat kan een illustratie, schermstructuur en opgemaakte tekst combineren. Het model maakt een afbeelding van de lay-out; een werkende toepassing vereist afzonderlijke implementatie.
Voor de bewerkingsmodus geeft Alibaba één tot drie afbeeldingen op. Binnen deze werkwijze kan een object worden gekoppeld aan het nummer van een referentie en kan de combinatie van het materiaal worden beschreven. Het toevoegen, verwijderen en verplaatsen van objecten en het veranderen van actie, stijl, details en tekst zijn voorzien. Een negatieve beschrijving helpt ongewenste elementen aan te geven.
De bewerkingsmodus van de fabrikant accepteert invoermateriaal in JPG, JPEG, PNG, BMP, TIFF, WEBP en GIF. Van een geanimeerde GIF wordt het eerste frame gebruikt. Elk bestand mag maximaal 10 MB zijn; de fabrikant beveelt afbeeldingen aan met zijden van 384 tot 3072 pixels. Dit zijn aanbevelingen voor de invoer, niet de afmetingen van het uiteindelijke resultaat.
De specificatie van de fabrikant voorziet in één tot zes uitvoerafbeeldingen in PNG per verzoek. Het oppervlak van het resultaat varieert van 262 144 tot 4 194 304 pixels, overeenkomend met vierkante afbeeldingen van 512 × 512 tot 2048 × 2048. Beeldverhoudingen van 1:8 tot 8:1 zijn toegestaan; bij een langgerekte compositie hangt de lengte van een zijde dus ook af van de gekozen beeldvorm. Een aanvullende herwerking van de opdracht vóór generatie is voorzien.
", "aboutText": "Qwen-Image-3.0-Pro is een model van Alibaba voor het maken en bewerken van afbeeldingen waarin compositie, tekst en kleine details belangrijk zijn. De toepassingen omvatten rijke lay-outs, een afbeelding binnen een afbeelding, krantenopmaak, storyboards, menu's en werkbladen. De huidige Ailoot-kaart biedt beeldgeneratie op basis van een tekstuele opdracht. Alibaba biedt ook bewerking en het gebruik van referentieafbeeldingen; die bewerkingen vereisen afzonderlijke ondersteuning voor invoerafbeeldingen en worden niet aangeboden door de huidige methode van de kaart.\n\n### Tekst en details in het beeld\n\nDe fabrikant benadrukt lange opdrachten tot 4,5 duizend tokens, tekst in 12 talen en het gebruik van meerdere lettertypen. Dit beschrijft het vermogen om de opdracht te verwerken en is geen gepubliceerde omvang van het formele contextvenster. Tot de genoemde eigenschappen behoren het weergeven van kleine tekst van 10 pixels, huid- en haartexturen en kleine veranderingen in gezichtsuitdrukkingen. Die details zijn nuttig bij materiaal dat van dichtbij wordt bekeken.\n\nQwen-Image-3.0-Pro is ook bedoeld voor visuele concepten van webpagina's, games en livestreamschermen. Zo'n resultaat kan een illustratie, schermstructuur en opgemaakte tekst combineren. Het model maakt een afbeelding van de lay-out; een werkende toepassing vereist afzonderlijke implementatie.\n\n### Bewerking in de specificatie van Alibaba\n\nVoor de bewerkingsmodus geeft Alibaba één tot drie afbeeldingen op. Binnen deze werkwijze kan een object worden gekoppeld aan het nummer van een referentie en kan de combinatie van het materiaal worden beschreven. Het toevoegen, verwijderen en verplaatsen van objecten en het veranderen van actie, stijl, details en tekst zijn voorzien. Een negatieve beschrijving helpt ongewenste elementen aan te geven.\n\nDe bewerkingsmodus van de fabrikant accepteert invoermateriaal in JPG, JPEG, PNG, BMP, TIFF, WEBP en GIF. Van een geanimeerde GIF wordt het eerste frame gebruikt. Elk bestand mag maximaal 10 MB zijn; de fabrikant beveelt afbeeldingen aan met zijden van 384 tot 3072 pixels. Dit zijn aanbevelingen voor de invoer, niet de afmetingen van het uiteindelijke resultaat.\n\nDe specificatie van de fabrikant voorziet in één tot zes uitvoerafbeeldingen in PNG per verzoek. Het oppervlak van het resultaat varieert van 262 144 tot 4 194 304 pixels, overeenkomend met vierkante afbeeldingen van 512 × 512 tot 2048 × 2048. Beeldverhoudingen van 1:8 tot 8:1 zijn toegestaan; bij een langgerekte compositie hangt de lengte van een zijde dus ook af van de gekozen beeldvorm. Een aanvullende herwerking van de opdracht vóór generatie is voorzien.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "e931a27d14953c86f0494e715037f534f292b6546cd3d76048bba28dd6a28066", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "nl-be", "methods": [ { "html": "qwen-image-3.0-proEen model voor beeldgeneratie uit tekst, met de nadruk op complexe lay-outs, tekst in beeld en realistische details. Geschikt voor posters, storyboards, menu's en materiaal met een rijke compositie.
Deze beschrijving gaat over de mogelijkheden van het model. De via Ailoot beschikbare invoer, uitvoer en opties staan hieronder voor de geselecteerde methode.
Qwen-Image-3.0-Pro is een model van Alibaba voor het maken en bewerken van afbeeldingen waarin compositie, tekst en kleine details belangrijk zijn. De toepassingen omvatten rijke lay-outs, een afbeelding binnen een afbeelding, krantenopmaak, storyboards, menu's en werkbladen. De huidige Ailoot-kaart biedt beeldgeneratie op basis van een tekstuele opdracht. Alibaba biedt ook bewerking en het gebruik van referentieafbeeldingen; die bewerkingen vereisen afzonderlijke ondersteuning voor invoerafbeeldingen en worden niet aangeboden door de huidige methode van de kaart.
De fabrikant benadrukt lange opdrachten tot 4,5 duizend tokens, tekst in 12 talen en het gebruik van meerdere lettertypen. Dit beschrijft het vermogen om de opdracht te verwerken en is geen gepubliceerde omvang van het formele contextvenster. Tot de genoemde eigenschappen behoren het weergeven van kleine tekst van 10 pixels, huid- en haartexturen en kleine veranderingen in gezichtsuitdrukkingen. Die details zijn nuttig bij materiaal dat van dichtbij wordt bekeken.
Qwen-Image-3.0-Pro is ook bedoeld voor visuele concepten van webpagina's, games en livestreamschermen. Zo'n resultaat kan een illustratie, schermstructuur en opgemaakte tekst combineren. Het model maakt een afbeelding van de lay-out; een werkende toepassing vereist afzonderlijke implementatie.
Voor de bewerkingsmodus geeft Alibaba één tot drie afbeeldingen op. Binnen deze werkwijze kan een object worden gekoppeld aan het nummer van een referentie en kan de combinatie van het materiaal worden beschreven. Het toevoegen, verwijderen en verplaatsen van objecten en het veranderen van actie, stijl, details en tekst zijn voorzien. Een negatieve beschrijving helpt ongewenste elementen aan te geven.
De bewerkingsmodus van de fabrikant accepteert invoermateriaal in JPG, JPEG, PNG, BMP, TIFF, WEBP en GIF. Van een geanimeerde GIF wordt het eerste frame gebruikt. Elk bestand mag maximaal 10 MB zijn; de fabrikant beveelt afbeeldingen aan met zijden van 384 tot 3072 pixels. Dit zijn aanbevelingen voor de invoer, niet de afmetingen van het uiteindelijke resultaat.
De specificatie van de fabrikant voorziet in één tot zes uitvoerafbeeldingen in PNG per verzoek. Het oppervlak van het resultaat varieert van 262 144 tot 4 194 304 pixels, overeenkomend met vierkante afbeeldingen van 512 × 512 tot 2048 × 2048. Beeldverhoudingen van 1:8 tot 8:1 zijn toegestaan; bij een langgerekte compositie hangt de lengte van een zijde dus ook af van de gekozen beeldvorm. Een aanvullende herwerking van de opdracht vóór generatie is voorzien.
POST /v1/images/generationstextimage| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten qwen-image-3.0-pro | Standaard— |
Veldprompt | Typestring | VereisteVereist | Waarden en limieten Minimumlengte: 1 | Standaard— |
Veldn | Typeinteger | VereisteOptioneel | Waarden en limieten Minimum: 1 | Standaard1 |
Veldresponse_format | Typestring | VereisteOptioneel | Waarden en limieten url, b64_json | Standaard— |
Veldstream | Typeboolean | VereisteOptioneel | Waarden en limieten | Standaardfalse |
Veldsize | Typestring | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Veldpartial_images | Typeinteger | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Veldimages[].image_url | Typestring | VereisteNiet ondersteund | Waarden en limieten Maximumaantal gedecodeerde bytes: 10.485.760 MIME-typen: image/png, image/jpeg Maximumaantal afbeeldingen per array: 3 Voorwaarden: Eén werkelijke URL per images[]-object. Het aantal array-items staat los van dit bladveld met een tekenreeks. Geldt wanneer: Alleen JSON images/edits; JSON images/generations verwerkt geen afbeeldingsreferenties. | Standaard— |
Veldimage | Typefile | VereisteOptioneel | Waarden en limieten Maximumaantal gedecodeerde bytes: 10.485.760 MIME-typen: image/png, image/jpeg Geldt wanneer: generatie via multipart/form-data | Standaard— |
Veldimage[] | Typefile[] | VereisteOptioneel | Waarden en limieten Maximumaantal items: 3 Maximumaantal gedecodeerde bytes: 10.485.760 MIME-typen: image/png, image/jpeg Geldt wanneer: generatie via multipart/form-data | Standaard— |
Tekst naar afbeelding · Vereist: prompt
reference_images_generation · Vereist: prompt
| Parameter | Contract |
|---|---|
Parametermaterial_types | Contracttext |
Parameterrequired | Contractmodel, prompt |
Parameteroptional_controls | Contractnull |
Parametercontent_type | Contractapplication/json |
Levenscyclus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · daadwerkelijk teruggegeven task_id of record in de mediabibliotheek
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
De methodestructuren en ID’s zijn exact; de mogelijkheden van de leverancier staan los van toelating.
POST /v1/images/generationsAiloot reserveert vóór een verzoek een geschat bedrag. Na het resultaat worden de uiteindelijke kosten afgerekend op basis van het gemeten verbruik. Bij streaming gebeurt de afrekening op basis van de definitieve verbruiksregistratie. Zo werken reservering en afrekening →
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");\nDownload elke teruggegeven afbeelding of sla de Base64-inhoud ervan op
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}Sla elke voltooide afbeelding op; haal elke teruggegeven URL op of decodeer de bijbehorende Base64-inhoud.
Sla elk gegevensitem op. Decodeer elke b64_json of haal elke teruggegeven ondertekende URL op. Kies een bestandsextensie op basis van de daadwerkelijke MIME/bytes.
Als het resultaat van een afbeeldingsgeneratie of -bewerking gecontroleerd moet worden, bewaar dan de oorspronkelijke operation_id/X-Client-Request-ID en de teruggegeven resultaatinformatie. Haal bestaande eigen resultaten terug via de mediabibliotheek met daadwerkelijk teruggegeven task_id- of asset_id-waarden. Dien de generatie- of bewerkingsaanvraag niet opnieuw in en stel geen polling-URL samen op basis van operation_id.
| Veld | Type |
|---|---|
Veldcreated | Typeinteger |
Velddata[].url | Typestring |
Velddata[].b64_json | Typebase64 string |
Veldusage | Typeobject |
| Antwoord | Voorwaarde | Volgende stap |
|---|---|---|
Antwoord400 · invalid_request_error | VoorwaardeVerplichte velden, de materiaalrepresentatie of een parameterwaarde zijn ongeldig | Volgende stapCorrigeer de aangegeven velden vóór een nieuwe aanmaakaanvraag. |
Antwoordserver_error | VoorwaardeDe teruggegeven respons geeft aan dat de bewerking of het resultaat gecontroleerd moet worden | Volgende stapBewaar de oorspronkelijk teruggegeven bewerkings-/taak-ID, aanvraagheaders en respons; blijf de oorspronkelijke bewerking uitlezen via de ondersteunde leesaanvragen. Dien de aanmaakaanvraag niet opnieuw in. |
Ailoot qwen-image-3.0-pro, qwen-image, qwen-image-latest
Gebruik de hierboven getoonde methodepaden.
qwen-imageEen model voor beeldgeneratie uit tekst, met de nadruk op complexe lay-outs, tekst in beeld en realistische details. Geschikt voor posters, storyboards, menu's en materiaal met een rijke compositie.
Deze beschrijving gaat over de mogelijkheden van het model. De via Ailoot beschikbare invoer, uitvoer en opties staan hieronder voor de geselecteerde methode.
Qwen-Image-3.0-Pro is een model van Alibaba voor het maken en bewerken van afbeeldingen waarin compositie, tekst en kleine details belangrijk zijn. De toepassingen omvatten rijke lay-outs, een afbeelding binnen een afbeelding, krantenopmaak, storyboards, menu's en werkbladen. De huidige Ailoot-kaart biedt beeldgeneratie op basis van een tekstuele opdracht. Alibaba biedt ook bewerking en het gebruik van referentieafbeeldingen; die bewerkingen vereisen afzonderlijke ondersteuning voor invoerafbeeldingen en worden niet aangeboden door de huidige methode van de kaart.
De fabrikant benadrukt lange opdrachten tot 4,5 duizend tokens, tekst in 12 talen en het gebruik van meerdere lettertypen. Dit beschrijft het vermogen om de opdracht te verwerken en is geen gepubliceerde omvang van het formele contextvenster. Tot de genoemde eigenschappen behoren het weergeven van kleine tekst van 10 pixels, huid- en haartexturen en kleine veranderingen in gezichtsuitdrukkingen. Die details zijn nuttig bij materiaal dat van dichtbij wordt bekeken.
Qwen-Image-3.0-Pro is ook bedoeld voor visuele concepten van webpagina's, games en livestreamschermen. Zo'n resultaat kan een illustratie, schermstructuur en opgemaakte tekst combineren. Het model maakt een afbeelding van de lay-out; een werkende toepassing vereist afzonderlijke implementatie.
Voor de bewerkingsmodus geeft Alibaba één tot drie afbeeldingen op. Binnen deze werkwijze kan een object worden gekoppeld aan het nummer van een referentie en kan de combinatie van het materiaal worden beschreven. Het toevoegen, verwijderen en verplaatsen van objecten en het veranderen van actie, stijl, details en tekst zijn voorzien. Een negatieve beschrijving helpt ongewenste elementen aan te geven.
De bewerkingsmodus van de fabrikant accepteert invoermateriaal in JPG, JPEG, PNG, BMP, TIFF, WEBP en GIF. Van een geanimeerde GIF wordt het eerste frame gebruikt. Elk bestand mag maximaal 10 MB zijn; de fabrikant beveelt afbeeldingen aan met zijden van 384 tot 3072 pixels. Dit zijn aanbevelingen voor de invoer, niet de afmetingen van het uiteindelijke resultaat.
De specificatie van de fabrikant voorziet in één tot zes uitvoerafbeeldingen in PNG per verzoek. Het oppervlak van het resultaat varieert van 262 144 tot 4 194 304 pixels, overeenkomend met vierkante afbeeldingen van 512 × 512 tot 2048 × 2048. Beeldverhoudingen van 1:8 tot 8:1 zijn toegestaan; bij een langgerekte compositie hangt de lengte van een zijde dus ook af van de gekozen beeldvorm. Een aanvullende herwerking van de opdracht vóór generatie is voorzien.
POST /v1/images/generationstextimage| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten qwen-image | Standaard— |
Veldprompt | Typestring | VereisteVereist | Waarden en limieten Minimumlengte: 1 | Standaard— |
Veldn | Typeinteger | VereisteOptioneel | Waarden en limieten Minimum: 1 | Standaard1 |
Veldresponse_format | Typestring | VereisteOptioneel | Waarden en limieten url, b64_json | Standaard— |
Veldstream | Typeboolean | VereisteOptioneel | Waarden en limieten | Standaardfalse |
Veldsize | Typestring | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Veldpartial_images | Typeinteger | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Veldimages[].image_url | Typestring | VereisteNiet ondersteund | Waarden en limieten Maximumaantal gedecodeerde bytes: 10.485.760 MIME-typen: image/png, image/jpeg Maximumaantal afbeeldingen per array: 3 Voorwaarden: Eén werkelijke URL per images[]-object. Het aantal array-items staat los van dit bladveld met een tekenreeks. Geldt wanneer: Alleen JSON images/edits; JSON images/generations verwerkt geen afbeeldingsreferenties. | Standaard— |
Veldimage | Typefile | VereisteOptioneel | Waarden en limieten Maximumaantal gedecodeerde bytes: 10.485.760 MIME-typen: image/png, image/jpeg Geldt wanneer: generatie via multipart/form-data | Standaard— |
Veldimage[] | Typefile[] | VereisteOptioneel | Waarden en limieten Maximumaantal items: 3 Maximumaantal gedecodeerde bytes: 10.485.760 MIME-typen: image/png, image/jpeg Geldt wanneer: generatie via multipart/form-data | Standaard— |
Tekst naar afbeelding · Vereist: prompt
reference_images_generation · Vereist: prompt
| Parameter | Contract |
|---|---|
Parametermaterial_types | Contracttext |
Parameterrequired | Contractmodel, prompt |
Parameteroptional_controls | Contractnull |
Parametercontent_type | Contractapplication/json |
Levenscyclus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · daadwerkelijk teruggegeven task_id of record in de mediabibliotheek
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
De methodestructuren en ID’s zijn exact; de mogelijkheden van de leverancier staan los van toelating.
POST /v1/images/generationsAiloot reserveert vóór een verzoek een geschat bedrag. Na het resultaat worden de uiteindelijke kosten afgerekend op basis van het gemeten verbruik. Bij streaming gebeurt de afrekening op basis van de definitieve verbruiksregistratie. Zo werken reservering en afrekening →
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");\nDownload elke teruggegeven afbeelding of sla de Base64-inhoud ervan op
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}Sla elke voltooide afbeelding op; haal elke teruggegeven URL op of decodeer de bijbehorende Base64-inhoud.
Sla elk gegevensitem op. Decodeer elke b64_json of haal elke teruggegeven ondertekende URL op. Kies een bestandsextensie op basis van de daadwerkelijke MIME/bytes.
Als het resultaat van een afbeeldingsgeneratie of -bewerking gecontroleerd moet worden, bewaar dan de oorspronkelijke operation_id/X-Client-Request-ID en de teruggegeven resultaatinformatie. Haal bestaande eigen resultaten terug via de mediabibliotheek met daadwerkelijk teruggegeven task_id- of asset_id-waarden. Dien de generatie- of bewerkingsaanvraag niet opnieuw in en stel geen polling-URL samen op basis van operation_id.
| Veld | Type |
|---|---|
Veldcreated | Typeinteger |
Velddata[].url | Typestring |
Velddata[].b64_json | Typebase64 string |
Veldusage | Typeobject |
| Antwoord | Voorwaarde | Volgende stap |
|---|---|---|
Antwoord400 · invalid_request_error | VoorwaardeVerplichte velden, de materiaalrepresentatie of een parameterwaarde zijn ongeldig | Volgende stapCorrigeer de aangegeven velden vóór een nieuwe aanmaakaanvraag. |
Antwoordserver_error | VoorwaardeDe teruggegeven respons geeft aan dat de bewerking of het resultaat gecontroleerd moet worden | Volgende stapBewaar de oorspronkelijk teruggegeven bewerkings-/taak-ID, aanvraagheaders en respons; blijf de oorspronkelijke bewerking uitlezen via de ondersteunde leesaanvragen. Dien de aanmaakaanvraag niet opnieuw in. |
Ailoot qwen-image-3.0-pro, qwen-image, qwen-image-latest
Gebruik de hierboven getoonde methodepaden.
qwen-image-latestEen model voor beeldgeneratie uit tekst, met de nadruk op complexe lay-outs, tekst in beeld en realistische details. Geschikt voor posters, storyboards, menu's en materiaal met een rijke compositie.
Deze beschrijving gaat over de mogelijkheden van het model. De via Ailoot beschikbare invoer, uitvoer en opties staan hieronder voor de geselecteerde methode.
Qwen-Image-3.0-Pro is een model van Alibaba voor het maken en bewerken van afbeeldingen waarin compositie, tekst en kleine details belangrijk zijn. De toepassingen omvatten rijke lay-outs, een afbeelding binnen een afbeelding, krantenopmaak, storyboards, menu's en werkbladen. De huidige Ailoot-kaart biedt beeldgeneratie op basis van een tekstuele opdracht. Alibaba biedt ook bewerking en het gebruik van referentieafbeeldingen; die bewerkingen vereisen afzonderlijke ondersteuning voor invoerafbeeldingen en worden niet aangeboden door de huidige methode van de kaart.
De fabrikant benadrukt lange opdrachten tot 4,5 duizend tokens, tekst in 12 talen en het gebruik van meerdere lettertypen. Dit beschrijft het vermogen om de opdracht te verwerken en is geen gepubliceerde omvang van het formele contextvenster. Tot de genoemde eigenschappen behoren het weergeven van kleine tekst van 10 pixels, huid- en haartexturen en kleine veranderingen in gezichtsuitdrukkingen. Die details zijn nuttig bij materiaal dat van dichtbij wordt bekeken.
Qwen-Image-3.0-Pro is ook bedoeld voor visuele concepten van webpagina's, games en livestreamschermen. Zo'n resultaat kan een illustratie, schermstructuur en opgemaakte tekst combineren. Het model maakt een afbeelding van de lay-out; een werkende toepassing vereist afzonderlijke implementatie.
Voor de bewerkingsmodus geeft Alibaba één tot drie afbeeldingen op. Binnen deze werkwijze kan een object worden gekoppeld aan het nummer van een referentie en kan de combinatie van het materiaal worden beschreven. Het toevoegen, verwijderen en verplaatsen van objecten en het veranderen van actie, stijl, details en tekst zijn voorzien. Een negatieve beschrijving helpt ongewenste elementen aan te geven.
De bewerkingsmodus van de fabrikant accepteert invoermateriaal in JPG, JPEG, PNG, BMP, TIFF, WEBP en GIF. Van een geanimeerde GIF wordt het eerste frame gebruikt. Elk bestand mag maximaal 10 MB zijn; de fabrikant beveelt afbeeldingen aan met zijden van 384 tot 3072 pixels. Dit zijn aanbevelingen voor de invoer, niet de afmetingen van het uiteindelijke resultaat.
De specificatie van de fabrikant voorziet in één tot zes uitvoerafbeeldingen in PNG per verzoek. Het oppervlak van het resultaat varieert van 262 144 tot 4 194 304 pixels, overeenkomend met vierkante afbeeldingen van 512 × 512 tot 2048 × 2048. Beeldverhoudingen van 1:8 tot 8:1 zijn toegestaan; bij een langgerekte compositie hangt de lengte van een zijde dus ook af van de gekozen beeldvorm. Een aanvullende herwerking van de opdracht vóór generatie is voorzien.
POST /v1/images/generationstextimage| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten qwen-image-latest | Standaard— |
Veldprompt | Typestring | VereisteVereist | Waarden en limieten Minimumlengte: 1 | Standaard— |
Veldn | Typeinteger | VereisteOptioneel | Waarden en limieten Minimum: 1 | Standaard1 |
Veldresponse_format | Typestring | VereisteOptioneel | Waarden en limieten url, b64_json | Standaard— |
Veldstream | Typeboolean | VereisteOptioneel | Waarden en limieten | Standaardfalse |
Veldsize | Typestring | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Veldpartial_images | Typeinteger | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Veldimages[].image_url | Typestring | VereisteNiet ondersteund | Waarden en limieten Maximumaantal gedecodeerde bytes: 10.485.760 MIME-typen: image/png, image/jpeg Maximumaantal afbeeldingen per array: 3 Voorwaarden: Eén werkelijke URL per images[]-object. Het aantal array-items staat los van dit bladveld met een tekenreeks. Geldt wanneer: Alleen JSON images/edits; JSON images/generations verwerkt geen afbeeldingsreferenties. | Standaard— |
Veldimage | Typefile | VereisteOptioneel | Waarden en limieten Maximumaantal gedecodeerde bytes: 10.485.760 MIME-typen: image/png, image/jpeg Geldt wanneer: generatie via multipart/form-data | Standaard— |
Veldimage[] | Typefile[] | VereisteOptioneel | Waarden en limieten Maximumaantal items: 3 Maximumaantal gedecodeerde bytes: 10.485.760 MIME-typen: image/png, image/jpeg Geldt wanneer: generatie via multipart/form-data | Standaard— |
Tekst naar afbeelding · Vereist: prompt
reference_images_generation · Vereist: prompt
| Parameter | Contract |
|---|---|
Parametermaterial_types | Contracttext |
Parameterrequired | Contractmodel, prompt |
Parameteroptional_controls | Contractnull |
Parametercontent_type | Contractapplication/json |
Levenscyclus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · daadwerkelijk teruggegeven task_id of record in de mediabibliotheek
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
De methodestructuren en ID’s zijn exact; de mogelijkheden van de leverancier staan los van toelating.
POST /v1/images/generationsAiloot reserveert vóór een verzoek een geschat bedrag. Na het resultaat worden de uiteindelijke kosten afgerekend op basis van het gemeten verbruik. Bij streaming gebeurt de afrekening op basis van de definitieve verbruiksregistratie. Zo werken reservering en afrekening →
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");\nDownload elke teruggegeven afbeelding of sla de Base64-inhoud ervan op
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}Sla elke voltooide afbeelding op; haal elke teruggegeven URL op of decodeer de bijbehorende Base64-inhoud.
Sla elk gegevensitem op. Decodeer elke b64_json of haal elke teruggegeven ondertekende URL op. Kies een bestandsextensie op basis van de daadwerkelijke MIME/bytes.
Als het resultaat van een afbeeldingsgeneratie of -bewerking gecontroleerd moet worden, bewaar dan de oorspronkelijke operation_id/X-Client-Request-ID en de teruggegeven resultaatinformatie. Haal bestaande eigen resultaten terug via de mediabibliotheek met daadwerkelijk teruggegeven task_id- of asset_id-waarden. Dien de generatie- of bewerkingsaanvraag niet opnieuw in en stel geen polling-URL samen op basis van operation_id.
| Veld | Type |
|---|---|
Veldcreated | Typeinteger |
Velddata[].url | Typestring |
Velddata[].b64_json | Typebase64 string |
Veldusage | Typeobject |
| Antwoord | Voorwaarde | Volgende stap |
|---|---|---|
Antwoord400 · invalid_request_error | VoorwaardeVerplichte velden, de materiaalrepresentatie of een parameterwaarde zijn ongeldig | Volgende stapCorrigeer de aangegeven velden vóór een nieuwe aanmaakaanvraag. |
Antwoordserver_error | VoorwaardeDe teruggegeven respons geeft aan dat de bewerking of het resultaat gecontroleerd moet worden | Volgende stapBewaar de oorspronkelijk teruggegeven bewerkings-/taak-ID, aanvraagheaders en respons; blijf de oorspronkelijke bewerking uitlezen via de ondersteunde leesaanvragen. Dien de aanmaakaanvraag niet opnieuw in. |
Ailoot qwen-image-3.0-pro, qwen-image, qwen-image-latest
Gebruik de hierboven getoonde methodepaden.