Skip to main content
OpenClaw include un provider fal integrato per la generazione in hosting di immagini, video e musica.

​
Per iniziare

1

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.
2

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. 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:
Le richieste di conversione da immagine a immagine di Flux non supportano le sostituzioni di aspectRatio. Le richieste di modifica di GPT Image e Nano Banana 2 usano l’endpoint /edit di fal e accettano indicazioni sulle proporzioni. Nano Banana 2 accetta inoltre proporzioni larghe/alte native aggiuntive come 4:1, 1:4, 8:1 e 1:8; Krea 2 convalida un proprio sottoinsieme più ristretto di proporzioni. Grok Imagine dispone di un proprio elenco di proporzioni (che include 2:1, 20:9, 19.5:9 e le rispettive inverse) e accetta solo risoluzioni 1K/2K; Nano Banana precedente e Nano Banana 2 Lite rifiutano le sostituzioni di resolution.
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-image
  • fal/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.
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-video
  • fal/fal-ai/wan/v2.2-a14b/text-to-video
  • fal/fal-ai/wan/v2.2-a14b/image-to-video
Seedance 2.0:
  • fal/bytedance/seedance-2.0/fast/text-to-video
  • fal/bytedance/seedance-2.0/fast/image-to-video
  • fal/bytedance/seedance-2.0/fast/reference-to-video
  • fal/bytedance/seedance-2.0/text-to-video
  • fal/bytedance/seedance-2.0/image-to-video
  • fal/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.
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.

​
Generazione di musica

Il plugin integrato fal registra anche un provider per la generazione di musica per lo strumento condiviso music_generate. 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.
Le tabelle e le sezioni espandibili riportate sopra descrivono le famiglie di modelli per cui il provider fal integrato applica una gestione specifica. È comunque possibile selezionare come modello di immagini altri ID di endpoint di immagini fal; vengono trattati come Flux (payload generico image_size, un’immagine di riferimento tramite /image-to-image).

​
Contenuti correlati

Generazione di immagini

Parametri condivisi dello strumento per le immagini e selezione del provider.

Generazione di video

Parametri condivisi dello strumento per i video e selezione del provider.

Generazione di musica

Parametri condivisi dello strumento per la musica e selezione del provider.

Riferimento per la configurazione

Valori predefiniti degli agenti, inclusa la selezione dei modelli per immagini, video e musica.