Génération d’images

Un remplacement model par appel essaie uniquement ce fournisseur/modèle et ne poursuit pas vers les fournisseurs primary/fallback configurés ou détectés automatiquement.

Une valeur par défaut de fournisseur n’entre dans la liste des candidats que lorsqu’OpenClaw peut effectivement 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’images lents. Un paramètre d’outil timeoutMs par appel remplace la valeur par défaut configurée. Les appels d’outils dynamiques Codex respectent le même budget de délai d’expiration, limité par le maximum de 600000 ms du pont 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 openai/gpt-image-2 par défaut. Si un profil OAuth openai-codex est configuré, OpenClaw réutilise le même profil OAuth utilisé par les modèles de chat avec 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 se rabat pas silencieusement sur OPENAI_API_KEY pour cette requête - pour forcer un routage direct vers 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 gpt-image-2 actuelle rejette background: "transparent".

gpt-image-2 prend en charge à la fois la génération texte-vers-image et la modification avec image 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 une size prise 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 un outputFormat png ou webp et un modèle d'image OpenAI compatible avec la transparence. OpenClaw route les requêtes par défaut gpt-image-2 à arrière-plan transparent vers gpt-image-1.5. openai.outputCompression s'applique aux sorties JPEG/WebP.

L'indice de premier niveau background est indépendant du fournisseur et se mappe actuellement vers le 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 des arrière-plans le 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 OpenRouter utilise la même OPENROUTER_API_KEY et passe par l'API d'images 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, ainsi que les indices aspectRatio / resolution compatibles 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 qu'expose votre plugin configuré.

La génération d'images MiniMax est disponible via les deux chemins d'authentification MiniMax intégrés :

• minimax/image-01 pour les configurations avec clé d'API
• minimax-portal/image-01 pour les configurations OAuth

Le fournisseur xAI intégré utilise /v1/images/generations pour les requêtes avec prompt uniquement et /v1/images/edits lorsque image ou images est présent.

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

OpenClaw n'expose volontairement pas les options natives xAI quality, mask, user ni les formats d'image supplémentaires propres à xAI tant que ces contrôles n'existent pas dans le contrat partagé inter-fournisseurs image_generate.