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 ebenfalls 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 Grenzen 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 Referenzgrenzen weitergeleitet:
| Modellfamilie | Modellreferenz nach fal/ |
Bearbeitungsendpunkt | Maximale Referenzbilder |
|---|---|---|---|
| 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-Nutzdatenschema von fal. OpenClaw
sendet aspect_ratio, creativity und image_style_references anstelle des
generischen image_size- bzw. Bearbeitungsendpunkt-Nutzdatenformats, das Flux
verwendet. 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,
Gemälde 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 und nicht
image_size bereit. 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 eine PNG-Ausgabe von fal-Modellen
wünschen, die output_format bereitstellen. 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 Ablauf für Übermittlung, Status und Ergebnis bei lang laufenden Aufträgen |
| 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 und optional ein
einzelnes Referenzbild; andere Überschreibungen werden nicht
weitergeleitet. Seedance-Modelle akzeptieren aspectRatio, size,
resolution, Dauern von 4-15 Sekunden und einen Audio-Umschalter.
Seedance-2.0-Konfigurationsbeispiel
{ agents: { defaults: { videoGenerationModel: { primary: "fal/bytedance/seedance-2.0/fast/text-to-video", }, }, },}Seedance-2.0-Konfigurationsbeispiel für Referenz-zu-Video
{ agents: { defaults: { videoGenerationModel: { primary: "fal/bytedance/seedance-2.0/fast/reference-to-video", }, }, },}Referenz-zu-Video akzeptiert über die gemeinsamen video_generate-Parameter
images, videos und audioRefs bis zu 9 Bilder, 3 Videos und 3
Audioreferenzen, mit insgesamt höchstens 12 Referenzdateien.
Audioreferenzen erfordern in derselben Anfrage mindestens eine Bild- oder
Videoreferenz.
HeyGen-Video-Agent-Konfigurationsbeispiel
{ 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 Werkzeug music_generate.
| 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 des generierten Audios |
So 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 Bildwerkzeugs und Provider-Auswahl.
Gemeinsame Parameter des Videowerkzeugs und Provider-Auswahl.
Gemeinsame Parameter des Musikwerkzeugs und Provider-Auswahl.
Agent-Standardeinstellungen einschließlich der Auswahl von Bild-, Video- und Musikmodellen.