Bildgenerierung

Eine model-Überschreibung pro Aufruf versucht nur diesen Provider/dieses Modell und fährt nicht mit konfigurierten Primary-/Fallback- oder automatisch erkannten Providern fort.

Ein Provider-Standard wird nur dann in die Kandidatenliste aufgenommen, wenn OpenClaw diesen Provider tatsächlich authentifizieren kann. Setzen Sie agents.defaults.mediaGenerationAutoProviderFallback: false, um nur explizite Einträge für model, primary und fallbacks zu verwenden.

Setzen Sie agents.defaults.imageGenerationModel.timeoutMs für langsame Bild- Backends. Ein Tool-Parameter timeoutMs pro Aufruf überschreibt den konfigurierten Standard, und konfigurierte Standards überschreiben von Plugins definierte Provider- Standards. Von Google und OpenRouter gehostete Bild-Provider verwenden Standards von 180 Sekunden; Microsoft Foundry MAI, xAI und Azure OpenAI-Bildgenerierung verwenden 600 Sekunden. Codex-Dynamic-Tool-Aufrufe verwenden einen 120-Sekunden-Standard für die image_generate-Bridge und respektieren bei Konfiguration dasselbe Timeout-Budget, begrenzt durch das Dynamic-Tool-Bridge-Maximum von OpenClaw von 600000 ms.

Verwenden Sie action: "list", um die aktuell registrierten Provider, ihre Standardmodelle und Hinweise zu Auth-Env-Vars zu prüfen.

OpenAI-Bildgenerierung verwendet standardmäßig openai/gpt-image-2. Wenn ein openai-OAuth-Profil konfiguriert ist, verwendet OpenClaw dasselbe OAuth-Profil erneut, das von Codex-Abonnement-Chatmodellen verwendet wird, und sendet die Bildanfrage über das Codex Responses-Backend. Legacy-Codex-Basis- URLs wie https://chatgpt.com/backend-api werden für Bildanfragen zu https://chatgpt.com/backend-api/codex kanonisiert. OpenClaw fällt für diese Anfrage nicht stillschweigend auf OPENAI_API_KEY zurück - um direktes Routing über die OpenAI Images API zu erzwingen, konfigurieren Sie models.providers.openai explizit mit einem API-Schlüssel, einer benutzerdefinierten Basis-URL oder einem Azure-Endpunkt.

Die Modelle openai/gpt-image-1.5, openai/gpt-image-1 und openai/gpt-image-1-mini können weiterhin explizit ausgewählt werden. Verwenden Sie gpt-image-1.5 für PNG/WebP-Ausgabe mit transparentem Hintergrund; die aktuelle gpt-image-2-API lehnt background: "transparent" ab.

gpt-image-2 unterstützt sowohl Text-zu-Bild-Generierung als auch Bearbeitung von Referenzbildern über dasselbe Tool image_generate. OpenClaw leitet prompt, count, size, quality, outputFormat und Referenzbilder an OpenAI weiter. OpenAI erhält nicht aspectRatio oder resolution direkt; wenn möglich, ordnet OpenClaw diese einer unterstützten size zu, andernfalls meldet das Tool sie als ignorierte Überschreibungen.

OpenAI-spezifische Optionen liegen im Objekt openai:

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

openai.background akzeptiert transparent, opaque oder auto; transparente Ausgaben erfordern outputFormat png oder webp und ein transparenzfähiges OpenAI-Bildmodell. OpenClaw routet standardmäßige gpt-image-2-Anfragen mit transparentem Hintergrund an gpt-image-1.5. openai.outputCompression gilt für JPEG/WebP-Ausgaben und wird für PNG-Ausgaben ignoriert.

Der Top-Level-Hinweis background ist Provider-neutral und wird derzeit demselben OpenAI-Anfragefeld background zugeordnet, wenn der OpenAI-Provider ausgewählt ist. Provider, die keine Hintergrundunterstützung deklarieren, geben ihn in ignoredOverrides zurück, statt den nicht unterstützten Parameter zu erhalten.

Um OpenAI-Bildgenerierung über eine Azure OpenAI-Bereitstellung statt über api.openai.com zu routen, siehe Azure OpenAI-Endpunkte.

