Providers
Onwaar
OpenClaw levert een meegeleverde fal-aanbieder voor gehoste generatie van afbeeldingen, video en muziek.
| Eigenschap | Waarde |
|---|---|
| Aanbieder | fal |
| Authenticatie | FAL_KEY (canoniek; FAL_API_KEY werkt ook als terugvaloptie) |
| API | fal-modeleindpunten (https://fal.run; videotaken gebruiken https://queue.fal.run) |
| Basis-URL | Overschrijf met models.providers.fal.baseUrl |
Aan de slag
Set the API key
openclaw onboard --auth-choice fal-api-keyNiet-interactieve configuraties kunnen --fal-api-key <key> doorgeven of FAL_KEY exporteren.
Het configuratieproces stelt ook fal/fal-ai/flux/dev in als het standaardafbeeldingsmodel wanneer
er geen model is geconfigureerd.
Set a default image model
{ agents: { defaults: { imageGenerationModel: { primary: "fal/fal-ai/flux/dev", }, }, },}Afbeeldingen genereren
De meegeleverde fal-aanbieder voor afbeeldingsgeneratie gebruikt standaard
fal/fal-ai/flux/dev.
| Mogelijkheid | Waarde |
|---|---|
| Maximaal aantal afbeeldingen | 4 per aanvraag; Krea 2: 1 per aanvraag |
| Formaatoverschrijvingen | 1024x1024, 1024x1536, 1536x1024, 1024x1792, 1792x1024 |
| Beeldverhouding | Overal ondersteund, behalve bij Flux image-to-image |
| 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 of 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 resultaten, ruwe texturen, filmkorrel en gedetailleerde
vormgeving. Krea gebruikt standaard fal.creativity: "medium"; ondersteunde waarden zijn
raw, low, medium en high.
Krea 2 stelt in het aanvraagschema van fal een beeldverhouding beschikbaar, niet image_size. Gebruik bij voorkeur
aspectRatio; OpenClaw koppelt size aan de dichtstbijzijnde ondersteunde Krea-beeldverhouding
en weigert resolution voor Krea in plaats van deze parameter weg te laten.
Gebruik outputFormat: "png" wanneer je PNG-uitvoer wilt van fal-modellen die
output_format beschikbaar stellen. fal definieert in OpenClaw geen expliciete instelling voor een transparante achtergrond,
dus background: "transparent" wordt voor fal-modellen gemeld als een genegeerde
overschrijving.
Krea 2-eindpunten stellen via fal geen aanvraagveld output_format beschikbaar, 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 genereren
De meegeleverde fal-aanbieder voor videogeneratie gebruikt standaard
fal/fal-ai/minimax/video-01-live.
| Mogelijkheid | Waarde |
|---|---|
| Modi | Tekst-naar-video, één afbeeldingsreferentie, Seedance referentie-naar-video |
| Uitvoering | Wachtrijgestuurde stroom voor indienen/status/resultaat van langlopende taken |
| Time-out | Standaard 20 minuten per taak; status wordt elke 5 seconden opgevraagd |
Available video models
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, een duur van 4–15 seconden en
een audioschakelaar.
Seedance 2.0 config example
{ agents: { defaults: { videoGenerationModel: { primary: "fal/bytedance/seedance-2.0/fast/text-to-video", }, }, },}Seedance 2.0 reference-to-video config example
{ 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 images, videos en audioRefs van video_generate,
met maximaal 12 referentiebestanden in totaal. Audioreferenties vereisen
ten minste één afbeeldings- of videoreferentie in dezelfde aanvraag.
HeyGen video-agent config example
{ agents: { defaults: { videoGenerationModel: { primary: "fal/fal-ai/heygen/v2/video-agent", }, }, },}Muziek genereren
De meegeleverde fal-Plugin registreert ook een aanbieder voor muziekgeneratie voor het
gedeelde hulpmiddel 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 de gegenereerde audio |
fal als standaardaanbieder voor muziek 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 selectie van de aanbieder.
Gedeelde parameters voor het videohulpmiddel en selectie van de aanbieder.
Gedeelde parameters voor het muziekhulpmiddel en selectie van de aanbieder.
Standaardinstellingen voor agents, inclusief selectie van modellen voor afbeeldingen, video en muziek.