0xsline/openchatcut

Bildgenerierung

Generiere KI-Bilder über submit_image (nur konfigurierte Anbieter-Schlüssel). Bevorzuge ein klares Standbild pro Anfrage, es sei denn, der Benutzer wünscht Varianten.

Modellauswahl

Modell	Referenz	Stärken	Max. Referenzen
fal + falModel	references/fal.md	Expliziter Fal-Katalog; siehe Tool-Schema für modellspezifische Grenzen	Modellspezifisch
gpt-image-2	references/gpt-image-2.md	Beste Textdarstellung, stärkste Prompt-Treue	16
nano-banana	references/nano-banana.md	Stärkste Referenzbildtreue	14
image-01	references/image-01.md	MiniMax Standbilder / Live-Stil; eine Subjektreferenz via R2	1
grok-imagine	references/grok-imagine.md	xAI Grok Imagine; Text-zu-Bild, ≤4 Ausgaben, 1K/2K	0

• Wenn Fal.ai ausgewählt oder angefordert wird, verwende model: "fal" und das angeforderte falModel oder den gespeicherten Fal-Standard aus den Fähigkeiten. Frage, falls keines ausgewählt ist. Native-Anbieter-Standards und -Steuerungen unten gelten nicht für Fal.
• Standard: gpt-image-2, wenn dieser Schlüssel aktiv ist.
• Referenzlastig → nano-banana.
• Benutzer hat MiniMax genannt / nur MiniMax-Bildschlüssel aktiv → image-01.
• Beachte die Fähigkeiten: Rufe kein Modell auf, dessen Anbieter nicht konfiguriert ist.

WICHTIG: Vor der Generierung die Referenz des gewählten Modells LESEN.

Tool-Parameter

Parameter	Werte	Standard
aspectRatio	1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 4:5, 5:4, 21:9	16:9
imageSize	512px, 1K, 2K, 4K (modellspezifisch)	1K
width / height	GPT Image: 512–3840, /16; MiniMax: 512–2048, /8	—
quality	low, medium, high, auto (nur gpt-image-2)	high
referenceAssetIds	Array von Projekt-Asset-IDs — Backend löst Bytes serverseitig auf	—
name	Kurzer, beschreibender Asset-Name, der in der Bibliothek angezeigt wird	—
count	Anzahl der zu generierenden Bilder (1–10; image-01 max 9)	1
promptOptimizer	Nur MiniMax image-01 — prompt_optimizer	false
seed	Nur MiniMax image-01	—
maskAssetId, background, moderation, inputFidelity	GPT Image Bearbeitungs-/Ausgabesteuerung	—
outputFormat, outputCompression	GPT Image PNG/JPEG/WebP Steuerung	PNG

Standards

• Seitenverhältnis: 16:9. Wenn die Projektkomposition nicht 16:9 ist, FRAGE den Benutzer vor der Generierung, welches Seitenverhältnis er möchte.
• Größe: 1K.

Vor dem Absenden fragen

• Niemals die Größe automatisch hochstufen.
• imageSize: "2K" oder "4K" nur übergeben, wenn der Benutzer explizit danach fragt. Warnen, dass 2K/4K EXPERIMENTELL sind und langsamer sein können.

Referenzbilder

Verwenden, wenn der Benutzer Quellmaterial zum Bearbeiten, Kombinieren oder als visuelle Vorlage bereitstellt (z. B. „Hintergrund ändern“, „diese zu einem Poster zusammenfügen“).

• Projekt-Asset-IDs via referenceAssetIds übergeben. Das Backend ruft sie ab und kodiert sie serverseitig – niemals die Asset-Bytes selbst abrufen.
• Wenn der Benutzer ein Bild-Asset mit @ referenziert, seine ID direkt in referenceAssetIds übergeben.
• Vom Backend akzeptierte Formate: png, jpeg, webp, svg (automatisch zu png gerastert), heic, heif. Maximal 50 MB pro Datei.

Ausführung

// Einfache Generierung
submit_image({
  model: "gpt-image-2",
  prompt: "eine niedliche orange Katze",
  name: "Katze",
});

// Mit Qualität (nur gpt-image-2)
submit_image({
  model: "gpt-image-2",
  prompt: "Heldenposter mit fettem Titel",
  quality: "high",
  name: "Heldenposter",
});

// Mit Referenzbildern — Projekt-Asset-IDs übergeben; Backend löst Bytes auf
submit_image({
  model: "gpt-image-2",
  prompt: "Hintergrund zu Strand ändern",
  referenceAssetIds: ["<assetId>"],
  name: "Strand-Bearbeitung",
});

// Referenzlastig mit nano-banana
submit_image({
  model: "nano-banana",
  prompt: "Composite-Poster",
  referenceAssetIds: ["<id1>", "<id2>"],
  name: "Composite",
});

// Mehrere Bilder
submit_image({
  model: "gpt-image-2",
  prompt: "Produktaufnahmen",
  count: 3,
  name: "Produkt",
});

// MiniMax (optionale einzelne Subjektreferenz; R2 muss für Referenzen konfiguriert sein)
submit_image({
  model: "image-01",
  prompt: „matte Produktflasche auf Marmor, weiches Studiolicht“,
  name: „Flaschen-Standbild“,
  promptOptimizer: false,
});

OpenChatCuts submit_image kann abgeschlossene Pool-Assets je nach Anbieterpfad synchron zurückgeben. Wenn eine jobId zurückgegeben wird, track_progress verwenden; andernfalls die Asset-IDs im Ergebnis als fertig betrachten.

Regeln

• Immer name mit einem kurzen, beschreibenden Asset-Namen angeben.
• Vor dem Absenden dem Benutzer kurz mitteilen, was generiert wird – insbesondere bei mehreren Bildern.
• Nur Modelle aufrufen, deren Anbieter-Schlüssel konfiguriert ist (Fähigkeiten-Abfrage).