Image generation

A per-call model override tries only that provider/model and does not continue to configured primary/fallback or auto-detected providers.

A provider default only enters the candidate list when OmeniaClaw can actually authenticate that provider. Set agents.defaults.mediaGenerationAutoProviderFallback: false to use only explicit model, primary, and fallbacks entries.

Set agents.defaults.imageGenerationModel.timeoutMs for slow image backends. A per-call timeoutMs tool parameter overrides the configured default, and configured defaults override plugin-authored provider defaults. Google and OpenRouter hosted image providers use 180 second defaults; Microsoft Foundry MAI, xAI, and Azure OpenAI image generation use 600 seconds. Codex dynamic-tool calls use a 120 second image_generate bridge default and honor the same timeout budget when configured, bounded by OmeniaClaw's 600000 ms dynamic-tool bridge maximum.

Use action: "list" to inspect the currently registered providers, their default models, and auth env-var hints.

OpenAI image generation defaults to openai/gpt-image-2. If an openai OAuth profile is configured, OmeniaClaw reuses the same OAuth profile used by Codex subscription chat models and sends the image request through the Codex Responses backend. Legacy Codex base URLs such as https://chatgpt.com/backend-api are canonicalized to https://chatgpt.com/backend-api/codex for image requests. OmeniaClaw does not silently fall back to OPENAI_API_KEY for that request - to force direct OpenAI Images API routing, configure models.providers.openai explicitly with an API key, custom base URL, or Azure endpoint.

The openai/gpt-image-1.5, openai/gpt-image-1, and openai/gpt-image-1-mini models can still be selected explicitly. Use gpt-image-1.5 for transparent-background PNG/WebP output; the current gpt-image-2 API rejects background: "transparent".

gpt-image-2 supports both text-to-image generation and reference-image editing through the same image_generate tool. OmeniaClaw forwards prompt, count, size, quality, outputFormat, and reference images to OpenAI. OpenAI does not receive aspectRatio or resolution directly; when possible OmeniaClaw maps those into a supported size, otherwise the tool reports them as ignored overrides.

OpenAI-specific options live under the openai object:

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

openai.background accepts transparent, opaque, or auto; transparent outputs require outputFormat png or webp and a transparency-capable OpenAI image model. OmeniaClaw routes default gpt-image-2 transparent-background requests to gpt-image-1.5. openai.outputCompression applies to JPEG/WebP outputs and is ignored for PNG outputs.

The top-level background hint is provider-neutral and currently maps to the same OpenAI background request field when the OpenAI provider is selected. Providers that do not declare background support return it in ignoredOverrides instead of receiving the unsupported parameter.

To route OpenAI image generation through an Azure OpenAI deployment instead of api.openai.com, see Azure OpenAI endpoints.

Microsoft Foundry image generation uses deployed MAI image deployment names under the microsoft-foundry/ provider prefix. There is no provider-level default model because the MAI API expects your deployment name in the model field:

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

The provider uses Microsoft Foundry's MAI API, not the OpenAI Images API:

• Generation endpoint: /mai/v1/images/generations
• Edit endpoint: /mai/v1/images/edits
• Auth: AZURE_OPENAI_API_KEY / provider API key, or Entra ID through az login
• Output: one PNG image
• Size: default 1024x1024; width and height must each be at least 768 px, and total pixels must be at most 1,048,576
• Edits: one PNG or JPEG reference image, supported only by MAI-Image-2.5-Flash and MAI-Image-2.5 deployments

Prompt-only generation can use a custom deployment name with just the Foundry endpoint configured. Edits with custom deployment names need onboarding/model metadata so OmeniaClaw can verify that the deployment is backed by MAI-Image-2.5-Flash or MAI-Image-2.5.

Current MAI image models are MAI-Image-2.5-Flash, MAI-Image-2.5, MAI-Image-2e, and MAI-Image-2. See Microsoft Foundry plugin for setup and chat-model behavior.

OpenRouter image generation uses the same OPENROUTER_API_KEY and routes through OpenRouter's chat completions image API. Select OpenRouter image models with the openrouter/ prefix:

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

OmeniaClaw forwards prompt, count, reference images, and Gemini-compatible aspectRatio / resolution hints to OpenRouter. Current built-in OpenRouter image model shortcuts include google/gemini-3.1-flash-image-preview, google/gemini-3-pro-image-preview, and openai/gpt-5.4-image-2. Use action: "list" to see what your configured plugin exposes.

Krea 2 models on fal use fal's native Krea schema instead of the generic image_size schema used by Flux. OmeniaClaw sends:

• aspect_ratio for aspect-ratio hints
• creativity, defaulting to medium
• image_style_references when image or images are supplied

Select Krea 2 Medium for faster expressive illustration and Krea 2 Large for slower, more detailed photoreal and textured looks:

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

Krea 2 currently returns one image per request. Prefer aspectRatio for Krea; OmeniaClaw maps size to the closest supported Krea aspect ratio and rejects resolution for Krea rather than dropping it. Use fal.creativity when you want a native Krea creativity level:

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

MiniMax image generation is available through both bundled MiniMax auth paths:

• minimax/image-01 for API-key setups
• minimax-portal/image-01 for OAuth setups

The bundled xAI provider uses /v1/images/generations for prompt-only requests and /v1/images/edits when image or images is present.

• Models: xai/grok-imagine-image, xai/grok-imagine-image-quality
• Count: up to 4
• References: one image or up to five images
• Aspect ratios: 1:1, 16:9, 9:16, 4:3, 3:4, 2:3, 3:2
• Resolutions: 1K, 2K
• Outputs: returned as OmeniaClaw-managed image attachments

OmeniaClaw intentionally does not expose xAI-native quality, mask, user, or extra native-only aspect ratios until those controls exist in the shared cross-provider image_generate contract.