Afbeeldingen genereren

Een model-overschrijving per aanroep probeert alleen die provider/dat model en gaat niet door naar geconfigureerde primary/fallback- 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 model-, primary- en fallbacks-vermeldingen te gebruiken.

Stel agents.defaults.imageGenerationModel.timeoutMs in voor trage afbeeldings- backends. Een timeoutMs-toolparameter per aanroep overschrijft de geconfigureerde standaard.

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

OpenAI-afbeeldingsgeneratie gebruikt standaard openai/gpt-image-2. Als er een openai-codex OAuth-profiel is geconfigureerd, hergebruikt OpenClaw hetzelfde OAuth-profiel dat door Codex-abonnement-chatmodellen 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 routering rechtstreeks 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-afbeelding-generatie als bewerking met referentieafbeeldingen via dezelfde image_generate-tool. 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 openai-object:

{
  "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 gpt-image-2-aanvragen met transparante achtergrond naar gpt-image-1.5. openai.outputCompression is van toepassing op JPEG-/WebP-uitvoer.

De hint background op topniveau is providerneutraal en wordt momenteel toegewezen 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.

Om OpenAI-afbeeldingsgeneratie via een Azure OpenAI-implementatie te routeren in plaats van via api.openai.com, zie Azure OpenAI-eindpunten.

OpenRouter-afbeeldingsgeneratie gebruikt dezelfde OPENROUTER_API_KEY en routeert via OpenRouters chat completions image API. Selecteer OpenRouter-afbeeldingsmodellen met het voorvoegsel 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 beschikbaar stelt.

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

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

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: tot 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-native quality, mask, user of extra uitsluitend native beeldverhoudingen bewust niet beschikbaar totdat die besturingselementen bestaan in het gedeelde provideroverschrijdende image_generate-contract.