Microsoft Foundry-Bildgenerierung verwendet bereitgestellte MAI-Bildbereitstellungsnamen unter dem Provider-Präfix microsoft-foundry/. Es gibt kein Provider-weites Standardmodell, weil die MAI-API Ihren Bereitstellungsnamen im Feld model erwartet:

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

Der Provider verwendet Microsoft Foundrys MAI-API, nicht die OpenAI Images API:

• Generierungsendpunkt: /mai/v1/images/generations
• Bearbeitungsendpunkt: /mai/v1/images/edits
• Auth: AZURE_OPENAI_API_KEY / Provider-API-Schlüssel oder Entra ID über az login
• Ausgabe: ein PNG-Bild
• Größe: Standard 1024x1024; Breite und Höhe müssen jeweils mindestens 768 px betragen, und die Gesamtpixelzahl darf höchstens 1.048.576 betragen
• Bearbeitungen: ein PNG- oder JPEG-Referenzbild, unterstützt nur von MAI-Image-2.5-Flash- und MAI-Image-2.5-Bereitstellungen

Prompt-only-Generierung kann einen benutzerdefinierten Bereitstellungsnamen verwenden, wenn nur der Foundry-Endpunkt konfiguriert ist. Bearbeitungen mit benutzerdefinierten Bereitstellungsnamen benötigen Onboarding-/Modellmetadaten, damit OpenClaw überprüfen kann, dass die Bereitstellung auf MAI-Image-2.5-Flash oder MAI-Image-2.5 basiert.

Aktuelle MAI-Bildmodelle sind MAI-Image-2.5-Flash, MAI-Image-2.5, MAI-Image-2e und MAI-Image-2. Siehe Microsoft Foundry-Plugin für Einrichtung und Chatmodellverhalten.

OpenRouter-Bildgenerierung verwendet denselben OPENROUTER_API_KEY und routet über OpenRouters Chat-Completions-Bild-API. Wählen Sie OpenRouter-Bildmodelle mit dem Präfix openrouter/ aus:

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

OpenClaw leitet prompt, count, Referenzbilder und Gemini-kompatible Hinweise für aspectRatio / resolution an OpenRouter weiter. Aktuelle integrierte OpenRouter-Bildmodell-Kurzbefehle umfassen google/gemini-3.1-flash-image-preview, google/gemini-3-pro-image-preview und openai/gpt-5.4-image-2. Verwenden Sie action: "list", um zu sehen, was Ihr konfiguriertes Plugin bereitstellt.

Krea 2-Modelle auf fal verwenden fals natives Krea-Schema statt des generischen image_size-Schemas, das von Flux verwendet wird. OpenClaw sendet:

• aspect_ratio für Hinweise zum Seitenverhältnis
• creativity, standardmäßig medium
• image_style_references, wenn image oder images bereitgestellt werden

Wählen Sie Krea 2 Medium für schnellere ausdrucksstarke Illustration und Krea 2 Large für langsamere, detailliertere fotorealistische und texturierte Looks:

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

Krea 2 gibt derzeit ein Bild pro Anfrage zurück. Bevorzugen Sie aspectRatio für Krea; OpenClaw ordnet size dem nächstgelegenen unterstützten Krea-Seitenverhältnis zu und lehnt resolution für Krea ab, statt es zu verwerfen. Verwenden Sie fal.creativity, wenn Sie eine native Krea-Kreativitätsstufe wünschen:

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

MiniMax-Bildgenerierung ist über beide gebündelten MiniMax- Auth-Pfade verfügbar:

• minimax/image-01 für API-Schlüssel-Setups
• minimax-portal/image-01 für OAuth-Setups

Der gebündelte xAI-Provider verwendet /v1/images/generations für Prompt-only- Anfragen und /v1/images/edits, wenn image oder images vorhanden ist.

• Modelle: xai/grok-imagine-image, xai/grok-imagine-image-quality
• Anzahl: bis zu 4
• Referenzen: ein image oder bis zu fünf images
• Seitenverhältnisse: 1:1, 16:9, 9:16, 4:3, 3:4, 2:3, 3:2
• Auflösungen: 1K, 2K
• Ausgaben: werden als von OpenClaw verwaltete Bildanhänge zurückgegeben

OpenClaw stellt xAI-native quality, mask, user oder zusätzliche nur native Seitenverhältnisse absichtlich nicht bereit, bis diese Steuerungen im gemeinsamen Provider-übergreifenden Vertrag image_generate existieren.