GPT Image 1.5 is een model van OpenAI om afbeeldingen uit een tekstbeschrijving te maken. De fabrikant benadrukt het volgen van instructies en het verwerken van een gedetailleerde opdracht: daarin kunnen scène-inhoud, compositie, het uiterlijk van objecten en de gewenste stijl worden bepaald. Het resultaat van de beeldmethode is een voltooide afbeelding.
In Ailoot betreft deze kaart generatie met tekstinvoer. OpenAI beschrijft ook werken met bronafbeeldingen, bewerking en wijziging van specifieke gebieden. Die mogelijkheden vereisen afzonderlijke ondersteuning voor visuele invoer en horen niet bij de hier aangegeven tekstuele generatiemethode.
Bij de afzonderlijke bewerkingshandeling van OpenAI dient een masker als richtlijn: een exacte overeenkomst van het resultaat met de maskercontouren wordt niet gegarandeerd. Zo'n handeling vereist ondersteuning voor het aanleveren van de bronafbeelding; de huidige Ailoot-kaart blijft generatie met tekstinvoer betreffen.
Een vierkant formaat 1024x1024, horizontaal 1536x1024 en verticaal 1024x1536 zijn voorzien, evenals automatische selectie. Willekeurige afmetingen van andere modellen mogen niet op deze versie worden toegepast.
De kwaliteitsniveaus zijn low, medium, high en auto. De kwaliteitskeuze beïnvloedt de verwerkingsomvang en de detaillering van het resultaat. Kwaliteit en afmetingen zijn verschillende instellingen: de beeldoriëntatie bepaalt de compositieruimte en het kwaliteitsniveau de vormingsmodus. xhigh en max zijn niet aangekondigd voor GPT Image 1.5.
Standaard wordt het resultaat als PNG gemaakt; JPEG en WebP zijn ook voorzien. Voor JPEG en WebP kan de compressiegraad worden ingesteld. Dit is een instelling van het resultaatbestand en verschilt van de generatiekwaliteit.
De fabrikant voorziet in een transparante en ondoorzichtige achtergrond en automatische selectie. Transparantie vereist PNG of WebP: JPEG bewaart geen alfakanaal. Een transparante achtergrond is handig wanneer de afbeelding als los object in een latere compositie wordt gebruikt. Ondersteuning voor specifieke parameters moet aan de gekozen methode worden gekoppeld.
Het model kan tekst in de afbeelding opnemen en een scène uit meerdere elementen opbouwen, maar de exacte positie van tekst en objecten wordt niet gegarandeerd. Ook het consequent behouden van een personage-uiterlijk of vormgeving tussen afzonderlijke generaties vereist controle.
Een complexe afbeelding kan langer duren dan een eenvoudige; volgens OpenAI kunnen afzonderlijke complexe opdrachten tot twee minuten duren. Voor het resultaat zijn zowel een volledige bronbeschrijving als controle van de voltooide afbeelding belangrijk: tekstleesbaarheid, detailposities en overeenkomst met de gevraagde scène worden op het bestand zelf beoordeeld.
", "aboutText": "### Een afbeelding op basis van een gedetailleerde opdracht\n\nGPT Image 1.5 is een model van OpenAI om afbeeldingen uit een tekstbeschrijving te maken. De fabrikant benadrukt het volgen van instructies en het verwerken van een gedetailleerde opdracht: daarin kunnen scène-inhoud, compositie, het uiterlijk van objecten en de gewenste stijl worden bepaald. Het resultaat van de beeldmethode is een voltooide afbeelding.\n\nIn Ailoot betreft deze kaart generatie met tekstinvoer. OpenAI beschrijft ook werken met bronafbeeldingen, bewerking en wijziging van specifieke gebieden. Die mogelijkheden vereisen afzonderlijke ondersteuning voor visuele invoer en horen niet bij de hier aangegeven tekstuele generatiemethode.\n\nBij de afzonderlijke bewerkingshandeling van OpenAI dient een masker als richtlijn: een exacte overeenkomst van het resultaat met de maskercontouren wordt niet gegarandeerd. Zo'n handeling vereist ondersteuning voor het aanleveren van de bronafbeelding; de huidige Ailoot-kaart blijft generatie met tekstinvoer betreffen.\n\n### Drie beeldvormen en kwaliteitsinstellingen\n\nEen vierkant formaat `1024x1024`, horizontaal `1536x1024` en verticaal `1024x1536` zijn voorzien, evenals automatische selectie. Willekeurige afmetingen van andere modellen mogen niet op deze versie worden toegepast.\n\nDe kwaliteitsniveaus zijn `low`, `medium`, `high` en `auto`. De kwaliteitskeuze beïnvloedt de verwerkingsomvang en de detaillering van het resultaat. Kwaliteit en afmetingen zijn verschillende instellingen: de beeldoriëntatie bepaalt de compositieruimte en het kwaliteitsniveau de vormingsmodus. `xhigh` en `max` zijn niet aangekondigd voor GPT Image 1.5.\n\n### Bestandsformaat en achtergrond\n\nStandaard wordt het resultaat als PNG gemaakt; JPEG en WebP zijn ook voorzien. Voor JPEG en WebP kan de compressiegraad worden ingesteld. Dit is een instelling van het resultaatbestand en verschilt van de generatiekwaliteit.\n\nDe fabrikant voorziet in een transparante en ondoorzichtige achtergrond en automatische selectie. Transparantie vereist PNG of WebP: JPEG bewaart geen alfakanaal. Een transparante achtergrond is handig wanneer de afbeelding als los object in een latere compositie wordt gebruikt. Ondersteuning voor specifieke parameters moet aan de gekozen methode worden gekoppeld.\n\n### Tekst en compositie moeten worden gecontroleerd\n\nHet model kan tekst in de afbeelding opnemen en een scène uit meerdere elementen opbouwen, maar de exacte positie van tekst en objecten wordt niet gegarandeerd. Ook het consequent behouden van een personage-uiterlijk of vormgeving tussen afzonderlijke generaties vereist controle.\n\nEen complexe afbeelding kan langer duren dan een eenvoudige; volgens OpenAI kunnen afzonderlijke complexe opdrachten tot twee minuten duren. Voor het resultaat zijn zowel een volledige bronbeschrijving als controle van de voltooide afbeelding belangrijk: tekstleesbaarheid, detailposities en overeenkomst met de gevraagde scène worden op het bestand zelf beoordeeld.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "4425d9518f65cb6f8f328d9a4c2087ab9f7092b99ddfd0ec0e559f49f7aa00fe", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "nl", "methods": [ { "html": "gpt-image-1.5GPT Image 1.5 maakt afbeeldingen op basis van een tekstuele opdracht, met de nadruk op gedetailleerde instructies volgen. Drie beeldvormen, meerdere kwaliteitsniveaus en resultaatformaten zijn voorzien.
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 1.5 is een model van OpenAI om afbeeldingen uit een tekstbeschrijving te maken. De fabrikant benadrukt het volgen van instructies en het verwerken van een gedetailleerde opdracht: daarin kunnen scène-inhoud, compositie, het uiterlijk van objecten en de gewenste stijl worden bepaald. Het resultaat van de beeldmethode is een voltooide afbeelding.
In Ailoot betreft deze kaart generatie met tekstinvoer. OpenAI beschrijft ook werken met bronafbeeldingen, bewerking en wijziging van specifieke gebieden. Die mogelijkheden vereisen afzonderlijke ondersteuning voor visuele invoer en horen niet bij de hier aangegeven tekstuele generatiemethode.
Bij de afzonderlijke bewerkingshandeling van OpenAI dient een masker als richtlijn: een exacte overeenkomst van het resultaat met de maskercontouren wordt niet gegarandeerd. Zo'n handeling vereist ondersteuning voor het aanleveren van de bronafbeelding; de huidige Ailoot-kaart blijft generatie met tekstinvoer betreffen.
Een vierkant formaat 1024x1024, horizontaal 1536x1024 en verticaal 1024x1536 zijn voorzien, evenals automatische selectie. Willekeurige afmetingen van andere modellen mogen niet op deze versie worden toegepast.
De kwaliteitsniveaus zijn low, medium, high en auto. De kwaliteitskeuze beïnvloedt de verwerkingsomvang en de detaillering van het resultaat. Kwaliteit en afmetingen zijn verschillende instellingen: de beeldoriëntatie bepaalt de compositieruimte en het kwaliteitsniveau de vormingsmodus. xhigh en max zijn niet aangekondigd voor GPT Image 1.5.
Standaard wordt het resultaat als PNG gemaakt; JPEG en WebP zijn ook voorzien. Voor JPEG en WebP kan de compressiegraad worden ingesteld. Dit is een instelling van het resultaatbestand en verschilt van de generatiekwaliteit.
De fabrikant voorziet in een transparante en ondoorzichtige achtergrond en automatische selectie. Transparantie vereist PNG of WebP: JPEG bewaart geen alfakanaal. Een transparante achtergrond is handig wanneer de afbeelding als los object in een latere compositie wordt gebruikt. Ondersteuning voor specifieke parameters moet aan de gekozen methode worden gekoppeld.
Het model kan tekst in de afbeelding opnemen en een scène uit meerdere elementen opbouwen, maar de exacte positie van tekst en objecten wordt niet gegarandeerd. Ook het consequent behouden van een personage-uiterlijk of vormgeving tussen afzonderlijke generaties vereist controle.
Een complexe afbeelding kan langer duren dan een eenvoudige; volgens OpenAI kunnen afzonderlijke complexe opdrachten tot twee minuten duren. Voor het resultaat zijn zowel een volledige bronbeschrijving als controle van de voltooide afbeelding belangrijk: tekstleesbaarheid, detailposities en overeenkomst met de gevraagde scène worden op het bestand zelf beoordeeld.
POST /v1/images/generationstextimage| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten gpt-image-1.5 | 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-1.5", "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-1.5', '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-1.5", "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-1.5
Ailoot Ultra gpt-image-1.5
Gebruik de hierboven getoonde methodepaden.
gpt-image-1.5GPT Image 1.5 maakt afbeeldingen op basis van een tekstuele opdracht, met de nadruk op gedetailleerde instructies volgen. Drie beeldvormen, meerdere kwaliteitsniveaus en resultaatformaten zijn voorzien.
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 1.5 is een model van OpenAI om afbeeldingen uit een tekstbeschrijving te maken. De fabrikant benadrukt het volgen van instructies en het verwerken van een gedetailleerde opdracht: daarin kunnen scène-inhoud, compositie, het uiterlijk van objecten en de gewenste stijl worden bepaald. Het resultaat van de beeldmethode is een voltooide afbeelding.
In Ailoot betreft deze kaart generatie met tekstinvoer. OpenAI beschrijft ook werken met bronafbeeldingen, bewerking en wijziging van specifieke gebieden. Die mogelijkheden vereisen afzonderlijke ondersteuning voor visuele invoer en horen niet bij de hier aangegeven tekstuele generatiemethode.
Bij de afzonderlijke bewerkingshandeling van OpenAI dient een masker als richtlijn: een exacte overeenkomst van het resultaat met de maskercontouren wordt niet gegarandeerd. Zo'n handeling vereist ondersteuning voor het aanleveren van de bronafbeelding; de huidige Ailoot-kaart blijft generatie met tekstinvoer betreffen.
Een vierkant formaat 1024x1024, horizontaal 1536x1024 en verticaal 1024x1536 zijn voorzien, evenals automatische selectie. Willekeurige afmetingen van andere modellen mogen niet op deze versie worden toegepast.
De kwaliteitsniveaus zijn low, medium, high en auto. De kwaliteitskeuze beïnvloedt de verwerkingsomvang en de detaillering van het resultaat. Kwaliteit en afmetingen zijn verschillende instellingen: de beeldoriëntatie bepaalt de compositieruimte en het kwaliteitsniveau de vormingsmodus. xhigh en max zijn niet aangekondigd voor GPT Image 1.5.
Standaard wordt het resultaat als PNG gemaakt; JPEG en WebP zijn ook voorzien. Voor JPEG en WebP kan de compressiegraad worden ingesteld. Dit is een instelling van het resultaatbestand en verschilt van de generatiekwaliteit.
De fabrikant voorziet in een transparante en ondoorzichtige achtergrond en automatische selectie. Transparantie vereist PNG of WebP: JPEG bewaart geen alfakanaal. Een transparante achtergrond is handig wanneer de afbeelding als los object in een latere compositie wordt gebruikt. Ondersteuning voor specifieke parameters moet aan de gekozen methode worden gekoppeld.
Het model kan tekst in de afbeelding opnemen en een scène uit meerdere elementen opbouwen, maar de exacte positie van tekst en objecten wordt niet gegarandeerd. Ook het consequent behouden van een personage-uiterlijk of vormgeving tussen afzonderlijke generaties vereist controle.
Een complexe afbeelding kan langer duren dan een eenvoudige; volgens OpenAI kunnen afzonderlijke complexe opdrachten tot twee minuten duren. Voor het resultaat zijn zowel een volledige bronbeschrijving als controle van de voltooide afbeelding belangrijk: tekstleesbaarheid, detailposities en overeenkomst met de gevraagde scène worden op het bestand zelf beoordeeld.
POST /v1/images/generationstextimage| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten gpt-image-1.5 | Standaard— |
Veldprompt | Typestring | VereisteVereist | Waarden en limieten Maximumlengte: 32.000 | Standaard— |
Veldsize | Typestring | VereisteOptioneel | Waarden en limieten 1024x1024, 1536x1024, 1024x1536, auto | 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.32768 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-1.5', '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-1.5
Ailoot Ultra gpt-image-1.5
Gebruik de hierboven getoonde methodepaden.