Afbeeldingsgeneratie

Een model-override per aanroep probeert alleen die provider/dat model en gaat niet door naar geconfigureerde primaire/fallback-providers of automatisch gedetecteerde providers.

Een providerstandaard komt alleen in de kandidatenlijst wanneer OpenClaw die provider daadwerkelijk kan authenticeren. Stel agents.defaults.mediaGenerationAutoProviderFallback: false in om alleen expliciete items voor model, primary en fallbacks te gebruiken.

Stel agents.defaults.imageGenerationModel.timeoutMs in voor langzame afbeeldingsbackends. Een toolparameter timeoutMs per aanroep overschrijft de geconfigureerde standaardwaarde. Dynamische-toolaanroepen van Codex respecteren hetzelfde time-outbudget, begrensd door het maximum van 600000 ms van de dynamische-toolbridge van OpenClaw.

Gebruik action: "list" om de momenteel geregistreerde providers, hun standaardmodellen en hints voor auth-omgevingsvariabelen te inspecteren.

OpenAI-afbeeldingsgeneratie gebruikt standaard openai/gpt-image-2. Als een OAuth-profiel voor openai-codex is geconfigureerd, hergebruikt OpenClaw hetzelfde OAuth-profiel dat door Codex-abonnementchatmodellen wordt gebruikt en stuurt het de afbeeldingsaanvraag via de Codex Responses-backend. Verouderde Codex-basis-URL's zoals https://chatgpt.com/backend-api worden voor afbeeldingsaanvragen gecanonicaliseerd naar https://chatgpt.com/backend-api/codex. OpenClaw valt voor die aanvraag niet stilzwijgend terug op OPENAI_API_KEY - om directe routering via de OpenAI Images API af te dwingen, configureer je models.providers.openai expliciet met een API-sleutel, aangepaste basis-URL of Azure-eindpunt.

De modellen openai/gpt-image-1.5, openai/gpt-image-1 en openai/gpt-image-1-mini kunnen nog steeds expliciet worden geselecteerd. Gebruik gpt-image-1.5 voor PNG/WebP-uitvoer met transparante achtergrond; de huidige gpt-image-2-API weigert background: "transparent".

gpt-image-2 ondersteunt zowel tekst-naar-afbeeldinggeneratie als bewerking met referentieafbeeldingen via dezelfde tool image_generate. OpenClaw stuurt prompt, count, size, quality, outputFormat en referentieafbeeldingen door naar OpenAI. OpenAI ontvangt aspectRatio of resolution niet rechtstreeks; waar mogelijk zet OpenClaw die om naar een ondersteunde size, anders meldt de tool ze als genegeerde overrides.

OpenAI-specifieke opties staan onder het object openai:

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

openai.background accepteert transparent, opaque of auto; transparante uitvoer vereist outputFormat png of webp en een OpenAI-afbeeldingsmodel dat transparantie ondersteunt. OpenClaw routeert standaard aanvragen met gpt-image-2 voor transparante achtergronden naar gpt-image-1.5. openai.outputCompression is van toepassing op JPEG/WebP-uitvoer.

De toplevel hint background is providerneutraal en wordt momenteel gekoppeld aan hetzelfde OpenAI-aanvraagveld background wanneer de OpenAI-provider is geselecteerd. Providers die geen achtergrondondersteuning declareren, retourneren deze in ignoredOverrides in plaats van de niet-ondersteunde parameter te ontvangen.

Zie Azure OpenAI-eindpunten om OpenAI-afbeeldingsgeneratie via een Azure OpenAI-implementatie te routeren in plaats van via api.openai.com.

OpenRouter-afbeeldingsgeneratie gebruikt dezelfde OPENROUTER_API_KEY en routeert via de chat completions image-API van OpenRouter. Selecteer OpenRouter-afbeeldingsmodellen met het prefix openrouter/:

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

OpenClaw stuurt prompt, count, referentieafbeeldingen en Gemini-compatibele hints voor aspectRatio / resolution door naar OpenRouter. Huidige ingebouwde snelkoppelingen voor OpenRouter-afbeeldingsmodellen omvatten google/gemini-3.1-flash-image-preview, google/gemini-3-pro-image-preview en openai/gpt-5.4-image-2. Gebruik action: "list" om te zien wat je geconfigureerde Plugin aanbiedt.

MiniMax-afbeeldingsgeneratie is beschikbaar via beide gebundelde MiniMax- authenticatiepaden:

• minimax/image-01 voor configuraties met API-sleutel
• minimax-portal/image-01 voor OAuth-configuraties

De gebundelde xAI-provider gebruikt /v1/images/generations voor aanvragen met alleen een prompt en /v1/images/edits wanneer image of images aanwezig is.

• Modellen: xai/grok-imagine-image, xai/grok-imagine-image-pro
• Aantal: maximaal 4
• Referenties: één image of maximaal vijf images
• Beeldverhoudingen: 1:1, 16:9, 9:16, 4:3, 3:4, 2:3, 3:2
• Resoluties: 1K, 2K
• Uitvoer: geretourneerd als door OpenClaw beheerde afbeeldingsbijlagen

OpenClaw stelt xAI-eigen quality, mask, user of extra, alleen native beeldverhoudingen bewust niet beschikbaar totdat die besturingselementen bestaan in het gedeelde cross-providercontract image_generate.