Génération d’images

Un remplacement model par appel essaie uniquement ce fournisseur/modèle et ne continue pas vers le fournisseur principal/de secours configuré ni vers les fournisseurs détectés automatiquement.

Une valeur par défaut de fournisseur n’entre dans la liste des candidats que lorsque OpenClaw peut réellement authentifier ce fournisseur. Définissez agents.defaults.mediaGenerationAutoProviderFallback: false pour utiliser uniquement les entrées explicites model, primary et fallbacks.

Définissez agents.defaults.imageGenerationModel.timeoutMs pour les backends d’image lents. Un paramètre d’outil timeoutMs par appel remplace la valeur par défaut configurée, et les valeurs par défaut configurées remplacent les valeurs par défaut de fournisseur définies par le Plugin. Les fournisseurs d’images hébergés par Google et OpenRouter utilisent des valeurs par défaut de 180 secondes ; la génération d’images Microsoft Foundry MAI, xAI et Azure OpenAI utilise 600 secondes. Les appels d’outils dynamiques Codex utilisent une valeur par défaut de passerelle image_generate de 120 secondes et respectent le même budget de délai d’expiration lorsqu’il est configuré, borné par le maximum de 600000 ms de la passerelle d’outils dynamiques d’OpenClaw.

Utilisez action: "list" pour inspecter les fournisseurs actuellement enregistrés, leurs modèles par défaut et les indications de variables d’environnement d’authentification.

La génération d’images OpenAI utilise par défaut openai/gpt-image-2. Si un profil OAuth openai est configuré, OpenClaw réutilise le même profil OAuth que celui utilisé par les modèles de chat par abonnement Codex et envoie la requête d’image via le backend Codex Responses. Les anciennes URL de base Codex comme https://chatgpt.com/backend-api sont canonisées en https://chatgpt.com/backend-api/codex pour les requêtes d’image. OpenClaw ne bascule pas silencieusement vers OPENAI_API_KEY pour cette requête - pour forcer un routage direct par l’API OpenAI Images, configurez explicitement models.providers.openai avec une clé d’API, une URL de base personnalisée ou un endpoint Azure.

Les modèles openai/gpt-image-1.5, openai/gpt-image-1 et openai/gpt-image-1-mini peuvent toujours être sélectionnés explicitement. Utilisez gpt-image-1.5 pour une sortie PNG/WebP à arrière-plan transparent ; l’API actuelle gpt-image-2 rejette background: "transparent".

gpt-image-2 prend en charge à la fois la génération texte-vers-image et la modification d’images de référence via le même outil image_generate. OpenClaw transmet prompt, count, size, quality, outputFormat et les images de référence à OpenAI. OpenAI ne reçoit pas directement aspectRatio ni resolution ; lorsque c’est possible, OpenClaw les mappe vers un size pris en charge, sinon l’outil les signale comme remplacements ignorés.

Les options propres à OpenAI se trouvent sous l’objet openai :

{  "quality": "low",  "outputFormat": "jpeg",  "openai": {    "background": "opaque",    "moderation": "low",    "outputCompression": 60,    "user": "end-user-42"  }}

openai.background accepte transparent, opaque ou auto ; les sorties transparentes nécessitent outputFormat png ou webp et un modèle d’image OpenAI compatible avec la transparence. OpenClaw route les requêtes à arrière-plan transparent gpt-image-2 par défaut vers gpt-image-1.5. openai.outputCompression s’applique aux sorties JPEG/WebP et est ignoré pour les sorties PNG.

L’indication de premier niveau background est neutre vis-à-vis du fournisseur et correspond actuellement au même champ de requête OpenAI background lorsque le fournisseur OpenAI est sélectionné. Les fournisseurs qui ne déclarent pas la prise en charge de l’arrière-plan la renvoient dans ignoredOverrides au lieu de recevoir le paramètre non pris en charge.

Pour router la génération d’images OpenAI via un déploiement Azure OpenAI au lieu de api.openai.com, consultez endpoints Azure OpenAI.

La génération d’images Microsoft Foundry utilise les noms de déploiement d’images MAI déployées sous le préfixe de fournisseur microsoft-foundry/. Il n’y a pas de modèle par défaut au niveau du fournisseur, car l’API MAI attend le nom de votre déploiement dans le champ model :

