Providers
Fal
OpenClaw include un provider fal integrato per la generazione in hosting di
immagini, video e musica.
| Proprietà | Valore |
|---|---|
| Provider | fal |
| Autenticazione | FAL_KEY (canonica; anche FAL_API_KEY funziona come ripiego) |
| API | Endpoint dei modelli fal (https://fal.run; i processi video usano https://queue.fal.run) |
| URL di base | Sovrascrivibile con models.providers.fal.baseUrl |
Per iniziare
Impostare la chiave API
openclaw onboard --auth-choice fal-api-keyLe configurazioni non interattive possono passare --fal-api-key <key> o esportare FAL_KEY.
L'onboarding imposta inoltre fal/fal-ai/flux/dev come modello di immagini predefinito quando
non ne è configurato alcuno.
Impostare un modello di immagini predefinito
{ agents: { defaults: { imageGenerationModel: { primary: "fal/fal-ai/flux/dev", }, }, },}Generazione di immagini
Il provider integrato fal per la generazione di immagini usa come valore predefinito
fal/fal-ai/flux/dev.
| Funzionalità | Valore |
|---|---|
| Numero massimo di immagini | 4 per richiesta; Krea 2: 1 per richiesta |
| Sostituzioni delle dimensioni | 1024x1024, 1024x1536, 1536x1024, 1024x1792, 1792x1024 |
| Proporzioni | Supportate ovunque tranne che per la conversione da immagine a immagine di Flux |
| Risoluzione | 1K, 2K, 4K (limiti per modello riportati di seguito) |
| Formato di output | png (predefinito) o jpeg; Krea 2 rifiuta le sostituzioni di outputFormat |
Le richieste di modifica (immagini di riferimento tramite i parametri condivisi image / images)
vengono instradate a un endpoint di modifica specifico per modello, con limiti di riferimenti specifici per modello:
| Famiglia di modelli | Riferimento del modello dopo fal/ |
Endpoint di modifica | Numero massimo di immagini di riferimento |
|---|---|---|---|
| Flux e altri modelli fal | fal-ai/flux/dev (predefinito) |
/image-to-image |
1 |
| GPT Image | openai/gpt-image-* |
/edit |
10 |
| Grok Imagine | xai/grok-imagine-image |
/edit |
3 |
| Nano Banana (precedente) | 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 |
nessuno (riferimenti di stile) | 10 riferimenti di stile |
I modelli Krea 2 usano lo schema nativo del payload Krea di fal. OpenClaw invia
aspect_ratio, creativity e image_style_references invece del
payload generico image_size / dell'endpoint di modifica usato da Flux. I riferimenti dei modelli sono:
fal/krea/v2/medium/text-to-imagefal/krea/v2/large/text-to-image
Usare Medium per illustrazioni espressive, anime, dipinti e stili artistici
più rapidi. Usare Large per risultati fotorealistici più lenti, texture grezze, grana della pellicola e aspetti
dettagliati. Il valore predefinito di Krea è fal.creativity: "medium"; i valori supportati sono
raw, low, medium e high.
Krea 2 espone le proporzioni, non image_size, nello schema delle richieste di fal. È preferibile usare
aspectRatio; OpenClaw associa size alle proporzioni Krea supportate più vicine
e rifiuta resolution per Krea anziché ignorarla.
Usare outputFormat: "png" quando si desidera un output PNG dai modelli fal che espongono
output_format. fal non dichiara in OpenClaw un controllo esplicito per lo sfondo trasparente,
pertanto background: "transparent" viene segnalato come sostituzione ignorata
per i modelli fal.
Gli endpoint Krea 2 non espongono un campo di richiesta output_format tramite fal, quindi
OpenClaw rifiuta le sostituzioni di outputFormat per le richieste Krea.
Per usare Krea 2 Medium:
{ agents: { defaults: { imageGenerationModel: { primary: "fal/krea/v2/medium/text-to-image", }, }, },}Generazione di video
Il provider integrato fal per la generazione di video usa come valore predefinito
fal/fal-ai/minimax/video-01-live.
| Funzionalità | Valore |
|---|---|
| Modalità | Da testo a video, riferimento a immagine singola, da riferimento a video con Seedance |
| Esecuzione | Flusso di invio/stato/risultato basato su coda per processi di lunga durata |
| Timeout | 20 minuti per processo per impostazione predefinita; stato verificato ogni 5 secondi |
Modelli video disponibili
MiniMax (predefinito):
fal/fal-ai/minimax/video-01-live
Agente video HeyGen:
fal/fal-ai/heygen/v2/video-agent
Kling e 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
Le richieste MiniMax Live e HeyGen inviano solo il prompt più un'eventuale
singola immagine di riferimento; le altre sostituzioni non vengono inoltrate. I modelli Seedance
accettano aspectRatio, size, resolution, durate da 4 a 15 secondi e
un'opzione per l'audio.
Esempio di configurazione di Seedance 2.0
{ agents: { defaults: { videoGenerationModel: { primary: "fal/bytedance/seedance-2.0/fast/text-to-video", }, }, },}Esempio di configurazione da riferimento a video di Seedance 2.0
{ agents: { defaults: { videoGenerationModel: { primary: "fal/bytedance/seedance-2.0/fast/reference-to-video", }, }, },}La modalità da riferimento a video accetta fino a 9 immagini, 3 video e 3 riferimenti audio
tramite i parametri condivisi images, videos e audioRefs di video_generate,
con un massimo di 12 file di riferimento complessivi. I riferimenti audio richiedono
almeno un riferimento a un'immagine o a un video nella stessa richiesta.
Esempio di configurazione dell'agente video HeyGen
{ agents: { defaults: { videoGenerationModel: { primary: "fal/fal-ai/heygen/v2/video-agent", }, }, },}Generazione di musica
Il plugin integrato fal registra anche un provider per la generazione di musica per lo
strumento condiviso music_generate.
| Funzionalità | Valore |
|---|---|
| Modello predefinito | fal/fal-ai/minimax-music/v2.6 |
| Modelli | fal-ai/minimax-music/v2.6 (mp3), fal-ai/ace-step/prompt-to-audio (wav), fal-ai/stable-audio-25/text-to-audio (wav) |
| Durata massima | 240 secondi |
| Esecuzione | Richiesta sincrona seguita dal download dell'audio generato |
Usare fal come provider musicale predefinito:
{ agents: { defaults: { musicGenerationModel: { primary: "fal/fal-ai/minimax-music/v2.6", }, }, },}fal-ai/minimax-music/v2.6 supporta testi espliciti e la modalità strumentale,
ma non entrambi nella stessa richiesta. ACE-Step e Stable Audio sono
endpoint da prompt ad audio; selezionarli con la sostituzione model quando si desiderano
queste famiglie di modelli. ACE-Step rifiuta i testi espliciti; Stable Audio rifiuta
sia i testi sia la modalità strumentale.
Contenuti correlati
Parametri condivisi dello strumento per le immagini e selezione del provider.
Parametri condivisi dello strumento per i video e selezione del provider.
Parametri condivisi dello strumento per la musica e selezione del provider.
Valori predefiniti degli agenti, inclusa la selezione dei modelli per immagini, video e musica.