Providers
Fal
OpenClaw enthält einen gebündelten fal-Provider für die gehostete Bild-, Video- und Musikgenerierung.
| Eigenschaft | Wert |
|---|---|
| Provider | fal |
| Authentifizierung | FAL_KEY (kanonisch; FAL_API_KEY funktioniert auch als Fallback) |
| API | fal-Modellendpunkte (https://fal.run; Videoaufträge verwenden https://queue.fal.run) |
| Basis-URL | Mit models.providers.fal.baseUrl überschreiben |
Erste Schritte
API-Schlüssel festlegen
openclaw onboard --auth-choice fal-api-keyNicht interaktive Einrichtungen können --fal-api-key <key> übergeben oder FAL_KEY exportieren.
Das Onboarding legt außerdem fal/fal-ai/flux/dev als Standardbildmodell fest, wenn
keines konfiguriert ist.
Standardbildmodell festlegen
{ agents: { defaults: { imageGenerationModel: { primary: "fal/fal-ai/flux/dev", }, }, },}Bildgenerierung
Der gebündelte fal-Provider für die Bildgenerierung verwendet standardmäßig
fal/fal-ai/flux/dev.
| Funktion | Wert |
|---|---|
| Maximale Bildanzahl | 4 pro Anfrage; Krea 2: 1 pro Anfrage |
| Größenüberschreibungen | 1024x1024, 1024x1536, 1536x1024, 1024x1792, 1792x1024 |
| Seitenverhältnis | Überall außer bei Flux-Bild-zu-Bild unterstützt |
| Auflösung | 1K, 2K, 4K (modellspezifische Beschränkungen siehe unten) |
| Ausgabeformat | png (Standard) oder jpeg; Krea 2 lehnt outputFormat-Überschreibungen ab |
Bearbeitungsanfragen (Referenzbilder über die gemeinsamen Parameter image / images)
werden an einen modellspezifischen Bearbeitungsendpunkt mit modellspezifischen Referenzlimits weitergeleitet:
| Modellfamilie | Modellreferenz nach fal/ |
Bearbeitungsendpunkt | Maximale Anzahl an Referenzbildern |
|---|---|---|---|
| Flux und andere fal-Modelle | fal-ai/flux/dev (Standard) |
/image-to-image |
1 |
| GPT Image | openai/gpt-image-* |
/edit |
10 |
| Grok Imagine | xai/grok-imagine-image |
/edit |
3 |
| Nano Banana (veraltet) | fal-ai/nano-banana |
/edit |
3 |
| Nano Banana 2 | fal-ai/nano-banana-* |
/edit |
14 |
| Nano Banana 2 Lite | google/nano-banana-2-lite |
/edit |
14 |
| Krea 2 | krea/v2/{medium,large}/text-to-image |
keiner (Stilreferenzen) | 10 Stilreferenzen |
Krea-2-Modelle verwenden das native Krea-Nutzlastschema von fal. OpenClaw sendet
aspect_ratio, creativity und image_style_references anstelle der
generischen image_size- / Bearbeitungsendpunkt-Nutzlast, die von Flux verwendet wird. Die Modellreferenzen lauten:
fal/krea/v2/medium/text-to-imagefal/krea/v2/large/text-to-image
Verwenden Sie Medium für schnellere ausdrucksstarke Illustrationen, Anime, Malerei und künstlerische
Stile. Verwenden Sie Large für langsamere fotorealistische Darstellungen, rohe Texturen, Filmkörnung und detaillierte
Optiken. Krea verwendet standardmäßig fal.creativity: "medium"; unterstützte Werte sind
raw, low, medium und high.
Krea 2 stellt im Anfrageschema von fal das Seitenverhältnis bereit, nicht image_size. Bevorzugen Sie
aspectRatio; OpenClaw ordnet size dem nächstgelegenen unterstützten Krea-Seitenverhältnis zu
und lehnt resolution für Krea ab, anstatt es zu verwerfen.
Verwenden Sie outputFormat: "png", wenn Sie für fal-Modelle, die
output_format bereitstellen, eine PNG-Ausgabe wünschen. fal deklariert in OpenClaw keine explizite Steuerung
für transparente Hintergründe, daher wird background: "transparent" bei fal-Modellen als ignorierte
Überschreibung gemeldet.
Krea-2-Endpunkte stellen über fal kein output_format-Anfragefeld bereit, daher
lehnt OpenClaw outputFormat-Überschreibungen für Krea-Anfragen ab.
So verwenden Sie Krea 2 Medium:
{ agents: { defaults: { imageGenerationModel: { primary: "fal/krea/v2/medium/text-to-image", }, }, },}Videogenerierung
Der gebündelte fal-Provider für die Videogenerierung verwendet standardmäßig
fal/fal-ai/minimax/video-01-live.
| Funktion | Wert |
|---|---|
| Modi | Text-zu-Video, Einzelbildreferenz, Seedance-Referenz-zu-Video |
| Laufzeit | Warteschlangengestützter Übermittlungs-/Status-/Ergebnisablauf für lang laufende Aufträge |
| Zeitüberschreitung | Standardmäßig 20 Minuten pro Auftrag; Statusabfrage alle 5 Sekunden |
Verfügbare Videomodelle
MiniMax (Standard):
fal/fal-ai/minimax/video-01-live
HeyGen-Video-Agent:
fal/fal-ai/heygen/v2/video-agent
Kling und Wan:
fal/fal-ai/kling-video/v2.1/master/text-to-videofal/fal-ai/wan/v2.2-a14b/text-to-videofal/fal-ai/wan/v2.2-a14b/image-to-video
Seedance 2.0:
fal/bytedance/seedance-2.0/fast/text-to-videofal/bytedance/seedance-2.0/fast/image-to-videofal/bytedance/seedance-2.0/fast/reference-to-videofal/bytedance/seedance-2.0/text-to-videofal/bytedance/seedance-2.0/image-to-videofal/bytedance/seedance-2.0/reference-to-video
MiniMax-Live- und HeyGen-Anfragen senden nur den Prompt sowie ein optionales
einzelnes Referenzbild; andere Überschreibungen werden nicht weitergeleitet. Seedance-Modelle
akzeptieren aspectRatio, size, resolution, Dauern von 4–15 Sekunden und
eine Audio-Umschaltoption.
Konfigurationsbeispiel für Seedance 2.0
{ agents: { defaults: { videoGenerationModel: { primary: "fal/bytedance/seedance-2.0/fast/text-to-video", }, }, },}Konfigurationsbeispiel für Seedance 2.0 Referenz-zu-Video
{ agents: { defaults: { videoGenerationModel: { primary: "fal/bytedance/seedance-2.0/fast/reference-to-video", }, }, },}Referenz-zu-Video akzeptiert bis zu 9 Bilder, 3 Videos und 3 Audioreferenzen
über die gemeinsamen Parameter video_generate images, videos und audioRefs,
wobei insgesamt höchstens 12 Referenzdateien zulässig sind. Audioreferenzen erfordern
mindestens eine Bild- oder Videoreferenz in derselben Anfrage.
Konfigurationsbeispiel für den HeyGen-Video-Agent
{ agents: { defaults: { videoGenerationModel: { primary: "fal/fal-ai/heygen/v2/video-agent", }, }, },}Musikgenerierung
Das gebündelte fal-Plugin registriert außerdem einen Provider für die Musikgenerierung für das
gemeinsame music_generate-Tool.
| Funktion | Wert |
|---|---|
| Standardmodell | fal/fal-ai/minimax-music/v2.6 |
| Modelle | fal-ai/minimax-music/v2.6 (mp3), fal-ai/ace-step/prompt-to-audio (wav), fal-ai/stable-audio-25/text-to-audio (wav) |
| Maximale Dauer | 240 Sekunden |
| Laufzeit | Synchrone Anfrage mit anschließendem Download der generierten Audiodatei |
Verwenden Sie fal als Standard-Provider für Musik:
{ agents: { defaults: { musicGenerationModel: { primary: "fal/fal-ai/minimax-music/v2.6", }, }, },}fal-ai/minimax-music/v2.6 unterstützt explizite Liedtexte und einen Instrumentalmodus,
jedoch nicht beides in derselben Anfrage. ACE-Step und Stable Audio sind
Prompt-zu-Audio-Endpunkte; wählen Sie sie mit der model-Überschreibung aus, wenn Sie
diese Modellfamilien verwenden möchten. ACE-Step lehnt explizite Liedtexte ab; Stable Audio lehnt
sowohl Liedtexte als auch den Instrumentalmodus ab.
Verwandte Themen
Gemeinsame Parameter des Bild-Tools und Provider-Auswahl.
Gemeinsame Parameter des Video-Tools und Provider-Auswahl.
Gemeinsame Parameter des Musik-Tools und Provider-Auswahl.
Agent-Standardeinstellungen einschließlich der Auswahl von Bild-, Video- und Musikmodellen.