Afbeeldingen genereren

Een model-overschrijving per aanroep probeert alleen die provider/dat model en gaat niet verder met de geconfigureerde primaire provider, fallbackprovider of automatisch gedetecteerde providers.

Een standaardprovider wordt alleen aan de kandidatenlijst toegevoegd wanneer OpenClaw daadwerkelijk bij die provider kan authenticeren. Automatische fallback tussen geauthenticeerde providers is altijd ingeschakeld; een model per aanroep blijft doorslaggevend.

Stel agents.defaults.mediaModels.image.timeoutMs in voor trage backends voor afbeeldingen. Een timeoutMs-toolparameter per aanroep overschrijft de geconfigureerde standaardwaarde, en geconfigureerde standaardwaarden overschrijven de door de Plugin opgegeven standaardwaarden van de provider. Door Google en OpenRouter gehoste afbeeldingsproviders gebruiken standaard 180 seconden; afbeeldingsgeneratie van Microsoft Foundry MAI, xAI en Azure OpenAI gebruikt 600 seconden. Dynamische toolaanroepen van Codex gebruiken standaard een image_generate-brugtime-out van 120 seconden en respecteren hetzelfde geconfigureerde time-outbudget, begrensd door het maximum van 600000 ms voor de dynamische-toolbrug van OpenClaw.

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

Afbeeldingsgeneratie van OpenAI gebruikt standaard openai/gpt-image-2. Als een openai-OAuth-profiel is geconfigureerd, hergebruikt OpenClaw hetzelfde OAuth-profiel dat door Codex-chatmodellen met abonnement wordt gebruikt en stuurt het afbeeldingsverzoek via de Codex Responses-backend. Verouderde Codex-basis-URL's, zoals https://chatgpt.com/backend-api, worden voor afbeeldingsverzoeken gecanonicaliseerd naar https://chatgpt.com/backend-api/codex. OpenClaw valt voor dat verzoek 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-afbeeldinggeneratie als het bewerken van referentieafbeeldingen via dezelfde image_generate-tool. OpenClaw stuurt prompt, count, size, quality, outputFormat en referentieafbeeldingen door naar OpenAI. OpenAI ontvangt aspectRatio en resolution niet rechtstreeks; waar mogelijk zet OpenClaw deze om naar een ondersteunde size, anders meldt de tool ze als genegeerde overschrijvingen.

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 gpt-image-2-verzoeken met een transparante achtergrond naar gpt-image-1.5. openai.outputCompression geldt voor JPEG/WebP-uitvoer en wordt genegeerd voor PNG-uitvoer.

De hint background op het hoogste niveau is providerneutraal en wordt momenteel toegewezen aan hetzelfde OpenAI-verzoekveld background wanneer de OpenAI-provider is geselecteerd. Providers die geen ondersteuning voor achtergronden declareren, retourneren deze in ignoredOverrides in plaats van de niet-ondersteunde parameter te ontvangen.

Als je afbeeldingsgeneratie van OpenAI via een Azure OpenAI-implementatie wilt routeren in plaats van via api.openai.com, raadpleeg je Azure OpenAI-eindpunten.

Afbeeldingsgeneratie van Microsoft Foundry gebruikt de namen van geïmplementeerde MAI-afbeeldingsimplementaties onder het providerprefix microsoft-foundry/. Er is geen standaardmodel op providerniveau, omdat de MAI-API de naam van jouw implementatie verwacht in het veld model:

{  agents: {    defaults: {      imageGenerationModel: {        primary: "microsoft-foundry/<deployment-name>",        timeoutMs: 600_000,      },    },  },}

De provider gebruikt de MAI-API van Microsoft Foundry, niet de OpenAI Images API:

• Generatie-eindpunt: /mai/v1/images/generations
• Bewerkingseindpunt: /mai/v1/images/edits
• Authenticatie: AZURE_OPENAI_API_KEY / API-sleutel van de provider, of Entra ID via az login
• Uitvoer: één PNG-afbeelding
• Grootte: standaard 1024x1024; breedte en hoogte moeten elk minimaal 768 px zijn, en het totale aantal pixels mag maximaal 1.048.576 zijn
• Bewerkingen: één PNG- of JPEG-referentieafbeelding, alleen ondersteund door implementaties van MAI-Image-2.5-Flash en MAI-Image-2.5

Generatie met alleen een prompt kan een aangepaste implementatienaam gebruiken wanneer alleen het Foundry-eindpunt is geconfigureerd. Voor bewerkingen met aangepaste implementatienamen zijn onboarding-/modelmetadata nodig, zodat OpenClaw kan verifiëren dat de implementatie wordt ondersteund door MAI-Image-2.5-Flash of MAI-Image-2.5.

De huidige MAI-afbeeldingsmodellen zijn MAI-Image-2.5-Flash, MAI-Image-2.5, MAI-Image-2e en MAI-Image-2. Zie Microsoft Foundry-Plugin voor configuratie en het gedrag van chatmodellen.

Afbeeldingsgeneratie van OpenRouter gebruikt dezelfde OPENROUTER_API_KEY en wordt gerouteerd via de afbeeldings-API voor chatvoltooiingen 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. De huidige ingebouwde snelkoppelingen voor OpenRouter-afbeeldingsmodellen omvatten google/gemini-3.1-flash-image, google/gemini-3-pro-image en openai/gpt-5.4-image-2. Gebruik action: "list" om te zien wat je geconfigureerde Plugin beschikbaar stelt.

Krea 2-modellen op fal gebruiken het systeemeigen Krea-schema van fal in plaats van het algemene image_size-schema dat Flux gebruikt. OpenClaw verzendt:

• aspect_ratio voor hints voor de beeldverhouding
• creativity, standaard ingesteld op medium
• image_style_references wanneer image of images wordt opgegeven

Selecteer Krea 2 Medium voor snellere, expressieve illustraties en Krea 2 Large voor tragere, gedetailleerdere fotorealistische en gestructureerde resultaten:

{  agents: {    defaults: {      imageGenerationModel: {        primary: "fal/krea/v2/medium/text-to-image",      },    },  },}

Krea 2 retourneert momenteel één afbeelding per verzoek. Geef voor Krea de voorkeur aan aspectRatio; OpenClaw wijst size toe aan de dichtstbijzijnde ondersteunde Krea-beeldverhouding en weigert resolution voor Krea in plaats van deze weg te laten. Gebruik fal.creativity wanneer je een systeemeigen Krea-creativiteitsniveau wilt:

{  "model": "fal/krea/v2/medium/text-to-image",  "prompt": "Een cyberzineportret met risograaftextuur",  "aspectRatio": "9:16",  "fal": {    "creativity": "high"  }}

Afbeeldingsgeneratie van MiniMax is beschikbaar via beide gebundelde authenticatiepaden van MiniMax:

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

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

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

OpenClaw stelt de systeemeigen xAI-opties quality, mask, user en de beeldverhouding auto bewust niet beschikbaar totdat deze besturingselementen deel uitmaken van het gedeelde provideroverschrijdende image_generate-contract.