GPT Image 2.5 Flare is de editie van OpenAI voor beeldgeneratie en -bewerking die is gepositioneerd voor snel dagelijks werk van hoge kwaliteit. Het accepteert tekst en afbeeldingen en levert beeldresultaten op. Gebruik het voor visuele schetsen, illustraties, productconcepten en terugkerende creatieve taken waarbij een briefing snel een bruikbare afbeelding moet worden. Flare staat los van Sunburst, waarvan de positionering de nadruk legt op nauwkeurige bewerking. Kies Flare voor routinematige beeldcreatie en Sunburst wanneer precieze bewerking vooropstaat.
Begin met het hoofdonderwerp, de handeling, omgeving, compositie en visuele uitwerking. Vraag voor een campagne-illustratie om een fietser die bij warm avondlicht een kleine brug oversteekt, met een krachtig silhouet en open lucht voor latere tekst. Een beknopte verkennende briefing kan esthetische beslissingen openlaten; een productiebriefing moet de details en plaatsing benoemen die belangrijk zijn. De directe generatie- en bewerkingsworkflows staan prompts tot 32,000 tekens en één tot tien resultaten toe, wat nuttig is om enkele varianten tegen hetzelfde doel af te zetten.
Bij bewerking kun je maximaal zestien referentieafbeeldingen aanleveren. Geef elke referentie een duidelijke rol, in plaats van te verwachten dat het model bepaalt of een afbeelding de identiteit van het onderwerp, het decor of de stijl weergeeft. Een masker kan een wijziging van een gebied sturen; bij meerdere afbeeldingen geldt het voor de eerste. De afbeelding en het masker moeten hetzelfde formaat en dezelfde afmetingen hebben en het masker moet een alfakanaal bevatten. De handleiding vereist dat bron en masker kleiner zijn dan 50 MB. Een masker geeft richting en belooft geen exact behoud van grenzen. Benoem daarom zowel de gewenste wijziging als wat herkenbaar moet blijven.
Flare ondersteunt low, medium, high, xhigh, max en automatische kwaliteit, met auto als standaard. Lagere kwaliteit kan dienen voor een snelle visuele schets; hogere instellingen kunnen voor de details van een definitief beeld worden vergeleken. Kwaliteit staat los van formaat en uitvoercompressie. Standaardformaten zijn onder meer 1024 × 1024, 1536 × 1024 en 1024 × 1536; automatische of aangepaste afmetingen zijn ook beschikbaar. Kies de oriëntatie op basis van de uiteindelijke plaatsing en de bruikbare ruimte in de scène.
Aangepaste breedte en hoogte moeten veelvouden van zestien zijn, waarbij geen van beide zijden langer mag zijn dan 3840 pixels. De toegestane verhouding loopt van 1:3 tot 3:1 en het totale oppervlak moet minstens 655,360 en maximaal 8,294,400 pixels zijn. Alle vier voorwaarden gelden samen. De handleiding noemt resoluties boven 2560 × 1440 experimenteel. Gebruik een geldig beeldformaat dat bij de compositie past en benoem in de briefing de details die bij uitsnijden behouden moeten blijven, in plaats van een hogere resolutie als automatische verbetering van de opmaak te behandelen.
Het resultaatformaat is standaard PNG, met JPEG en WebP als alternatieven. JPEG en WebP staan compressie van 0 tot 100 toe. Kies voor een transparante achtergrond PNG of WebP; ondoorzichtige en automatische achtergronden worden ook ondersteund. Een transparant beeld kan in een latere opmaak worden geplaatst, terwijl een ondoorzichtige afbeelding haar eigen achtergrond bevat. Kies formaat, achtergrond en compressie op basis van de daadwerkelijke leveringsbehoefte en bewaar het voltooide bestand met de briefing en gekozen instellingen.
De producent documenteert directe beeldgeneratie en bewerkingen, plus een gesprekstool voor afbeeldingen die gekozen resultaten voor vervolgwijzigingen kan bewaren. In die workflow kan action automatisch zijn, generatie afdwingen of bewerking afdwingen wanneer een afbeelding in de context staat. Streaming kan maximaal drie gedeeltelijke afbeeldingen tonen vóór het uiteindelijke resultaat. Die previews tonen voortgang en zijn geen extra voltooide eindproducten. Ga bij iteratief werk verder vanaf de gekozen afbeelding en beschrijf een zichtbare wijziging, zoals het verplaatsen van één object of aanpassen van het kleurgebruik. De interface van de fabrikant ondersteunt ook batchverwerking.
Controleer de belettering, objectplaatsing, onderwerpdetails en compositie van de afbeelding op de beoogde grootte. GPT Image kan nog moeite hebben met exacte tekstplaatsing, gestructureerde opmaak en herhaalde visuele identiteit over meerdere generaties. Bewaar een geaccepteerde variant als volgende referentie en beperk de daaropvolgende bewerking tot het probleem dat ertoe doet. De rol van Flare voor dagelijkse generatie is nuttig voor een duidelijke reeks van briefing, visuele alternatieven, selectie en verfijning, waarbij het definitieve beeld wordt beoordeeld op het daadwerkelijke creatieve doel.
", "aboutText": "GPT Image 2.5 Flare is de editie van OpenAI voor beeldgeneratie en -bewerking die is gepositioneerd voor snel dagelijks werk van hoge kwaliteit. Het accepteert tekst en afbeeldingen en levert beeldresultaten op. Gebruik het voor visuele schetsen, illustraties, productconcepten en terugkerende creatieve taken waarbij een briefing snel een bruikbare afbeelding moet worden. Flare staat los van Sunburst, waarvan de positionering de nadruk legt op nauwkeurige bewerking. Kies Flare voor routinematige beeldcreatie en Sunburst wanneer precieze bewerking vooropstaat.\n\nBegin met het hoofdonderwerp, de handeling, omgeving, compositie en visuele uitwerking. Vraag voor een campagne-illustratie om een fietser die bij warm avondlicht een kleine brug oversteekt, met een krachtig silhouet en open lucht voor latere tekst. Een beknopte verkennende briefing kan esthetische beslissingen openlaten; een productiebriefing moet de details en plaatsing benoemen die belangrijk zijn. De directe generatie- en bewerkingsworkflows staan prompts tot 32,000 tekens en één tot tien resultaten toe, wat nuttig is om enkele varianten tegen hetzelfde doel af te zetten.\n\nBij bewerking kun je maximaal zestien referentieafbeeldingen aanleveren. Geef elke referentie een duidelijke rol, in plaats van te verwachten dat het model bepaalt of een afbeelding de identiteit van het onderwerp, het decor of de stijl weergeeft. Een masker kan een wijziging van een gebied sturen; bij meerdere afbeeldingen geldt het voor de eerste. De afbeelding en het masker moeten hetzelfde formaat en dezelfde afmetingen hebben en het masker moet een alfakanaal bevatten. De handleiding vereist dat bron en masker kleiner zijn dan 50 MB. Een masker geeft richting en belooft geen exact behoud van grenzen. Benoem daarom zowel de gewenste wijziging als wat herkenbaar moet blijven.\n\nFlare ondersteunt low, medium, high, xhigh, max en automatische kwaliteit, met auto als standaard. Lagere kwaliteit kan dienen voor een snelle visuele schets; hogere instellingen kunnen voor de details van een definitief beeld worden vergeleken. Kwaliteit staat los van formaat en uitvoercompressie. Standaardformaten zijn onder meer 1024 × 1024, 1536 × 1024 en 1024 × 1536; automatische of aangepaste afmetingen zijn ook beschikbaar. Kies de oriëntatie op basis van de uiteindelijke plaatsing en de bruikbare ruimte in de scène.\n\nAangepaste breedte en hoogte moeten veelvouden van zestien zijn, waarbij geen van beide zijden langer mag zijn dan 3840 pixels. De toegestane verhouding loopt van 1:3 tot 3:1 en het totale oppervlak moet minstens 655,360 en maximaal 8,294,400 pixels zijn. Alle vier voorwaarden gelden samen. De handleiding noemt resoluties boven 2560 × 1440 experimenteel. Gebruik een geldig beeldformaat dat bij de compositie past en benoem in de briefing de details die bij uitsnijden behouden moeten blijven, in plaats van een hogere resolutie als automatische verbetering van de opmaak te behandelen.\n\nHet resultaatformaat is standaard PNG, met JPEG en WebP als alternatieven. JPEG en WebP staan compressie van 0 tot 100 toe. Kies voor een transparante achtergrond PNG of WebP; ondoorzichtige en automatische achtergronden worden ook ondersteund. Een transparant beeld kan in een latere opmaak worden geplaatst, terwijl een ondoorzichtige afbeelding haar eigen achtergrond bevat. Kies formaat, achtergrond en compressie op basis van de daadwerkelijke leveringsbehoefte en bewaar het voltooide bestand met de briefing en gekozen instellingen.\n\nDe producent documenteert directe beeldgeneratie en bewerkingen, plus een gesprekstool voor afbeeldingen die gekozen resultaten voor vervolgwijzigingen kan bewaren. In die workflow kan action automatisch zijn, generatie afdwingen of bewerking afdwingen wanneer een afbeelding in de context staat. Streaming kan maximaal drie gedeeltelijke afbeeldingen tonen vóór het uiteindelijke resultaat. Die previews tonen voortgang en zijn geen extra voltooide eindproducten. Ga bij iteratief werk verder vanaf de gekozen afbeelding en beschrijf een zichtbare wijziging, zoals het verplaatsen van één object of aanpassen van het kleurgebruik. De interface van de fabrikant ondersteunt ook batchverwerking.\n\nControleer de belettering, objectplaatsing, onderwerpdetails en compositie van de afbeelding op de beoogde grootte. GPT Image kan nog moeite hebben met exacte tekstplaatsing, gestructureerde opmaak en herhaalde visuele identiteit over meerdere generaties. Bewaar een geaccepteerde variant als volgende referentie en beperk de daaropvolgende bewerking tot het probleem dat ertoe doet. De rol van Flare voor dagelijkse generatie is nuttig voor een duidelijke reeks van briefing, visuele alternatieven, selectie en verfijning, waarbij het definitieve beeld wordt beoordeeld op het daadwerkelijke creatieve doel.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "fa1db1913e960df79e3d0363ec8ca1ae68a712c2359c03f4043bed4cc5aae137", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "nl", "methods": [ { "html": "gpt-image-2.5-flareGPT Image 2.5 Flare genereert en bewerkt afbeeldingen op basis van tekst en referenties, met aandacht voor snelle dagelijkse beeldcreatie. Het ondersteunt aangepaste formaten, transparante achtergronden, maskers en kwaliteitsniveaus tot max voor schetsen, illustraties en campagnemateriaal.
Deze beschrijving gaat over de mogelijkheden van het model. De via Ailoot beschikbare invoer, uitvoer en opties staan hieronder voor de geselecteerde methode.
GPT Image 2.5 Flare is de editie van OpenAI voor beeldgeneratie en -bewerking die is gepositioneerd voor snel dagelijks werk van hoge kwaliteit. Het accepteert tekst en afbeeldingen en levert beeldresultaten op. Gebruik het voor visuele schetsen, illustraties, productconcepten en terugkerende creatieve taken waarbij een briefing snel een bruikbare afbeelding moet worden. Flare staat los van Sunburst, waarvan de positionering de nadruk legt op nauwkeurige bewerking. Kies Flare voor routinematige beeldcreatie en Sunburst wanneer precieze bewerking vooropstaat.
Begin met het hoofdonderwerp, de handeling, omgeving, compositie en visuele uitwerking. Vraag voor een campagne-illustratie om een fietser die bij warm avondlicht een kleine brug oversteekt, met een krachtig silhouet en open lucht voor latere tekst. Een beknopte verkennende briefing kan esthetische beslissingen openlaten; een productiebriefing moet de details en plaatsing benoemen die belangrijk zijn. De directe generatie- en bewerkingsworkflows staan prompts tot 32,000 tekens en één tot tien resultaten toe, wat nuttig is om enkele varianten tegen hetzelfde doel af te zetten.
Bij bewerking kun je maximaal zestien referentieafbeeldingen aanleveren. Geef elke referentie een duidelijke rol, in plaats van te verwachten dat het model bepaalt of een afbeelding de identiteit van het onderwerp, het decor of de stijl weergeeft. Een masker kan een wijziging van een gebied sturen; bij meerdere afbeeldingen geldt het voor de eerste. De afbeelding en het masker moeten hetzelfde formaat en dezelfde afmetingen hebben en het masker moet een alfakanaal bevatten. De handleiding vereist dat bron en masker kleiner zijn dan 50 MB. Een masker geeft richting en belooft geen exact behoud van grenzen. Benoem daarom zowel de gewenste wijziging als wat herkenbaar moet blijven.
Flare ondersteunt low, medium, high, xhigh, max en automatische kwaliteit, met auto als standaard. Lagere kwaliteit kan dienen voor een snelle visuele schets; hogere instellingen kunnen voor de details van een definitief beeld worden vergeleken. Kwaliteit staat los van formaat en uitvoercompressie. Standaardformaten zijn onder meer 1024 × 1024, 1536 × 1024 en 1024 × 1536; automatische of aangepaste afmetingen zijn ook beschikbaar. Kies de oriëntatie op basis van de uiteindelijke plaatsing en de bruikbare ruimte in de scène.
Aangepaste breedte en hoogte moeten veelvouden van zestien zijn, waarbij geen van beide zijden langer mag zijn dan 3840 pixels. De toegestane verhouding loopt van 1:3 tot 3:1 en het totale oppervlak moet minstens 655,360 en maximaal 8,294,400 pixels zijn. Alle vier voorwaarden gelden samen. De handleiding noemt resoluties boven 2560 × 1440 experimenteel. Gebruik een geldig beeldformaat dat bij de compositie past en benoem in de briefing de details die bij uitsnijden behouden moeten blijven, in plaats van een hogere resolutie als automatische verbetering van de opmaak te behandelen.
Het resultaatformaat is standaard PNG, met JPEG en WebP als alternatieven. JPEG en WebP staan compressie van 0 tot 100 toe. Kies voor een transparante achtergrond PNG of WebP; ondoorzichtige en automatische achtergronden worden ook ondersteund. Een transparant beeld kan in een latere opmaak worden geplaatst, terwijl een ondoorzichtige afbeelding haar eigen achtergrond bevat. Kies formaat, achtergrond en compressie op basis van de daadwerkelijke leveringsbehoefte en bewaar het voltooide bestand met de briefing en gekozen instellingen.
De producent documenteert directe beeldgeneratie en bewerkingen, plus een gesprekstool voor afbeeldingen die gekozen resultaten voor vervolgwijzigingen kan bewaren. In die workflow kan action automatisch zijn, generatie afdwingen of bewerking afdwingen wanneer een afbeelding in de context staat. Streaming kan maximaal drie gedeeltelijke afbeeldingen tonen vóór het uiteindelijke resultaat. Die previews tonen voortgang en zijn geen extra voltooide eindproducten. Ga bij iteratief werk verder vanaf de gekozen afbeelding en beschrijf een zichtbare wijziging, zoals het verplaatsen van één object of aanpassen van het kleurgebruik. De interface van de fabrikant ondersteunt ook batchverwerking.
Controleer de belettering, objectplaatsing, onderwerpdetails en compositie van de afbeelding op de beoogde grootte. GPT Image kan nog moeite hebben met exacte tekstplaatsing, gestructureerde opmaak en herhaalde visuele identiteit over meerdere generaties. Bewaar een geaccepteerde variant als volgende referentie en beperk de daaropvolgende bewerking tot het probleem dat ertoe doet. De rol van Flare voor dagelijkse generatie is nuttig voor een duidelijke reeks van briefing, visuele alternatieven, selectie en verfijning, waarbij het definitieve beeld wordt beoordeeld op het daadwerkelijke creatieve doel.
POST /v1/images/generationstextimage| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten gpt-image-2.5-flare | 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— |
Veldquality | Typestring | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Veldbackground | Typestring | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Veldoutput_format | Typestring | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Veldoutput_compression | Typeinteger | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Veldmoderation | Typestring | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Veldinput_fidelity | Typestring | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Veldstyle | Typestring | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Veldpartial_images | Typeinteger | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Tekst naar afbeelding · 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} · de daadwerkelijk geretourneerde task_id of het 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": "gpt-image-2.5-flare", "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': 'gpt-image-2.5-flare', '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": "gpt-image-2.5-flare", "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 data-item op. Decodeer elke b64_json of haal elk bestand op via elke geretourneerde ondertekende URL. Kies een bestandsextensie op basis van de daadwerkelijke MIME/bytes.
Als het resultaat van een afbeeldingsgeneratie of -bewerking moet worden gecontroleerd, bewaar dan de oorspronkelijke operation_id/X-Client-Request-ID en de geretourneerde resultaatinformatie. Haal bestaande eigen resultaten terug via de mediabibliotheek met de daadwerkelijke task_id- of asset_id-waarden. Dien de generatie-/bewerkingsaanvraag niet opnieuw in en bouw geen polling-URL 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 | VoorwaardeHet geretourneerde antwoord geeft aan dat de bewerking of het resultaat moet worden gecontroleerd | Volgende stapBewaar de oorspronkelijk geretourneerde bewerkings-/taak-ID, de aanvraagheaders en het antwoord; blijf de ondersteunde leesacties voor die oorspronkelijke bewerking uitvoeren. Dien de aanmaakaanvraag niet opnieuw in. |
Ailoot gpt-image-2.5-flare
Ailoot Ultra gpt-image-2.5-flare, openai/gpt-image-2.5-flare
/v1/images
openai/gpt-image-2.5-flare, gpt-image-2.5-flare, gpt-image-2.5-flare
gpt-image-2.5-flareGPT Image 2.5 Flare genereert en bewerkt afbeeldingen op basis van tekst en referenties, met aandacht voor snelle dagelijkse beeldcreatie. Het ondersteunt aangepaste formaten, transparante achtergronden, maskers en kwaliteitsniveaus tot max voor schetsen, illustraties en campagnemateriaal.
Deze beschrijving gaat over de mogelijkheden van het model. De via Ailoot beschikbare invoer, uitvoer en opties staan hieronder voor de geselecteerde methode.
GPT Image 2.5 Flare is de editie van OpenAI voor beeldgeneratie en -bewerking die is gepositioneerd voor snel dagelijks werk van hoge kwaliteit. Het accepteert tekst en afbeeldingen en levert beeldresultaten op. Gebruik het voor visuele schetsen, illustraties, productconcepten en terugkerende creatieve taken waarbij een briefing snel een bruikbare afbeelding moet worden. Flare staat los van Sunburst, waarvan de positionering de nadruk legt op nauwkeurige bewerking. Kies Flare voor routinematige beeldcreatie en Sunburst wanneer precieze bewerking vooropstaat.
Begin met het hoofdonderwerp, de handeling, omgeving, compositie en visuele uitwerking. Vraag voor een campagne-illustratie om een fietser die bij warm avondlicht een kleine brug oversteekt, met een krachtig silhouet en open lucht voor latere tekst. Een beknopte verkennende briefing kan esthetische beslissingen openlaten; een productiebriefing moet de details en plaatsing benoemen die belangrijk zijn. De directe generatie- en bewerkingsworkflows staan prompts tot 32,000 tekens en één tot tien resultaten toe, wat nuttig is om enkele varianten tegen hetzelfde doel af te zetten.
Bij bewerking kun je maximaal zestien referentieafbeeldingen aanleveren. Geef elke referentie een duidelijke rol, in plaats van te verwachten dat het model bepaalt of een afbeelding de identiteit van het onderwerp, het decor of de stijl weergeeft. Een masker kan een wijziging van een gebied sturen; bij meerdere afbeeldingen geldt het voor de eerste. De afbeelding en het masker moeten hetzelfde formaat en dezelfde afmetingen hebben en het masker moet een alfakanaal bevatten. De handleiding vereist dat bron en masker kleiner zijn dan 50 MB. Een masker geeft richting en belooft geen exact behoud van grenzen. Benoem daarom zowel de gewenste wijziging als wat herkenbaar moet blijven.
Flare ondersteunt low, medium, high, xhigh, max en automatische kwaliteit, met auto als standaard. Lagere kwaliteit kan dienen voor een snelle visuele schets; hogere instellingen kunnen voor de details van een definitief beeld worden vergeleken. Kwaliteit staat los van formaat en uitvoercompressie. Standaardformaten zijn onder meer 1024 × 1024, 1536 × 1024 en 1024 × 1536; automatische of aangepaste afmetingen zijn ook beschikbaar. Kies de oriëntatie op basis van de uiteindelijke plaatsing en de bruikbare ruimte in de scène.
Aangepaste breedte en hoogte moeten veelvouden van zestien zijn, waarbij geen van beide zijden langer mag zijn dan 3840 pixels. De toegestane verhouding loopt van 1:3 tot 3:1 en het totale oppervlak moet minstens 655,360 en maximaal 8,294,400 pixels zijn. Alle vier voorwaarden gelden samen. De handleiding noemt resoluties boven 2560 × 1440 experimenteel. Gebruik een geldig beeldformaat dat bij de compositie past en benoem in de briefing de details die bij uitsnijden behouden moeten blijven, in plaats van een hogere resolutie als automatische verbetering van de opmaak te behandelen.
Het resultaatformaat is standaard PNG, met JPEG en WebP als alternatieven. JPEG en WebP staan compressie van 0 tot 100 toe. Kies voor een transparante achtergrond PNG of WebP; ondoorzichtige en automatische achtergronden worden ook ondersteund. Een transparant beeld kan in een latere opmaak worden geplaatst, terwijl een ondoorzichtige afbeelding haar eigen achtergrond bevat. Kies formaat, achtergrond en compressie op basis van de daadwerkelijke leveringsbehoefte en bewaar het voltooide bestand met de briefing en gekozen instellingen.
De producent documenteert directe beeldgeneratie en bewerkingen, plus een gesprekstool voor afbeeldingen die gekozen resultaten voor vervolgwijzigingen kan bewaren. In die workflow kan action automatisch zijn, generatie afdwingen of bewerking afdwingen wanneer een afbeelding in de context staat. Streaming kan maximaal drie gedeeltelijke afbeeldingen tonen vóór het uiteindelijke resultaat. Die previews tonen voortgang en zijn geen extra voltooide eindproducten. Ga bij iteratief werk verder vanaf de gekozen afbeelding en beschrijf een zichtbare wijziging, zoals het verplaatsen van één object of aanpassen van het kleurgebruik. De interface van de fabrikant ondersteunt ook batchverwerking.
Controleer de belettering, objectplaatsing, onderwerpdetails en compositie van de afbeelding op de beoogde grootte. GPT Image kan nog moeite hebben met exacte tekstplaatsing, gestructureerde opmaak en herhaalde visuele identiteit over meerdere generaties. Bewaar een geaccepteerde variant als volgende referentie en beperk de daaropvolgende bewerking tot het probleem dat ertoe doet. De rol van Flare voor dagelijkse generatie is nuttig voor een duidelijke reeks van briefing, visuele alternatieven, selectie en verfijning, waarbij het definitieve beeld wordt beoordeeld op het daadwerkelijke creatieve doel.
POST /v1/images/generationstextimage| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten gpt-image-2.5-flare | Standaard— |
Veldprompt | Typestring | VereisteVereist | Waarden en limieten Maximumlengte: 32.000 | Standaard— |
Veldsize | Typestring | VereisteOptioneel | Waarden en limieten Voorwaarden: Gebruik auto of WIDTHxHEIGHT waarbij beide afmetingen deelbaar zijn door 16. De langste zijde is maximaal 3,840 pixels en de totale grootte maximaal 8,300,000 pixels. | Standaardauto |
Veldbackground | Typestring | VereisteOptioneel | Waarden en limieten transparent, opaque, auto | Standaardauto |
Veldmoderation | Typestring | VereisteOptioneel | Waarden en limieten low, auto Voorwaarden: Gebruik auto voor standaardinhoudsmoderatie. | Standaard— |
Veldn | Typeinteger | VereisteOptioneel | Waarden en limieten Minimum: 1 Maximum: 10 | Standaard1 |
Veldquality | Typestring | VereisteOptioneel | Waarden en limieten auto, high, medium, low | Standaardauto |
Veldoutput_compression | Typeinteger | VereisteOptioneel | Waarden en limieten Minimum: 0 Maximum: 100 Voorwaarden: Geldt voor JPEG- en WebP-uitvoer; verstuur de gedocumenteerde gehele waarde. | Standaard100 |
Veldoutput_format | Typestring | VereisteOptioneel | Waarden en limieten webp, png, jpeg | Standaardpng |
Veldstream | Typeboolean | VereisteOptioneel | Waarden en limieten false Voorwaarden: Deze route retourneert één voltooid JSON-antwoord. | Standaardfalse |
| Parameter | Contract |
|---|---|
Parametercontent_type | Contractapplication/json |
Parameterrequired | Contractprompt, model |
Parametermaterial_types | Contracttext |
Parameteroptional | Contractsize, background, moderation, n, quality, output_compression, output_format, stream |
Parameterconditions | ContractEen transparante achtergrond vereist PNG of WebP., Uitvoercompressie geldt voor JPEG of WebP., De geselecteerde methode genereert vanuit tekst. Bewerkings- en streaminginstellingen die voor de fabrikant worden beschreven, zijn afzonderlijke mogelijkheden. |
Levenscyclus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · de daadwerkelijk geretourneerde task_id of het record in de mediabibliotheek
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
De weergegeven tarieven geven een schatting van de kosten vóór de generatie. Het definitieve bedrag wordt berekend op basis van de kosten die voor de oorspronkelijke generatie zijn geregistreerd. De gemeten duur van de uitvoer en de geschatte hoeveelheden zijn niet de definitieve factureerbare hoeveelheid.
Tariefverwijzingen voegen geen verzoekopties toe. Ondersteunde parameters staan bij de geselecteerde methode.
Koppel elke kostenpost aan de getoonde voorwaarden. Gebruik één tarief voor elke groep alternatieve configuraties.
| Configuratie | Tariefstaffel | Verwachte hoeveelheid | Kosten |
|---|---|---|---|
| ConfiguratieBasistarieven voor tokens | TariefstaffelBasistarief | Verwachte hoeveelheid— | Kosten Invoer · Invoertokens · Schatting uitsluitend ter vergelijking — / 1K tokens Uitvoer · Uitvoertokens · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache lezen · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache schrijven · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache schrijven, 1 uur · Schatting uitsluitend ter vergelijking — / 1K tokens |
| ConfiguratieGeschatte generatiekosten | Tariefstaffel— | Verwachte hoeveelheidschatting voor één generatie | Kosten Uitvoer · Geschatte generatiekosten · Schatting uitsluitend ter vergelijking $0.24576 schatting vóór generatie Deze schatting is geen extra bedrag of vast tarief voor de voltooide generatie. |
Ailoot 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\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np={'prompt': 'A cute baby sea otter', 'model': 'gpt-image-2.5-flare', 'size': '1024x1024', 'n': 1, 'background': 'auto', 'moderation': 'auto', 'output_format': 'png'}\n\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\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}set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json\n# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.\nSla elke voltooide afbeelding op; haal elke teruggegeven URL op of decodeer de bijbehorende Base64-inhoud.
Bewaar het volledige antwoord en de headers, alle daadwerkelijke uitvoer, de oorspronkelijk geretourneerde identificatoren en alle gebruiksvelden. Herstel de oorspronkelijke bewerking zonder de aanmaakaanvraag opnieuw in te dienen.
Bewaar de geretourneerde X-Client-Request-ID voor reconciliatie. Lees alleen daadwerkelijk geretourneerde task_id/asset_id-waarden of de eigen mediabibliotheek uit; bouw nooit een taak-URL op basis van de bewerkings-ID en dien de aanmaakaanvraag nooit opnieuw in.
| Veld | Type |
|---|---|
Veldcreated | Type |
Velddata[].url | Type |
Velddata[].b64_json | Type |
Veldusage | Type |
Ailoot gpt-image-2.5-flare
Ailoot Ultra gpt-image-2.5-flare, openai/gpt-image-2.5-flare
/v1/images
openai/gpt-image-2.5-flare, gpt-image-2.5-flare, gpt-image-2.5-flare
openai/gpt-image-2.5-flareGPT Image 2.5 Flare genereert en bewerkt afbeeldingen op basis van tekst en referenties, met aandacht voor snelle dagelijkse beeldcreatie. Het ondersteunt aangepaste formaten, transparante achtergronden, maskers en kwaliteitsniveaus tot max voor schetsen, illustraties en campagnemateriaal.
Deze beschrijving gaat over de mogelijkheden van het model. De via Ailoot beschikbare invoer, uitvoer en opties staan hieronder voor de geselecteerde methode.
GPT Image 2.5 Flare is de editie van OpenAI voor beeldgeneratie en -bewerking die is gepositioneerd voor snel dagelijks werk van hoge kwaliteit. Het accepteert tekst en afbeeldingen en levert beeldresultaten op. Gebruik het voor visuele schetsen, illustraties, productconcepten en terugkerende creatieve taken waarbij een briefing snel een bruikbare afbeelding moet worden. Flare staat los van Sunburst, waarvan de positionering de nadruk legt op nauwkeurige bewerking. Kies Flare voor routinematige beeldcreatie en Sunburst wanneer precieze bewerking vooropstaat.
Begin met het hoofdonderwerp, de handeling, omgeving, compositie en visuele uitwerking. Vraag voor een campagne-illustratie om een fietser die bij warm avondlicht een kleine brug oversteekt, met een krachtig silhouet en open lucht voor latere tekst. Een beknopte verkennende briefing kan esthetische beslissingen openlaten; een productiebriefing moet de details en plaatsing benoemen die belangrijk zijn. De directe generatie- en bewerkingsworkflows staan prompts tot 32,000 tekens en één tot tien resultaten toe, wat nuttig is om enkele varianten tegen hetzelfde doel af te zetten.
Bij bewerking kun je maximaal zestien referentieafbeeldingen aanleveren. Geef elke referentie een duidelijke rol, in plaats van te verwachten dat het model bepaalt of een afbeelding de identiteit van het onderwerp, het decor of de stijl weergeeft. Een masker kan een wijziging van een gebied sturen; bij meerdere afbeeldingen geldt het voor de eerste. De afbeelding en het masker moeten hetzelfde formaat en dezelfde afmetingen hebben en het masker moet een alfakanaal bevatten. De handleiding vereist dat bron en masker kleiner zijn dan 50 MB. Een masker geeft richting en belooft geen exact behoud van grenzen. Benoem daarom zowel de gewenste wijziging als wat herkenbaar moet blijven.
Flare ondersteunt low, medium, high, xhigh, max en automatische kwaliteit, met auto als standaard. Lagere kwaliteit kan dienen voor een snelle visuele schets; hogere instellingen kunnen voor de details van een definitief beeld worden vergeleken. Kwaliteit staat los van formaat en uitvoercompressie. Standaardformaten zijn onder meer 1024 × 1024, 1536 × 1024 en 1024 × 1536; automatische of aangepaste afmetingen zijn ook beschikbaar. Kies de oriëntatie op basis van de uiteindelijke plaatsing en de bruikbare ruimte in de scène.
Aangepaste breedte en hoogte moeten veelvouden van zestien zijn, waarbij geen van beide zijden langer mag zijn dan 3840 pixels. De toegestane verhouding loopt van 1:3 tot 3:1 en het totale oppervlak moet minstens 655,360 en maximaal 8,294,400 pixels zijn. Alle vier voorwaarden gelden samen. De handleiding noemt resoluties boven 2560 × 1440 experimenteel. Gebruik een geldig beeldformaat dat bij de compositie past en benoem in de briefing de details die bij uitsnijden behouden moeten blijven, in plaats van een hogere resolutie als automatische verbetering van de opmaak te behandelen.
Het resultaatformaat is standaard PNG, met JPEG en WebP als alternatieven. JPEG en WebP staan compressie van 0 tot 100 toe. Kies voor een transparante achtergrond PNG of WebP; ondoorzichtige en automatische achtergronden worden ook ondersteund. Een transparant beeld kan in een latere opmaak worden geplaatst, terwijl een ondoorzichtige afbeelding haar eigen achtergrond bevat. Kies formaat, achtergrond en compressie op basis van de daadwerkelijke leveringsbehoefte en bewaar het voltooide bestand met de briefing en gekozen instellingen.
De producent documenteert directe beeldgeneratie en bewerkingen, plus een gesprekstool voor afbeeldingen die gekozen resultaten voor vervolgwijzigingen kan bewaren. In die workflow kan action automatisch zijn, generatie afdwingen of bewerking afdwingen wanneer een afbeelding in de context staat. Streaming kan maximaal drie gedeeltelijke afbeeldingen tonen vóór het uiteindelijke resultaat. Die previews tonen voortgang en zijn geen extra voltooide eindproducten. Ga bij iteratief werk verder vanaf de gekozen afbeelding en beschrijf een zichtbare wijziging, zoals het verplaatsen van één object of aanpassen van het kleurgebruik. De interface van de fabrikant ondersteunt ook batchverwerking.
Controleer de belettering, objectplaatsing, onderwerpdetails en compositie van de afbeelding op de beoogde grootte. GPT Image kan nog moeite hebben met exacte tekstplaatsing, gestructureerde opmaak en herhaalde visuele identiteit over meerdere generaties. Bewaar een geaccepteerde variant als volgende referentie en beperk de daaropvolgende bewerking tot het probleem dat ertoe doet. De rol van Flare voor dagelijkse generatie is nuttig voor een duidelijke reeks van briefing, visuele alternatieven, selectie en verfijning, waarbij het definitieve beeld wordt beoordeeld op het daadwerkelijke creatieve doel.
POST /v1/images/generationstext, imageimage| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten openai/gpt-image-2.5-flare | Standaard— |
Veldprompt | Typestring | VereisteVereist | Waarden en limieten Minimumlengte: 1 | Standaard— |
Veldaspect_ratio | Typestring | VereisteOptioneel | Waarden en limieten 1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9, auto | Standaard— |
Veldquality | Typestring | VereisteOptioneel | Waarden en limieten auto, low, medium, high, xhigh, max | Standaard— |
Veldbackground | Typestring | VereisteOptioneel | Waarden en limieten auto, transparent, opaque | Standaard— |
Veldn | Typeinteger | VereisteOptioneel | Waarden en limieten Minimum: 1 Maximum: 10 | Standaard— |
Veldinput_references | Typearray | VereisteOptioneel | Waarden en limieten Minimumaantal items: 0 Maximumaantal items: 16 | Standaard— |
Veldoutput_compression | Typeinteger | VereisteOptioneel | Waarden en limieten Minimum: 0 Maximum: 100 | Standaard— |
Veldprovider | Typeobject | VereisteOptioneel | Waarden en limieten | Standaard— |
| Parameter | Contract |
|---|---|
Parametercontent_type | Contractapplication/json |
Parameterrequired | Contractmodel, prompt |
Parametermaterial_types | Contracttext, image |
Levenscyclus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · de daadwerkelijk geretourneerde task_id of het record in de mediabibliotheek
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
De weergegeven tarieven geven een schatting van de kosten vóór de generatie. Het definitieve bedrag wordt berekend op basis van de kosten die voor de oorspronkelijke generatie zijn geregistreerd. De gemeten duur van de uitvoer en de geschatte hoeveelheden zijn niet de definitieve factureerbare hoeveelheid.
Tariefverwijzingen voegen geen verzoekopties toe. Ondersteunde parameters staan bij de geselecteerde methode.
Koppel elke kostenpost aan de getoonde voorwaarden. Gebruik één tarief voor elke groep alternatieve configuraties.
| Configuratie | Tariefstaffel | Verwachte hoeveelheid | Kosten |
|---|---|---|---|
| ConfiguratieBasistarieven voor tokens | TariefstaffelBasistarief | Verwachte hoeveelheid— | Kosten Invoer · Invoertokens · Schatting uitsluitend ter vergelijking — / 1K tokens Uitvoer · Uitvoertokens · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache lezen · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache schrijven · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache schrijven, 1 uur · Schatting uitsluitend ter vergelijking — / 1K tokens |
| ConfiguratieGeschatte generatiekosten | Tariefstaffel— | Verwachte hoeveelheidschatting voor één generatie | Kosten Uitvoer · Geschatte generatiekosten · Schatting uitsluitend ter vergelijking $0.24576 schatting vóór generatie Deze schatting is geen extra bedrag of vast tarief voor de voltooide generatie. |
Ailoot 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\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np={'model': 'openai/gpt-image-2.5-flare', 'prompt': 'a red panda astronaut floating in space, studio lighting'}\n\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\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}set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json\n# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.\nSla elke voltooide afbeelding op; haal elke teruggegeven URL op of decodeer de bijbehorende Base64-inhoud.
Bewaar het volledige antwoord en de headers, alle daadwerkelijke uitvoer, de oorspronkelijk geretourneerde identificatoren en alle gebruiksvelden. Herstel de oorspronkelijke bewerking zonder de aanmaakaanvraag opnieuw in te dienen.
Bewaar de geretourneerde X-Client-Request-ID voor reconciliatie. Lees alleen daadwerkelijk geretourneerde task_id/asset_id-waarden of de eigen mediabibliotheek uit; bouw nooit een taak-URL op basis van de bewerkings-ID en dien de aanmaakaanvraag nooit opnieuw in.
| Veld | Type |
|---|---|
Veldcreated | Type |
Velddata[].url | Type |
Velddata[].b64_json | Type |
Veldusage | Type |
Ailoot gpt-image-2.5-flare
Ailoot Ultra gpt-image-2.5-flare, openai/gpt-image-2.5-flare
/v1/images
openai/gpt-image-2.5-flare, gpt-image-2.5-flare, gpt-image-2.5-flare