Source: https://ailoot.ai/models/fr-ch/openai-gpt-5-4-image-2/ Canonical: https://ailoot.ai/models/fr-ch/openai-gpt-5-4-image-2/ Language: fr-ch # OpenAI: GPT-5.4 Image 2 [Markdown](https://ailoot.ai/models/fr-ch/openai-gpt-5-4-image-2/index.md) · [JSON](https://ailoot.ai/models/fr-ch/openai-gpt-5-4-image-2/facts.json) ## [OpenAI: GPT-5.4 Image 2](https://ailoot.ai/models/fr-ch/openai-gpt-5-4-image-2/) Un processus associant le raisonnement textuel de GPT-5.4 à la génération et à la modification d’images de GPT Image 2. Utilisez des consignes écrites et des références visuelles pour élaborer une illustration ou une modification tout en gardant distincts les rôles des composants textuel et visuel. - [**Ailoot Ultra · OpenAI Chat** `POST /v1/chat/completions` `openai/gpt-5.4-image-2`](https://ailoot.ai/models/fr-ch/openai-gpt-5-4-image-2/#method-0) - [**Ailoot Ultra · Génération d’images** `POST /v1/images/generations` `openai/gpt-5.4-image-2`](https://ailoot.ai/models/fr-ch/openai-gpt-5-4-image-2/#method-1) - [**Ailoot Ultra · Anthropic Messages** `POST /v1/messages` `openai/gpt-5.4-image-2`](https://ailoot.ai/models/fr-ch/openai-gpt-5-4-image-2/#method-2) À propos du modèle 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-5.4 Image 2 décrit un processus combinant le modèle textuel GPT-5.4 d’OpenAI avec GPT Image 2 pour la génération et la modification d’images. Les composants ont des rôles distincts : GPT-5.4 peut interpréter des consignes et élaborer les instructions écrites, tandis que GPT Image 2 crée ou modifie une image. GPT-5.4 accepte du texte et des images et produit du texte ; GPT Image 2 accepte des entrées textuelles et visuelles et produit des images. Pour un nouveau visuel, décrivez son objectif, son sujet, sa composition, son style et les détails qui importent pour le résultat. Une tâche peut par exemple consister à préparer une illustration d’article : définissez l’idée que l’image doit communiquer, le recadrage prévu et l’espace nécessaire pour le texte d’accompagnement de la page. L’étape textuelle peut organiser ces exigences en consignes claires. L’étape d’image utilise le prompt et les éventuelles références pour créer le livrable visuel. Pour une modification, fournissez l’image source et séparez les changements demandés des éléments à préserver. GPT Image 2 traite automatiquement les images en entrée avec une haute fidélité, ce qui permet les modifications sensibles aux détails et les processus à base de références. Le fabricant documente la retouche locale et le travail d’image à partir de références. Un masque peut guider la zone à modifier, mais le masquage de GPT Image repose sur le prompt et peut ne pas suivre précisément la forme du masque. Le processus de masque documenté exige que l’image cible et le masque aient le même format et les mêmes dimensions, que le masque comporte un canal alpha et que les fichiers fassent moins de 50 MB. GPT Image 2 prend en charge les qualités low, medium, high et la sélection automatique de la qualité. Ses tailles personnalisées exigent que les deux côtés soient des multiples de 16 pixels, qu’aucun côté ne dépasse 3 840 pixels, que le rapport d’aspect ne soit pas plus extrême que 3:1 et que la taille totale soit comprise entre 655 360 et 8 294 400 pixels. Les exemples documentés comprennent 1 024 × 1 024, 1 536 × 1 024, 2 048 × 2 048 et 3 840 × 2 160. Choisissez les dimensions en fonction de la destination plutôt que de supposer que tous les visuels doivent être carrés. Dans le profil de sortie Image API documenté du fournisseur, PNG est le format par défaut, avec JPEG et WebP également disponibles. JPEG et WebP prennent en charge un réglage de compression de 0 à 100. Le composant textuel possède sa propre spécification. La fenêtre de contexte publiée de GPT-5.4 est de 1 050 000 tokens, sa sortie maximale est de 128 000 tokens et sa date limite des connaissances est le 31 août 2025. Ses choix d’effort de raisonnement sont none, low, medium, high et xhigh, avec none par défaut. Le fournisseur mentionne la génération d’images parmi les outils de GPT-5.4, tandis qu’Image API propose également des opérations distinctes de génération et de modification. Ces rôles documentés des composants ne transforment pas le nom combiné en un nouveau modèle autonome doté d’une limite commune au texte et aux images. Le guide d’image décrit des limites dans le placement précis du texte, la cohérence visuelle récurrente et la composition exacte. Préparez un texte court et clairement spécifié lorsque le lettrage importe, fournissez la référence pertinente pour un sujet récurrent et identifiez explicitement les contraintes de mise en page. Examinez l’image générée ou modifiée au regard de ces exigences. Un résultat utile peut comprendre les consignes écrites, l’image et une liste ciblée de changements pour la modification suivante, reliant le visuel à l’objectif éditorial ou produit d’origine. Cas pratique ### Cas pratique Exemple technique en anglais ``` Revise an editorial illustration crop Edit the supplied article illustration for a landscape header. Preserve the central paper boat's shape, folded edges and blue color. Extend the calm water naturally to the left and leave that side visually quiet for page text added later. Keep the existing light direction and add no words, logos, people or extra boats. ``` #### Résultat attendu ``` An edited landscape image with the original boat preserved and clear composition space on the left. ``` #### Vérifier le résultat ``` Compare boat details and light direction with the source, and inspect the added water for repeated or distorted elements. ``` **Ailoot Ultra · OpenAI Chat** `POST /v1/chat/completions` `openai/gpt-5.4-image-2` [`openai/gpt-5.4-image-2`](https://ailoot.ai/models/fr-ch/#m=openai%2Fgpt-5.4-image-2&route=Ultra&caller=openai%2Fgpt-5.4-image-2&fmt=chat) OpenAI /`openai/gpt-5.4-image-2` ### Premiers pas Un processus associant le raisonnement textuel de GPT-5.4 à la génération et à la modification d’images de GPT Image 2. Utilisez des consignes écrites et des références visuelles pour élaborer une illustration ou une modification tout en gardant distincts les rôles des composants textuel et visuel. Entrées acceptées Texte Résultats Texte ### Disponible dans Ailoot · entrées et méthodes **Ailoot Ultra · OpenAI Chat** `POST /v1/chat/completions` Entrée `text` Sortie `text` Format de sortie json ou SSE | Champ | Type | Exigence | Valeurs et limites | Par défaut | | --- | --- | --- | --- | --- | | Champ`model` | Type`string` | ExigenceObligatoire | Valeurs et limites openai/gpt-5.4-image-2 | Par défaut— | | Champ`messages` | Type`message[]` | ExigenceObligatoire | Valeurs et limites Nombre minimal d’éléments: 1 | Par défaut— | | Champ`messages[].role` | Type`string` | ExigenceObligatoire | Valeurs et limites Exemples : system, user, assistant, tool, function Conditions: Ces rôles sont explicitement représentés par les types de compatibilité du code source ; l’ensemble exact des rôles reste propre à chaque modèle. Selon le modèle | Par défaut— | | Champ`messages[].content` | Type`string\|content_part[]\|null` | ExigenceFacultatif | Valeurs et limites | Par défaut— | | Champ`messages[].tool_calls` | Type`tool_call[]` | ExigenceFacultatif | Valeurs et limites | Par défaut— | | Champ`messages[].tool_call_id` | Type`string` | ExigenceFacultatif | Valeurs et limites S’applique lorsque: role=tool ; utilisez l’identifiant réellement renvoyé | Par défaut— | | Champ`messages[].name` | Type`string` | ExigenceFacultatif | Valeurs et limites | Par défaut— | | Champ`messages[].reasoning_content` | Type`string` | ExigenceFacultatif | Valeurs et limites S’applique lorsque: Réinjectez le raisonnement réellement renvoyé lorsque ce modèle l’utilise | Par défaut— | | Champ`messages[].reasoning_details` | Type`object\|array` | ExigenceFacultatif | Valeurs et limites Selon le modèle | Par défaut— | | Champ`max_tokens` | Type`integer` | ExigenceFacultatif | Valeurs et limites Minimum: 1 Selon le modèle | Par défaut— | | Champ`max_completion_tokens` | Type`integer` | ExigenceFacultatif | Valeurs et limites Minimum: 1 Selon le modèle | Par défaut— | | Champ`stream` | Type`boolean` | ExigenceFacultatif | Valeurs et limites | Par défautfalse | | Champ`stream_options.include_usage` | Type`boolean` | ExigenceFacultatif | Valeurs et limites Selon le modèle | Par défaut— | | Champ`temperature` | Type`number` | ExigenceFacultatif | Valeurs et limites Selon le modèle | Par défaut— | | Champ`top_p` | Type`number` | ExigenceFacultatif | Valeurs et limites Selon le modèle | Par défaut— | | Champ`stop` | Type`string\|string[]` | ExigenceFacultatif | Valeurs et limites Selon le modèle | Par défaut— | | Champ`tools` | Type`function_tool[]` | ExigenceFacultatif | Valeurs et limites Selon le modèle | Par défaut— | | Champ`tools[].type` | Type`string` | ExigenceFacultatif | Valeurs et limites function Selon le modèle | Par défaut— | | Champ`tools[].function.name` | Type`string` | ExigenceObligatoire | Valeurs et limites S’applique lorsque: outil de fonction fourni | Par défaut— | | Champ`tools[].function.description` | Type`string` | ExigenceFacultatif | Valeurs et limites | Par défaut— | | Champ`tools[].function.parameters` | Type`JSON_schema` | ExigenceFacultatif | Valeurs et limites | Par défaut— | | Champ`tool_choice` | Type`string\|object` | ExigenceFacultatif | Valeurs et limites Selon le modèle | Par défaut— | | Champ`parallel_tool_calls` | Type`boolean` | ExigenceFacultatif | Valeurs et limites Selon le modèle | Par défaut— | | Champ`response_format` | Type`object` | ExigenceFacultatif | Valeurs et limites Selon le modèle | Par défaut— | | Champ`reasoning_effort` | Type`string` | ExigenceFacultatif | Valeurs et limites Selon le modèle | Par défaut— | | Champ`reasoning` | Type`object` | ExigenceFacultatif | Valeurs et limites Selon le modèle | Par défaut— | | Champ`service_tier` | Type`string` | ExigenceFacultatif | Valeurs et limites Selon le modèle | Par défaut— | | Champ`instructions` | Type`string` | ExigenceFacultatif | Valeurs et limites Champ de compatibilité | Par défaut— | | Champ`functions` | Type`function[]` | ExigenceFacultatif | Valeurs et limites Selon le modèle | Par défaut— | | Champ`function_call` | Type`string\|object` | ExigenceFacultatif | Valeurs et limites Selon le modèle | Par défaut— | | Champ`prompt_cache_options` | Type`object` | ExigenceFacultatif | Valeurs et limites Selon le modèle | Par défaut— | | Champ`modalities` | Type`string[]` | ExigenceFacultatif | Valeurs et limites text | Par défaut— | | Champ`provider` | Type`object` | ExigenceFacultatif | Valeurs et limites Conditions: provider.options est rejeté sur cette route textuelle Ultra | Par défaut— | | Champ`cache_control.ttl` | Type`string` | ExigenceFacultatif | Valeurs et limites Conditions: 1h est rejeté dans les emplacements réels du cache de prompt | Par défaut— | Combinaisons d’éléments d’entrée **Texte** · Texte UTF8 `messages[].content` Paramètres et cycle de vie de la méthode | Paramètre | Contrat | | --- | --- | | Paramètre`content_type` | Contratapplication/json | | Paramètre`required` | Contratmodel, messages | | Paramètre`material_types` | Contrattext | | Paramètre`messages` | Contrattableau de messages avec une structure role/content | | Paramètre`file_material` | Contratdocument UTF-8 réel inséré sous forme de texte littéral ; aucun identifiant de fichier déduit | | Paramètre`optional_controls` | Contratstream, temperature, top\_p, stop, max\_tokens, max\_completion\_tokens, reasoning, response\_format, tools, tool\_choice | | Paramètre`control_scope` | Contratpropre au modèle ; les outils de fonctions de l’utilisateur diffèrent des outils hébergés | | Paramètre`output_modalities` | Contrattext | | Paramètre`hosted_operations` | Contratfalse | | Paramètre`multimodal_input_binding` | Contratnull | Cycle de vie : `synchronous_or_streamed` Envoyez l’identifiant exact du modèle avec messages. La longueur du contexte n’est pas un plafond de sortie. Un fichier texte peut fournir du texte littéral ; les entrées image/audio/objets fichier nécessitent une liaison exacte. ### Tarifs Les tarifs n’ajoutent pas d’options de requête. Les paramètres pris en charge figurent dans la méthode sélectionnée. Mode rapide Tarif standard Lorsque le mode rapide est sélectionné Mode Flex Tarif standard Lorsque le mode flex est sélectionné Effort de raisonnement maximal Tarif standard Lorsque l’effort de raisonnement maximal utilise l’ajustement par défaut (default) Effort de raisonnement · élevé Tarif standard Lorsque l’effort de raisonnement est élevé Effort de raisonnement · faible Tarif standard Lorsque l’effort de raisonnement est faible Effort de raisonnement · moyen Tarif standard Lorsque l’effort de raisonnement est moyen Effort de raisonnement · aucun Tarif standard Lorsque l’effort de raisonnement est nul Effort de raisonnement · xhigh Tarif standard Lorsque l’effort de raisonnement vaut xhigh #### Tarifs Ailoot #### Prix par configuration Associez chaque coût aux conditions indiquées. Utilisez un seul tarif pour chaque ensemble de configurations alternatives. | Configuration | Barème tarifaire | Tokens de contexte, plus de | Tokens de contexte, jusqu’à la limite incluse | Coût | | --- | --- | --- | --- | --- | | ConfigurationTarifs de base des tokens | Barème tarifaireTarif de base | Tokens de contexte, plus de— | Tokens de contexte, jusqu’à la limite incluseSans borne supérieure | Coût Entrée · Tokens en entrée **$0.016** / 1K tokens Sortie · Tokens en sortie **$0.03** / 1K tokens Entrée · Lecture du cache **$0.004** / 1K tokens Entrée · Écriture dans le cache **—** / 1K tokens Entrée · Écriture dans le cache, 1 h **—** / 1K tokens Sortie · Jetons d’image en sortie **$0.06** / 1K tokens image | | ConfigurationPalier 1 de longueur de requête | Barème tarifaire— | Tokens de contexte, plus de0 | Tokens de contexte, jusqu’à la limite incluseSans borne supérieure | Coût Entrée · Tokens en entrée **$0.016** / 1K tokens Sortie · Tokens en sortie **$0.03** / 1K tokens Entrée · Lecture du cache **$0.004** / 1K tokens Entrée · Écriture dans le cache **—** / 1K tokens Entrée · Écriture dans le cache, 1 h **—** / 1K tokens | #### Détails du tarif de référence Les barèmes de référence du modèle ne modifient ni la sélection de méthode, ni les devis, ni les coûts. Les frais actifs utilisent les tarifs de la méthode Ailoot sélectionnée. OpenAI: GPT-5.4 Image 2 #### Prix par configuration | Configuration | Conditions de facturation | Coût | | --- | --- | --- | | ConfigurationOpenAI: GPT-5.4 Image 2 · Configuration par défaut | Conditions de facturationConfiguration par défaut | Coût Entrée · Tokens en entrée **0.016 USD** / 1K tokens Sortie · Tokens en sortie **0.03 USD** / 1K tokens Sortie · Image en sortie **0.06 USD** / 1K tokens Sortie · Recherche web **0.02 USD** par recherche Entrée · Lecture du cache **0.004 USD** / 1K tokens | 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 →](https://ailoot.ai/docs/fr-ch/billing/reserve/) ### Exemples de requêtes #### Ailoot Ultra · OpenAI Chat curlPython SDKStreaming Python ```bash set -eu : "${AILOOT_API_KEY:?Set your Ailoot API key}" python3 - <<'PY_REQUEST' import json,os from pathlib import Path p=json.loads('{"model": "openai/gpt-5.4-image-2", "messages": [{"role": "user", "content": "Explain the difference between an observation and a hypothesis in three sentences."}]}') Path("request.json").write_text(json.dumps(p,ensure_ascii=False)) PY_REQUEST curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/chat/completions \ -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \ --data-binary @request.json -D response-headers.txt -o result.json python3 - <<'PY_RESULT' import json from pathlib import Path r=json.loads(Path("result.json").read_text()) for x in r.get("choices",[]): if x.get("message",{}).get("content"): print(x["message"]["content"]) PY_RESULT ``` ```python from openai import OpenAI import os if not os.environ.get("AILOOT_API_KEY", "").strip(): raise SystemExit("Set AILOOT_API_KEY before making a request") client=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0) result=client.chat.completions.create(model='openai/gpt-5.4-image-2',messages=[{"role":"user","content":"Explain observations and hypotheses in three sentences."}]) import base64, json from pathlib import Path def save_result(data, stem="result"): # Keep every field, including usage, IDs, reasoning and tool requests. Path(stem + ".json").write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8") print(json.dumps(data, ensure_ascii=False, indent=2)) def save_blob(encoded, suffix, label): raw = base64.b64decode(encoded, altchars=b"-_", validate=True) ext = "png" if raw.startswith(b"\x89PNG\r\n\x1a\n") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4] == b"RIFF" and raw[8:12] == b"WEBP" else suffix file = Path(stem + "-" + label + "." + ext) file.write_bytes(raw) print("Saved", file) for index, block in enumerate(data.get("content") or []): print("Content", index, json.dumps(block, ensure_ascii=False)) for choice in data.get("choices") or []: print("Choice", choice.get("index"), json.dumps(choice.get("message", choice.get("delta", {})), ensure_ascii=False)) for index, item in enumerate(data.get("output") or []): print("Output", index, json.dumps(item, ensure_ascii=False)) if item.get("type") == "image_generation_call" and item.get("result"): save_blob(item["result"], item.get("output_format") or "bin", "output-" + str(index)) for ci, candidate in enumerate(data.get("candidates") or []): for pi, part in enumerate((candidate.get("content") or {}).get("parts") or []): print("Candidate/part", ci, pi, json.dumps(part, ensure_ascii=False)) blob = part.get("inlineData") or part.get("inline_data") if blob and blob.get("data"): mime = blob.get("mimeType") or blob.get("mime_type") suffix = {"image/png":"png", "image/jpeg":"jpg", "image/webp":"webp", "audio/wav":"wav", "audio/mpeg":"mp3", "video/mp4":"mp4"}.get(mime, "bin") save_blob(blob["data"], suffix, "candidate-" + str(ci) + "-part-" + str(pi)) save_result(result.to_dict(mode="json")) ``` ```python from openai import OpenAI import os from pathlib import Path if not os.environ.get("AILOOT_API_KEY", "").strip(): raise SystemExit("Set AILOOT_API_KEY before making a request") client=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0) import base64, json from pathlib import Path def save_result(data, stem="result"): # Keep every field, including usage, IDs, reasoning and tool requests. Path(stem + ".json").write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8") print(json.dumps(data, ensure_ascii=False, indent=2)) def save_blob(encoded, suffix, label): raw = base64.b64decode(encoded, altchars=b"-_", validate=True) ext = "png" if raw.startswith(b"\x89PNG\r\n\x1a\n") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4] == b"RIFF" and raw[8:12] == b"WEBP" else suffix file = Path(stem + "-" + label + "." + ext) file.write_bytes(raw) print("Saved", file) for index, block in enumerate(data.get("content") or []): print("Content", index, json.dumps(block, ensure_ascii=False)) for choice in data.get("choices") or []: print("Choice", choice.get("index"), json.dumps(choice.get("message", choice.get("delta", {})), ensure_ascii=False)) for index, item in enumerate(data.get("output") or []): print("Output", index, json.dumps(item, ensure_ascii=False)) if item.get("type") == "image_generation_call" and item.get("result"): save_blob(item["result"], item.get("output_format") or "bin", "output-" + str(index)) for ci, candidate in enumerate(data.get("candidates") or []): for pi, part in enumerate((candidate.get("content") or {}).get("parts") or []): print("Candidate/part", ci, pi, json.dumps(part, ensure_ascii=False)) blob = part.get("inlineData") or part.get("inline_data") if blob and blob.get("data"): mime = blob.get("mimeType") or blob.get("mime_type") suffix = {"image/png":"png", "image/jpeg":"jpg", "image/webp":"webp", "audio/wav":"wav", "audio/mpeg":"mp3", "video/mp4":"mp4"}.get(mime, "bin") save_blob(blob["data"], suffix, "candidate-" + str(ci) + "-part-" + str(pi)) with client.chat.completions.stream(model='openai/gpt-5.4-image-2',messages=[{"role":"user","content":"Explain observations and hypotheses in three sentences."}]) as stream: with Path("stream-events.jsonl").open("w",encoding="utf-8") as log: for event in stream: payload=event.to_dict(mode="json") log.write(json.dumps(payload,ensure_ascii=False)+"\n"); log.flush() print(json.dumps(payload,ensure_ascii=False)) final=stream.get_final_completion() save_result(final.to_dict(mode="json"),"stream-result") ``` ### Recevoir et enregistrer les résultats #### Ailoot Ultra · OpenAI Chat json ou SSE ##### Conserver tous les résultats terminés Conservez chaque réponse, fichier et partie de contenu renvoyés dans leur intégralité. Conservez chaque choix avec son contenu, ses appels d’outils et son raisonnement. En SSE, assemblez les deltas par index de choix et d’outil, puis conservez le motif final de terminaison et les données d’utilisation. ##### Si la réponse d’origine doit être vérifiée Conservez les identifiants de requête et de réponse ainsi que les en-têtes. Aucune URL générique de récupération des tâches textuelles n’est fournie. Champs de la réponse | Champ | Type | | --- | --- | | Champ`choices[].index` | Typeinteger | | Champ`choices[].message.content` | Typestring\|null | | Champ`choices[].message.tool_calls` | Typetool\_call\[\] | | Champ`choices[].message.reasoning_content` | Typestring | | Champ`choices[].message.reasoning_details` | Typeobject\|array | | Champ`choices[].finish_reason` | Typestring\|null | | Champ`usage` | Typeobject | Erreurs et étapes suivantes | 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. | ### Alias #### Alias du modèle **Ailoot Ultra** [`openai/gpt-5.4-image-2`](https://ailoot.ai/models/fr-ch/#m=openai%2Fgpt-5.4-image-2&route=Ultra&caller=openai%2Fgpt-5.4-image-2&fmt=chat) #### Alias des chemins de méthode `/v1/images` #### ID d’appel associés [`openai/gpt-5.4-image-2`](https://ailoot.ai/models/fr-ch/#m=openai%2Fgpt-5.4-image-2&route=Ultra&caller=openai%2Fgpt-5.4-image-2&fmt=chat) **Ailoot Ultra · Génération d’images** `POST /v1/images/generations` `openai/gpt-5.4-image-2` [`openai/gpt-5.4-image-2`](https://ailoot.ai/models/fr-ch/#m=openai%2Fgpt-5.4-image-2&route=Ultra&caller=openai%2Fgpt-5.4-image-2&fmt=images) OpenAI /`openai/gpt-5.4-image-2` ### Premiers pas Un processus associant le raisonnement textuel de GPT-5.4 à la génération et à la modification d’images de GPT Image 2. Utilisez des consignes écrites et des références visuelles pour élaborer une illustration ou une modification tout en gardant distincts les rôles des composants textuel et visuel. Entrées acceptées Texte · Images Résultats Images ### Disponible dans Ailoot · entrées et méthodes **Ailoot Ultra · Génération d’images** `POST /v1/images/generations` Entrée `text`, `image` Sortie `image` | Champ | Type | Exigence | Valeurs et limites | Par défaut | | --- | --- | --- | --- | --- | | Champ`model` | Type`string` | ExigenceObligatoire | Valeurs et limites openai/gpt-5.4-image-2 | Par défaut— | | Champ`prompt` | Type`string` | ExigenceObligatoire | Valeurs et limites Longueur minimale: 1 | Par défaut— | | Champ`aspect_ratio` | Type`string` | ExigenceFacultatif | Valeurs et limites 1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9, auto | Par défaut— | | Champ`quality` | Type`string` | ExigenceFacultatif | Valeurs et limites auto, low, medium, high | Par défaut— | | Champ`background` | Type`string` | ExigenceFacultatif | Valeurs et limites auto, opaque | Par défaut— | | Champ`n` | Type`integer` | ExigenceFacultatif | Valeurs et limites Minimum: 1 Maximum: 10 | Par défaut— | | Champ`input_references` | Type`array` | ExigenceFacultatif | Valeurs et limites Nombre minimal d’éléments: 0 Nombre maximal d’éléments: 16 | Par défaut— | | Champ`output_compression` | Type`integer` | ExigenceFacultatif | Valeurs et limites Minimum: 0 Maximum: 100 | Par défaut— | | Champ`provider` | Type`object` | ExigenceFacultatif | Valeurs et limites | Par défaut— | Paramètres et cycle de vie de la méthode | Paramètre | Contrat | | --- | --- | | Paramètre`content_type` | Contratapplication/json | | Paramètre`required` | Contratmodel, prompt | | Paramètre`material_types` | Contrattext, image | 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}` ### Tarifs ##### Calcul du coût final 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. Mode rapide Non précisé Lorsque le mode rapide est sélectionné Mode Flex Non précisé Lorsque le mode flex est sélectionné Effort de raisonnement maximal Non précisé Lorsque l’effort de raisonnement maximal utilise l’ajustement par défaut (default) #### Tarifs estimés à des fins de comparaison #### Prix par configuration 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.24576** 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 →](https://ailoot.ai/docs/fr-ch/billing/reserve/) ### Exemples de requêtes #### Ailoot Ultra · Génération d’images curl ```bash set -eu : "${AILOOT_API_KEY:?Set your Ailoot API key}" export AILOOT_API_KEY python3 - <<'PY_REQUEST' import json,os from pathlib import Path p={'model': 'openai/gpt-5.4-image-2', 'prompt': 'a red panda astronaut floating in space, studio lighting'} Path("request.json").write_text(json.dumps(p,ensure_ascii=False)) PY_REQUEST curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \ -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \ --data-binary @request.json -D response-headers.txt -o result.json python3 - <<'PY_RESULT' import base64, json, os, subprocess from pathlib import Path from urllib.parse import urlsplit, urljoin def save_images(items): if not items: raise SystemExit("No completed images; retain the full response") for index, item in enumerate(items): encoded=item.get("b64_json") uri=item.get("url", "") if not encoded and uri.startswith("data:image/"): header, separator, encoded=uri.partition(",") if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI") if encoded: raw=base64.b64decode(encoded,validate=True) elif uri: uri=urljoin("https://api.ailoot.ai",uri) parsed=urlsplit(uri) if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password: raise SystemExit("Invalid returned image URL") owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content") args=["curl","--fail-with-body","--silent","--show-error",uri] if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]] temporary=Path(f"image-{index}.bin") subprocess.run(args+["-o",str(temporary)],check=True) raw=temporary.read_bytes() temporary.unlink() else: raise SystemExit("Image has neither bytes nor URL") if not raw: raise SystemExit("Empty image result") 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"