{  agents: {    defaults: {      imageGenerationModel: {        primary: "microsoft-foundry/<deployment-name>",        timeoutMs: 600_000,      },    },  },}

Le fournisseur utilise l’API MAI de Microsoft Foundry, et non l’API OpenAI Images :

• Endpoint de génération : /mai/v1/images/generations
• Endpoint de modification : /mai/v1/images/edits
• Authentification : AZURE_OPENAI_API_KEY / clé d’API du fournisseur, ou Entra ID via az login
• Sortie : une image PNG
• Taille : 1024x1024 par défaut ; la largeur et la hauteur doivent chacune être d’au moins 768 px, et le nombre total de pixels doit être au plus 1 048 576
• Modifications : une image de référence PNG ou JPEG, prise en charge uniquement par les déploiements MAI-Image-2.5-Flash et MAI-Image-2.5

La génération basée uniquement sur un prompt peut utiliser un nom de déploiement personnalisé avec seulement l’endpoint Foundry configuré. Les modifications avec des noms de déploiement personnalisés nécessitent des métadonnées d’intégration/modèle afin qu’OpenClaw puisse vérifier que le déploiement repose sur MAI-Image-2.5-Flash ou MAI-Image-2.5.

Les modèles d’image MAI actuels sont MAI-Image-2.5-Flash, MAI-Image-2.5, MAI-Image-2e et MAI-Image-2. Consultez le Plugin Microsoft Foundry pour la configuration et le comportement des modèles de chat.

La génération d’images OpenRouter utilise la même OPENROUTER_API_KEY et passe par l’API d’image des complétions de chat d’OpenRouter. Sélectionnez les modèles d’image OpenRouter avec le préfixe openrouter/ :

{  agents: {    defaults: {      imageGenerationModel: {        primary: "openrouter/google/gemini-3.1-flash-image-preview",      },    },  },}

OpenClaw transmet prompt, count, les images de référence et les indications aspectRatio / resolution compatibles avec Gemini à OpenRouter. Les raccourcis intégrés actuels de modèles d’image OpenRouter incluent google/gemini-3.1-flash-image-preview, google/gemini-3-pro-image-preview et openai/gpt-5.4-image-2. Utilisez action: "list" pour voir ce que votre Plugin configuré expose.

Les modèles Krea 2 sur fal utilisent le schéma Krea natif de fal au lieu du schéma générique image_size utilisé par Flux. OpenClaw envoie :

• aspect_ratio pour les indications de proportions
• creativity, avec medium par défaut
• image_style_references lorsque image ou images sont fournis

Sélectionnez Krea 2 Medium pour une illustration expressive plus rapide et Krea 2 Large pour des rendus photoréalistes et texturés plus lents et plus détaillés :

{  agents: {    defaults: {      imageGenerationModel: {        primary: "fal/krea/v2/medium/text-to-image",      },    },  },}

Krea 2 renvoie actuellement une image par requête. Préférez aspectRatio pour Krea ; OpenClaw mappe size vers la proportion Krea prise en charge la plus proche et rejette resolution pour Krea au lieu de l’abandonner. Utilisez fal.creativity lorsque vous voulez un niveau de créativité Krea natif :

{  "model": "fal/krea/v2/medium/text-to-image",  "prompt": "A cyber zine portrait with risograph texture",  "aspectRatio": "9:16",  "fal": {    "creativity": "high"  }}

La génération d’images MiniMax est disponible via les deux chemins d’authentification MiniMax groupés :

• minimax/image-01 pour les configurations par clé d’API
• minimax-portal/image-01 pour les configurations OAuth

Le fournisseur xAI groupé utilise /v1/images/generations pour les requêtes basées uniquement sur un prompt et /v1/images/edits lorsque image ou images est présent.

• Modèles : xai/grok-imagine-image, xai/grok-imagine-image-quality
• Nombre : jusqu’à 4
• Références : une image ou jusqu’à cinq images
• Proportions : 1:1, 16:9, 9:16, 4:3, 3:4, 2:3, 3:2
• Résolutions : 1K, 2K
• Sorties : renvoyées comme pièces jointes d’image gérées par OpenClaw

OpenClaw n’expose intentionnellement pas les options natives xAI quality, mask, user ni les proportions supplémentaires uniquement natives tant que ces contrôles n’existent pas dans le contrat partagé inter-fournisseurs image_generate.