GPT Image 1.5 est un modèle d’OpenAI pour créer des images à partir d’une description textuelle. Le fabricant met en avant le respect des instructions et le traitement d’une consigne détaillée : celle-ci peut définir le contenu de la scène, la composition, l’apparence des objets et le style souhaité. Le résultat de la méthode d’images est une image finalisée.
Dans Ailoot, cette fiche concerne la génération avec une entrée textuelle. OpenAI décrit également le travail du modèle avec des images sources, la retouche et la modification de zones précises. Ces fonctions nécessitent une prise en charge distincte des entrées visuelles et ne font pas partie de la génération textuelle indiquée ici.
Dans l’opération de retouche prévue séparément par OpenAI, le masque sert de guide : une correspondance exacte du résultat avec ses contours n’est pas garantie. Cette opération nécessite la prise en charge de la transmission de l’image source ; la fiche Ailoot actuelle concerne toujours la génération avec une entrée textuelle.
Les dimensions prévues sont carrées, 1024x1024, horizontales, 1536x1024, et verticales, 1024x1536, avec également un choix automatique. Les dimensions libres d’autres modèles ne doivent pas être transposées à cette version.
Les niveaux de qualité sont low, medium, high et auto. Le choix de qualité influence le volume du traitement et le degré de détail du résultat. La qualité et les dimensions sont deux réglages différents : l’orientation de l’image définit l’espace de composition, et le niveau de qualité le mode de production. Les niveaux xhigh et max ne sont pas annoncés pour GPT Image 1.5.
Le résultat est créé en PNG par défaut ; JPEG et WebP sont également prévus. Pour JPEG et WebP, le degré de compression peut être défini. Il s’agit d’un réglage du fichier de résultat, distinct de la qualité de génération.
Le fabricant prévoit un arrière-plan transparent ou opaque, ainsi qu’un choix automatique. La transparence nécessite PNG ou WebP : JPEG ne conserve pas le canal alpha. Un arrière-plan transparent convient lorsque l’image doit être utilisée comme un objet distinct dans une composition ultérieure. La prise en charge des paramètres précis doit être mise en relation avec la méthode choisie.
Le modèle peut intégrer du texte dans une image et composer une scène à partir de plusieurs éléments, mais la position exacte du texte et des objets n’est pas garantie. La constance de l’apparence d’un personnage ou de la présentation entre des générations distinctes nécessite également un contrôle.
Une image complexe peut demander plus de temps qu’une image simple ; selon OpenAI, certaines tâches complexes peuvent prendre jusqu’à deux minutes. Le résultat dépend à la fois de la complétude de la description source et de la vérification de l’image finalisée : la lisibilité des textes, la position des détails et la conformité à la scène demandée s’évaluent sur le fichier lui-même.
", "aboutText": "### Une image à partir d’une consigne détaillée\n\nGPT Image 1.5 est un modèle d’OpenAI pour créer des images à partir d’une description textuelle. Le fabricant met en avant le respect des instructions et le traitement d’une consigne détaillée : celle-ci peut définir le contenu de la scène, la composition, l’apparence des objets et le style souhaité. Le résultat de la méthode d’images est une image finalisée.\n\nDans Ailoot, cette fiche concerne la génération avec une entrée textuelle. OpenAI décrit également le travail du modèle avec des images sources, la retouche et la modification de zones précises. Ces fonctions nécessitent une prise en charge distincte des entrées visuelles et ne font pas partie de la génération textuelle indiquée ici.\n\nDans l’opération de retouche prévue séparément par OpenAI, le masque sert de guide : une correspondance exacte du résultat avec ses contours n’est pas garantie. Cette opération nécessite la prise en charge de la transmission de l’image source ; la fiche Ailoot actuelle concerne toujours la génération avec une entrée textuelle.\n\n### Trois formes d’image et le réglage de la qualité\n\nLes dimensions prévues sont carrées, `1024x1024`, horizontales, `1536x1024`, et verticales, `1024x1536`, avec également un choix automatique. Les dimensions libres d’autres modèles ne doivent pas être transposées à cette version.\n\nLes niveaux de qualité sont `low`, `medium`, `high` et `auto`. Le choix de qualité influence le volume du traitement et le degré de détail du résultat. La qualité et les dimensions sont deux réglages différents : l’orientation de l’image définit l’espace de composition, et le niveau de qualité le mode de production. Les niveaux `xhigh` et `max` ne sont pas annoncés pour GPT Image 1.5.\n\n### Le format de fichier et l’arrière-plan\n\nLe résultat est créé en PNG par défaut ; JPEG et WebP sont également prévus. Pour JPEG et WebP, le degré de compression peut être défini. Il s’agit d’un réglage du fichier de résultat, distinct de la qualité de génération.\n\nLe fabricant prévoit un arrière-plan transparent ou opaque, ainsi qu’un choix automatique. La transparence nécessite PNG ou WebP : JPEG ne conserve pas le canal alpha. Un arrière-plan transparent convient lorsque l’image doit être utilisée comme un objet distinct dans une composition ultérieure. La prise en charge des paramètres précis doit être mise en relation avec la méthode choisie.\n\n### Le texte et la composition doivent être vérifiés\n\nLe modèle peut intégrer du texte dans une image et composer une scène à partir de plusieurs éléments, mais la position exacte du texte et des objets n’est pas garantie. La constance de l’apparence d’un personnage ou de la présentation entre des générations distinctes nécessite également un contrôle.\n\nUne image complexe peut demander plus de temps qu’une image simple ; selon OpenAI, certaines tâches complexes peuvent prendre jusqu’à deux minutes. Le résultat dépend à la fois de la complétude de la description source et de la vérification de l’image finalisée : la lisibilité des textes, la position des détails et la conformité à la scène demandée s’évaluent sur le fichier lui-même.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "ec76bf6c9e26b21afcd89e36b2932e94ff65c32cc26a16e0456f93e858ec01f5", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "fr-be", "methods": [ { "html": "gpt-image-1.5GPT Image 1.5 crée des images à partir d’une consigne textuelle en privilégiant le respect d’instructions détaillées. Trois formes d’image, plusieurs niveaux de qualité et formats de résultat sont prévus.
Cette description présente les capacités du modèle. Les entrées, sorties et options disponibles dans Ailoot pour la méthode sélectionnée figurent ci-dessous.
GPT Image 1.5 est un modèle d’OpenAI pour créer des images à partir d’une description textuelle. Le fabricant met en avant le respect des instructions et le traitement d’une consigne détaillée : celle-ci peut définir le contenu de la scène, la composition, l’apparence des objets et le style souhaité. Le résultat de la méthode d’images est une image finalisée.
Dans Ailoot, cette fiche concerne la génération avec une entrée textuelle. OpenAI décrit également le travail du modèle avec des images sources, la retouche et la modification de zones précises. Ces fonctions nécessitent une prise en charge distincte des entrées visuelles et ne font pas partie de la génération textuelle indiquée ici.
Dans l’opération de retouche prévue séparément par OpenAI, le masque sert de guide : une correspondance exacte du résultat avec ses contours n’est pas garantie. Cette opération nécessite la prise en charge de la transmission de l’image source ; la fiche Ailoot actuelle concerne toujours la génération avec une entrée textuelle.
Les dimensions prévues sont carrées, 1024x1024, horizontales, 1536x1024, et verticales, 1024x1536, avec également un choix automatique. Les dimensions libres d’autres modèles ne doivent pas être transposées à cette version.
Les niveaux de qualité sont low, medium, high et auto. Le choix de qualité influence le volume du traitement et le degré de détail du résultat. La qualité et les dimensions sont deux réglages différents : l’orientation de l’image définit l’espace de composition, et le niveau de qualité le mode de production. Les niveaux xhigh et max ne sont pas annoncés pour GPT Image 1.5.
Le résultat est créé en PNG par défaut ; JPEG et WebP sont également prévus. Pour JPEG et WebP, le degré de compression peut être défini. Il s’agit d’un réglage du fichier de résultat, distinct de la qualité de génération.
Le fabricant prévoit un arrière-plan transparent ou opaque, ainsi qu’un choix automatique. La transparence nécessite PNG ou WebP : JPEG ne conserve pas le canal alpha. Un arrière-plan transparent convient lorsque l’image doit être utilisée comme un objet distinct dans une composition ultérieure. La prise en charge des paramètres précis doit être mise en relation avec la méthode choisie.
Le modèle peut intégrer du texte dans une image et composer une scène à partir de plusieurs éléments, mais la position exacte du texte et des objets n’est pas garantie. La constance de l’apparence d’un personnage ou de la présentation entre des générations distinctes nécessite également un contrôle.
Une image complexe peut demander plus de temps qu’une image simple ; selon OpenAI, certaines tâches complexes peuvent prendre jusqu’à deux minutes. Le résultat dépend à la fois de la complétude de la description source et de la vérification de l’image finalisée : la lisibilité des textes, la position des détails et la conformité à la scène demandée s’évaluent sur le fichier lui-même.
POST /v1/images/generationstextimage| Champ | Type | Exigence | Valeurs et limites | Par défaut |
|---|---|---|---|---|
Champmodel | Typestring | ExigenceObligatoire | Valeurs et limites gpt-image-1.5 | Par défaut— |
Champprompt | Typestring | ExigenceObligatoire | Valeurs et limites Longueur minimale: 1 | Par défaut— |
Champn | Typeinteger | ExigenceFacultatif | Valeurs et limites Minimum: 1 | Par défaut1 |
Champresponse_format | Typestring | ExigenceFacultatif | Valeurs et limites url, b64_json | Par défaut— |
Champstream | Typeboolean | ExigenceFacultatif | Valeurs et limites | Par défautfalse |
Champsize | Typestring | ExigenceFacultatif | Valeurs et limites Selon le modèle | Par défaut— |
Champquality | Typestring | ExigenceFacultatif | Valeurs et limites Selon le modèle | Par défaut— |
Champbackground | Typestring | ExigenceFacultatif | Valeurs et limites Selon le modèle | Par défaut— |
Champoutput_format | Typestring | ExigenceFacultatif | Valeurs et limites Selon le modèle | Par défaut— |
Champoutput_compression | Typeinteger | ExigenceFacultatif | Valeurs et limites Selon le modèle | Par défaut— |
Champmoderation | Typestring | ExigenceFacultatif | Valeurs et limites Selon le modèle | Par défaut— |
Champinput_fidelity | Typestring | ExigenceFacultatif | Valeurs et limites Selon le modèle | Par défaut— |
Champstyle | Typestring | ExigenceFacultatif | Valeurs et limites Selon le modèle | Par défaut— |
Champpartial_images | Typeinteger | ExigenceFacultatif | Valeurs et limites Selon le modèle | Par défaut— |
Texte vers image · Obligatoire : prompt
| Paramètre | Contrat |
|---|---|
Paramètrematerial_types | Contrattext |
Paramètrerequired | Contratmodel, prompt |
Paramètreoptional_controls | Contratnull |
Paramètrecontent_type | Contratapplication/json |
Cycle de vie : synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · task_id effectivement renvoyé ou enregistrement de la bibliothèque multimédia
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Les structures des méthodes et les identifiants sont exacts ; la capacité du fournisseur est distincte de l’admission.
POST /v1/images/generationsAiloot réserve un montant estimé avant une requête. Après le résultat, le montant final est débité selon l’utilisation mesurée. Pour le streaming, le montant final à débiter est calculé à partir du relevé final d’utilisation. Fonctionnement de la réservation et du débit →
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");\nTéléchargez chaque image renvoyée ou enregistrez son contenu Base64
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}Enregistrez chaque image terminée ; récupérez chaque URL renvoyée ou décodez son contenu Base64.
Enregistrez chaque élément de données. Décodez chaque b64_json ou récupérez chaque URL signée renvoyée. Choisissez l’extension du fichier à partir du type MIME et des octets réels.
Si le résultat d’une génération ou d’une retouche d’image nécessite une vérification, conservez l’operation_id/X-Client-Request-ID d’origine et les informations renvoyées sur le résultat. Récupérez les résultats existants qui vous appartiennent via la bibliothèque multimédia, à l’aide des valeurs task_id ou asset_id réelles. Ne soumettez pas à nouveau la requête de génération/retouche et ne construisez pas d’URL d’interrogation du statut à partir d’operation_id.
| Champ | Type |
|---|---|
Champcreated | Typeinteger |
Champdata[].url | Typestring |
Champdata[].b64_json | Typebase64 string |
Champusage | Typeobject |
| Réponse | Condition | Étape suivante |
|---|---|---|
Réponse400 · invalid_request_error | ConditionChamps obligatoires, représentation des contenus ou valeur de paramètre non valides | Étape suivanteCorrigez les champs indiqués avant une nouvelle requête de création. |
Réponseserver_error | ConditionLa réponse renvoyée indique que l’opération ou le résultat nécessite une vérification | Étape suivanteConservez l’identifiant d’opération/de tâche initialement renvoyé, les en-têtes de la requête et la réponse ; poursuivez les lectures prises en charge de cette opération d’origine. Ne soumettez pas à nouveau la requête de création. |
Ailoot gpt-image-1.5
Ailoot Ultra gpt-image-1.5
Utilisez les chemins de méthode indiqués ci-dessus.
gpt-image-1.5GPT Image 1.5 crée des images à partir d’une consigne textuelle en privilégiant le respect d’instructions détaillées. Trois formes d’image, plusieurs niveaux de qualité et formats de résultat sont prévus.
Cette description présente les capacités du modèle. Les entrées, sorties et options disponibles dans Ailoot pour la méthode sélectionnée figurent ci-dessous.
GPT Image 1.5 est un modèle d’OpenAI pour créer des images à partir d’une description textuelle. Le fabricant met en avant le respect des instructions et le traitement d’une consigne détaillée : celle-ci peut définir le contenu de la scène, la composition, l’apparence des objets et le style souhaité. Le résultat de la méthode d’images est une image finalisée.
Dans Ailoot, cette fiche concerne la génération avec une entrée textuelle. OpenAI décrit également le travail du modèle avec des images sources, la retouche et la modification de zones précises. Ces fonctions nécessitent une prise en charge distincte des entrées visuelles et ne font pas partie de la génération textuelle indiquée ici.
Dans l’opération de retouche prévue séparément par OpenAI, le masque sert de guide : une correspondance exacte du résultat avec ses contours n’est pas garantie. Cette opération nécessite la prise en charge de la transmission de l’image source ; la fiche Ailoot actuelle concerne toujours la génération avec une entrée textuelle.
Les dimensions prévues sont carrées, 1024x1024, horizontales, 1536x1024, et verticales, 1024x1536, avec également un choix automatique. Les dimensions libres d’autres modèles ne doivent pas être transposées à cette version.
Les niveaux de qualité sont low, medium, high et auto. Le choix de qualité influence le volume du traitement et le degré de détail du résultat. La qualité et les dimensions sont deux réglages différents : l’orientation de l’image définit l’espace de composition, et le niveau de qualité le mode de production. Les niveaux xhigh et max ne sont pas annoncés pour GPT Image 1.5.
Le résultat est créé en PNG par défaut ; JPEG et WebP sont également prévus. Pour JPEG et WebP, le degré de compression peut être défini. Il s’agit d’un réglage du fichier de résultat, distinct de la qualité de génération.
Le fabricant prévoit un arrière-plan transparent ou opaque, ainsi qu’un choix automatique. La transparence nécessite PNG ou WebP : JPEG ne conserve pas le canal alpha. Un arrière-plan transparent convient lorsque l’image doit être utilisée comme un objet distinct dans une composition ultérieure. La prise en charge des paramètres précis doit être mise en relation avec la méthode choisie.
Le modèle peut intégrer du texte dans une image et composer une scène à partir de plusieurs éléments, mais la position exacte du texte et des objets n’est pas garantie. La constance de l’apparence d’un personnage ou de la présentation entre des générations distinctes nécessite également un contrôle.
Une image complexe peut demander plus de temps qu’une image simple ; selon OpenAI, certaines tâches complexes peuvent prendre jusqu’à deux minutes. Le résultat dépend à la fois de la complétude de la description source et de la vérification de l’image finalisée : la lisibilité des textes, la position des détails et la conformité à la scène demandée s’évaluent sur le fichier lui-même.
POST /v1/images/generationstextimage| Champ | Type | Exigence | Valeurs et limites | Par défaut |
|---|---|---|---|---|
Champmodel | Typestring | ExigenceObligatoire | Valeurs et limites gpt-image-1.5 | Par défaut— |
Champprompt | Typestring | ExigenceObligatoire | Valeurs et limites Longueur maximale: 32 000 | Par défaut— |
Champsize | Typestring | ExigenceFacultatif | Valeurs et limites 1024x1024, 1536x1024, 1024x1536, auto | Par défautauto |
Champbackground | Typestring | ExigenceFacultatif | Valeurs et limites transparent, opaque, auto | Par défautauto |
Champmoderation | Typestring | ExigenceFacultatif | Valeurs et limites low, auto Conditions: Utilisez auto pour la modération standard du contenu. | Par défaut— |
Champn | Typeinteger | ExigenceFacultatif | Valeurs et limites Minimum: 1 Maximum: 10 | Par défaut1 |
Champquality | Typestring | ExigenceFacultatif | Valeurs et limites auto, high, medium, low | Par défautauto |
Champoutput_compression | Typeinteger | ExigenceFacultatif | Valeurs et limites Minimum: 0 Maximum: 100 Conditions: S’applique aux sorties JPEG et WebP ; envoyez la valeur entière documentée. | Par défaut100 |
Champoutput_format | Typestring | ExigenceFacultatif | Valeurs et limites webp, png, jpeg | Par défautpng |
Champstream | Typeboolean | ExigenceFacultatif | Valeurs et limites false Conditions: Cette route renvoie une réponse JSON complète. | Par défautfalse |
| Paramètre | Contrat |
|---|---|
Paramètrecontent_type | Contratapplication/json |
Paramètrerequired | Contratprompt, model |
Paramètrematerial_types | Contrattext |
Paramètreoptional | Contratsize, background, moderation, n, quality, output_compression, output_format, stream |
Paramètreconditions | ContratUn arrière-plan transparent nécessite le format PNG ou WebP., La compression de sortie s’applique au format JPEG ou WebP., La méthode sélectionnée génère à partir de texte. Les paramètres de modification et de diffusion en continu décrits pour le fabricant sont des capacités distinctes. |
Cycle de vie : synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · task_id effectivement renvoyé ou enregistrement de la bibliothèque multimédia
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Les tarifs affichés servent à estimer le coût avant la génération. Le montant final est calculé à partir du coût enregistré pour la génération d’origine. La durée mesurée du résultat et les quantités prévisionnelles ne constituent pas la quantité finale facturable.
Les tarifs n’ajoutent pas d’options de requête. Les paramètres pris en charge figurent dans la méthode sélectionnée.
Associez chaque coût aux conditions indiquées. Utilisez un seul tarif pour chaque ensemble de configurations alternatives.
| Configuration | Barème tarifaire | Quantité prévisionnelle | Coût |
|---|---|---|---|
| ConfigurationTarifs de base des jetons | Barème tarifaireTarif de base | Quantité prévisionnelle— | Coût Entrée · Tokens en entrée · Estimation à des fins de comparaison uniquement — / 1K tokens Sortie · Tokens en sortie · Estimation à des fins de comparaison uniquement — / 1K tokens Entrée · Lecture du cache · Estimation à des fins de comparaison uniquement — / 1K tokens Entrée · Écriture dans le cache · Estimation à des fins de comparaison uniquement — / 1K tokens Entrée · Écriture dans le cache, 1 h · Estimation à des fins de comparaison uniquement — / 1K tokens |
| ConfigurationCoût estimé de la génération | Barème tarifaire— | Quantité prévisionnelleEstimation pour une génération | Coût Sortie · Coût estimé de génération · Estimation à des fins de comparaison uniquement $0.32768 estimation avant génération Cette estimation ne constitue ni des frais supplémentaires ni un tarif fixe pour la génération terminée. |
Ailoot réserve un montant estimé avant une requête. Après le résultat, le montant final est débité selon l’utilisation mesurée. Pour le streaming, le montant final à débiter est calculé à partir du relevé final d’utilisation. Fonctionnement de la réservation et du débit →
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\nTéléchargez chaque image renvoyée ou enregistrez son contenu Base64
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.\nEnregistrez chaque image terminée ; récupérez chaque URL renvoyée ou décodez son contenu Base64.
Conservez la réponse complète et les en-têtes, chaque sortie effective, les identifiants initialement renvoyés et tous les champs d’utilisation. Récupérez l’opération d’origine sans soumettre à nouveau sa création.
Conservez le X-Client-Request-ID renvoyé pour le rapprochement. Consultez uniquement les valeurs task_id/asset_id effectivement renvoyées ou votre bibliothèque multimédia ; ne construisez jamais une URL de tâche à partir de l’identifiant de l’opération et ne soumettez jamais à nouveau la création.
| Champ | Type |
|---|---|
Champcreated | Type |
Champdata[].url | Type |
Champdata[].b64_json | Type |
Champusage | Type |
Ailoot gpt-image-1.5
Ailoot Ultra gpt-image-1.5
Utilisez les chemins de méthode indiqués ci-dessus.