Génération d’images

Un remplacement model par appel essaie uniquement ce fournisseur/modèle et ne poursuit pas vers le fournisseur principal/de repli 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.

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-codex est configuré, OpenClaw réutilise le même profil OAuth que celui 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 le routage direct via l’API OpenAI Images, configurez explicitement models.providers.openai avec une clé d’API, une URL de base personnalisée ou un point de terminaison 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 avec 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 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 ; quand c’est possible, OpenClaw les mappe vers une size prise en charge, sinon l’outil les signale comme des 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 avec arrière-plan transparent vers gpt-image-1.5. openai.outputCompression s’applique aux sorties JPEG/WebP.

L’indication de premier niveau background est neutre vis-à-vis du fournisseur et correspond actuellement au même champ de requête OpenAI background quand 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 les points de terminaison 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 et les indications aspectRatio / resolution compatibles Gemini à OpenRouter. Les raccourcis intégrés actuels pour les 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.

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

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

Le fournisseur xAI inclus utilise /v1/images/generations pour les requêtes avec prompt seul et /v1/images/edits quand 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 comme pièces jointes d’image gérées par OpenClaw

OpenClaw n’expose volontairement pas quality, mask, user natifs de xAI ni les formats d’image supplémentaires propres à xAI tant que ces contrôles n’existent pas dans le contrat image_generate partagé entre fournisseurs.