Providers
Fal
OpenClaw wordt geleverd met een ingebouwde fal-provider voor gehoste generatie van afbeeldingen, video's en muziek.
| Eigenschap | Waarde |
|---|---|
| Provider | fal |
| Authenticatie | FAL_KEY (canoniek; FAL_API_KEY werkt ook als fallback) |
| API | fal-modeleindpunten (https://fal.run; videotaken gebruiken https://queue.fal.run) |
| Basis-URL | Overschrijven met models.providers.fal.baseUrl |
Aan de slag
Stel de API-sleutel in
openclaw onboard --auth-choice fal-api-keyNiet-interactieve configuraties kunnen --fal-api-key <key> doorgeven of FAL_KEY exporteren.
Tijdens de onboarding wordt ook fal/fal-ai/flux/dev ingesteld als het standaard afbeeldingsmodel wanneer
er geen model is geconfigureerd.
Stel een standaard afbeeldingsmodel in
{ agents: { defaults: { imageGenerationModel: { primary: "fal/fal-ai/flux/dev", }, }, },}Afbeeldingen genereren
De ingebouwde fal-provider voor afbeeldingsgeneratie gebruikt standaard
fal/fal-ai/flux/dev.
| Mogelijkheid | Waarde |
|---|---|
| Maximaal aantal afbeeldingen | 4 per aanvraag; Krea 2: 1 per aanvraag |
| Overschrijvingen van grootte | 1024x1024, 1024x1536, 1536x1024, 1024x1792, 1792x1024 |
| Beeldverhouding | Overal ondersteund, behalve bij afbeelding-naar-afbeelding van Flux |
| Resolutie | 1K, 2K, 4K (modelspecifieke limieten hieronder) |
| Uitvoerindeling | png (standaard) of jpeg; Krea 2 weigert overschrijvingen van outputFormat |
Bewerkingsaanvragen (referentieafbeeldingen via de gedeelde parameters image / images)
worden doorgestuurd naar een modelspecifiek bewerkingseindpunt met modelspecifieke referentielimieten:
| Modelfamilie | Modelreferentie na fal/ |
Bewerkingseindpunt | Maximaal aantal referentieafbeeldingen |
|---|---|---|---|
| Flux en andere fal-modellen | fal-ai/flux/dev (standaard) |
/image-to-image |
1 |
| GPT Image | openai/gpt-image-* |
/edit |
10 |
| Grok Imagine | xai/grok-imagine-image |
/edit |
3 |
| Nano Banana (verouderd) | 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 |
geen (stijlreferenties) | 10 stijlreferenties |
Krea 2-modellen gebruiken het systeemeigen Krea-payloadschema van fal. OpenClaw verzendt
aspect_ratio, creativity en image_style_references in plaats van de
algemene image_size-payload/payload voor het bewerkingseindpunt die Flux gebruikt. De modelreferenties zijn:
fal/krea/v2/medium/text-to-imagefal/krea/v2/large/text-to-image
Gebruik Medium voor snellere expressieve illustraties, anime, schilderijen en artistieke
stijlen. Gebruik Large voor tragere fotorealistische beelden, ruwe texturen, filmkorrel en gedetailleerde
weergaven. Krea gebruikt standaard fal.creativity: "medium"; ondersteunde waarden zijn
raw, low, medium en high.
Krea 2 biedt in het aanvraagschema van fal de beeldverhouding aan, niet image_size. Geef de voorkeur aan
aspectRatio; OpenClaw koppelt size aan de dichtstbijzijnde ondersteunde Krea-beeldverhouding
en weigert resolution voor Krea in plaats van deze te negeren.
Gebruik outputFormat: "png" wanneer je PNG-uitvoer wilt van fal-modellen die
output_format aanbieden. fal declareert in OpenClaw geen expliciete instelling voor een transparante achtergrond,
dus background: "transparent" wordt voor fal-modellen gerapporteerd als een genegeerde
overschrijving.
Krea 2-eindpunten bieden via fal geen aanvraagveld output_format aan, dus
OpenClaw weigert overschrijvingen van outputFormat voor Krea-aanvragen.
Krea 2 Medium gebruiken:
{ agents: { defaults: { imageGenerationModel: { primary: "fal/krea/v2/medium/text-to-image", }, }, },}Video's genereren
De ingebouwde fal-provider voor videogeneratie gebruikt standaard
fal/fal-ai/minimax/video-01-live.
| Mogelijkheid | Waarde |
|---|---|
| Modi | Tekst-naar-video, verwijzing naar één afbeelding, Seedance-referentie-naar-video |
| Uitvoering | Door een wachtrij ondersteunde stroom voor indienen/status/resultaat voor langdurige taken |
| Time-out | Standaard 20 minuten per taak; status wordt elke 5 seconden opgevraagd |
Beschikbare videomodellen
MiniMax (standaard):
fal/fal-ai/minimax/video-01-live
HeyGen-videoagent:
fal/fal-ai/heygen/v2/video-agent
Kling en 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- en HeyGen-aanvragen verzenden alleen de prompt plus een optionele
enkele referentieafbeelding; andere overschrijvingen worden niet doorgestuurd. Seedance-modellen
accepteren aspectRatio, size, resolution, tijdsduren van 4-15 seconden en
een audioschakelaar.
Configuratievoorbeeld voor Seedance 2.0
{ agents: { defaults: { videoGenerationModel: { primary: "fal/bytedance/seedance-2.0/fast/text-to-video", }, }, },}Configuratievoorbeeld voor referentie-naar-video met Seedance 2.0
{ agents: { defaults: { videoGenerationModel: { primary: "fal/bytedance/seedance-2.0/fast/reference-to-video", }, }, },}Referentie-naar-video accepteert maximaal 9 afbeeldingen, 3 video's en 3 audioreferenties
via de gedeelde parameters video_generate images, videos en audioRefs,
met maximaal 12 referentiebestanden in totaal. Audioreferenties vereisen
minstens één afbeeldings- of videoreferentie in dezelfde aanvraag.
Configuratievoorbeeld voor HeyGen-videoagent
{ agents: { defaults: { videoGenerationModel: { primary: "fal/fal-ai/heygen/v2/video-agent", }, }, },}Muziek genereren
De ingebouwde fal-plugin registreert ook een provider voor muziekgeneratie voor de
gedeelde tool music_generate.
| Mogelijkheid | Waarde |
|---|---|
| Standaardmodel | fal/fal-ai/minimax-music/v2.6 |
| Modellen | 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 duur | 240 seconden |
| Uitvoering | Synchrone aanvraag plus download van gegenereerde audio |
fal als standaard muziekprovider gebruiken:
{ agents: { defaults: { musicGenerationModel: { primary: "fal/fal-ai/minimax-music/v2.6", }, }, },}fal-ai/minimax-music/v2.6 ondersteunt expliciete songteksten en een instrumentale modus,
maar niet beide in dezelfde aanvraag. ACE-Step en Stable Audio zijn
prompt-naar-audio-eindpunten; selecteer ze met de overschrijving model wanneer je
die modelfamilies wilt gebruiken. ACE-Step weigert expliciete songteksten; Stable Audio weigert
zowel songteksten als de instrumentale modus.
Gerelateerd
Gedeelde parameters voor het afbeeldingshulpmiddel en providerselectie.
Gedeelde parameters voor het videohulpmiddel en providerselectie.
Gedeelde parameters voor het muziekhulpmiddel en providerselectie.
Agentstandaarden, waaronder de selectie van afbeeldings-, video- en muziekmodellen.