Afbeeldingen genereren

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

Een standaardprovider wordt alleen aan de kandidatenlijst toegevoegd als OpenClaw zich daadwerkelijk bij die provider kan authenticeren. Stel agents.defaults.mediaGenerationAutoProviderFallback: false in om uitsluitend expliciete vermeldingen voor model, primary en fallbacks te gebruiken.

Stel agents.defaults.imageGenerationModel.timeoutMs in voor trage backends voor afbeeldingsgeneratie. Een toolparameter timeoutMs per aanroep overschrijft de geconfigureerde standaardwaarde, en geconfigureerde standaardwaarden overschrijven door plugins ingestelde standaardwaarden van providers. Gehoste afbeeldingsproviders van Google en OpenRouter gebruiken standaard 180 seconden; afbeeldingsgeneratie van Microsoft Foundry MAI, xAI en Azure OpenAI gebruikt 600 seconden. Dynamische toolaanroepen van Codex gebruiken voor image_generate standaard een bridge-time-out van 120 seconden en respecteren hetzelfde geconfigureerde time-outbudget, begrensd door het maximum van 600000 ms voor de dynamische-toolbridge van OpenClaw.

Gebruik action: "list" om de momenteel geregistreerde providers, hun standaardmodellen en aanwijzingen voor authenticatie-omgevingsvariabelen te bekijken.

OpenAI-afbeeldingsgeneratie gebruikt standaard openai/gpt-image-2. Als een OAuth-profiel voor openai is geconfigureerd, hergebruikt OpenClaw hetzelfde OAuth-profiel dat wordt gebruikt door Codex-chatmodellen met abonnement en verzendt het afbeeldingsverzoek via de Codex Responses-backend. Verouderde Codex-basis-URL's zoals https://chatgpt.com/backend-api worden voor afbeeldingsverzoeken omgezet naar de canonieke URL 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, configureert u 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 API van gpt-image-2 weigert background: "transparent".

gpt-image-2 ondersteunt zowel tekst-naar-beeldgeneratie als het bewerken van referentieafbeeldingen via dezelfde tool image_generate. 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 voor outputFormat de waarde png of webp en een OpenAI-afbeeldingsmodel dat transparantie ondersteunt. OpenClaw routeert verzoeken met de standaardwaarde gpt-image-2 en een transparante achtergrond naar gpt-image-1.5. openai.outputCompression is van toepassing op JPEG/WebP-uitvoer en wordt genegeerd voor PNG-uitvoer.

De hint background op het hoogste niveau is providerneutraal en wordt momenteel gekoppeld 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.

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

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

{  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:

• Eindpunt voor genereren: /mai/v1/images/generations
• Eindpunt voor bewerken: /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

Voor genereren op basis van alleen een prompt kan een aangepaste implementatienaam worden gebruikt wanneer alleen het Foundry-eindpunt is geconfigureerd. Voor bewerkingen met aangepaste implementatienamen zijn onboarding- of modelmetadata vereist, zodat OpenClaw kan verifiëren dat de implementatie is gebaseerd op 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 de Microsoft Foundry-plugin voor installatie en het gedrag van chatmodellen.

OpenRouter-afbeeldingsgeneratie 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 met Gemini compatibele hints voor aspectRatio / resolution door naar OpenRouter. De 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 uw 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 door Flux wordt 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 beelden en textuurrijke stijlen:

{  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 koppelt size aan de dichtstbijzijnde ondersteunde Krea-beeldverhouding en weigert resolution voor Krea in plaats van deze te negeren. Gebruik fal.creativity wanneer u een systeemeigen Krea-creativiteitsniveau wilt:

{  "model": "fal/krea/v2/medium/text-to-image",  "prompt": "A cyber zine portrait with risograph texture",  "aspectRatio": "9:16",  "fal": {    "creativity": "high"  }}

MiniMax-afbeeldingsgeneratie is beschikbaar via beide meegeleverde authenticatieroutes van MiniMax:

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

De meegeleverde 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.