In questa pagina
In questa pagina
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
Le 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
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:
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
Esempio di configurazione da riferimento a video di Seedance 2.0
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
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:
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.