Generazione di immagini

Un override model per chiamata prova solo quel provider/modello e non continua con il provider primario/di fallback configurato o con i provider rilevati automaticamente.

Un provider predefinito entra nell'elenco dei candidati solo quando OpenClaw può effettivamente autenticare quel provider. Imposta agents.defaults.mediaGenerationAutoProviderFallback: false per usare solo voci esplicite model, primary e fallbacks.

Imposta agents.defaults.imageGenerationModel.timeoutMs per backend immagine lenti. Un parametro dello strumento timeoutMs per chiamata sovrascrive il valore predefinito configurato.

Usa action: "list" per ispezionare i provider attualmente registrati, i loro modelli predefiniti e i suggerimenti sulle variabili env di autenticazione.

La generazione di immagini OpenAI usa per impostazione predefinita openai/gpt-image-2. Se è configurato un profilo OAuth openai-codex, OpenClaw riutilizza lo stesso profilo OAuth usato dai modelli di chat con abbonamento Codex e invia la richiesta di immagine tramite il backend Codex Responses. Gli URL di base Codex legacy come https://chatgpt.com/backend-api vengono canonicalizzati in https://chatgpt.com/backend-api/codex per le richieste di immagini. OpenClaw non ripiega silenziosamente su OPENAI_API_KEY per quella richiesta - per forzare l'instradamento diretto tramite OpenAI Images API, configura models.providers.openai esplicitamente con una chiave API, un URL di base personalizzato o un endpoint Azure.

I modelli openai/gpt-image-1.5, openai/gpt-image-1 e openai/gpt-image-1-mini possono ancora essere selezionati esplicitamente. Usa gpt-image-1.5 per output PNG/WebP con sfondo trasparente; l'attuale API gpt-image-2 rifiuta background: "transparent".

gpt-image-2 supporta sia la generazione text-to-image sia la modifica con immagini di riferimento tramite lo stesso strumento image_generate. OpenClaw inoltra prompt, count, size, quality, outputFormat e le immagini di riferimento a OpenAI. OpenAI non riceve aspectRatio o resolution direttamente; quando possibile OpenClaw mappa questi valori in un size supportato, altrimenti lo strumento li segnala come override ignorati.

Le opzioni specifiche di OpenAI si trovano sotto l'oggetto openai:

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

openai.background accetta transparent, opaque o auto; gli output trasparenti richiedono outputFormat png o webp e un modello di immagini OpenAI capace di trasparenza. OpenClaw instrada le richieste predefinite gpt-image-2 con sfondo trasparente a gpt-image-1.5. openai.outputCompression si applica agli output JPEG/WebP.

L'indicazione di primo livello background è neutrale rispetto al provider e attualmente viene mappata allo stesso campo di richiesta OpenAI background quando è selezionato il provider OpenAI. I provider che non dichiarano il supporto dello sfondo la restituiscono in ignoredOverrides invece di ricevere il parametro non supportato.

Per instradare la generazione di immagini OpenAI tramite una distribuzione Azure OpenAI invece di api.openai.com, consulta Endpoint Azure OpenAI.

La generazione di immagini OpenRouter usa la stessa OPENROUTER_API_KEY e viene instradata tramite l'API immagini delle chat completions di OpenRouter. Seleziona i modelli di immagine OpenRouter con il prefisso openrouter/:

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

OpenClaw inoltra prompt, count, immagini di riferimento e indicazioni aspectRatio / resolution compatibili con Gemini a OpenRouter. Le scorciatoie attuali integrate per i modelli di immagine OpenRouter includono google/gemini-3.1-flash-image-preview, google/gemini-3-pro-image-preview e openai/gpt-5.4-image-2. Usa action: "list" per vedere cosa espone il Plugin configurato.

La generazione di immagini MiniMax è disponibile tramite entrambi i percorsi di autenticazione MiniMax inclusi:

• minimax/image-01 per configurazioni con chiave API
• minimax-portal/image-01 per configurazioni OAuth

Il provider xAI incluso usa /v1/images/generations per le richieste con solo prompt e /v1/images/edits quando è presente image o images.

• Modelli: xai/grok-imagine-image, xai/grok-imagine-image-pro
• Conteggio: fino a 4
• Riferimenti: una image o fino a cinque images
• Proporzioni: 1:1, 16:9, 9:16, 4:3, 3:4, 2:3, 3:2
• Risoluzioni: 1K, 2K
• Output: restituiti come allegati immagine gestiti da OpenClaw

OpenClaw non espone intenzionalmente quality, mask, user nativi xAI, né proporzioni aggiuntive solo native, finché questi controlli non esistono nel contratto condiviso tra provider image_generate.