Providers
Fal
OpenClaw inclui um provedor fal integrado para geração hospedada de imagens,
vídeos e músicas.
| Propriedade | Valor |
|---|---|
| Provedor | fal |
| Autenticação | FAL_KEY (canônica; FAL_API_KEY também funciona como alternativa) |
| API | Endpoints de modelos fal (https://fal.run; tarefas de vídeo usam https://queue.fal.run) |
| URL base | Substitua com models.providers.fal.baseUrl |
Introdução
Definir a chave de API
openclaw onboard --auth-choice fal-api-keyConfigurações não interativas podem fornecer --fal-api-key <key> ou
exportar FAL_KEY. A integração inicial também define
fal/fal-ai/flux/dev como o modelo de imagem padrão quando nenhum está
configurado.
Definir um modelo de imagem padrão
{ agents: { defaults: { imageGenerationModel: { primary: "fal/fal-ai/flux/dev", }, }, },}Geração de imagens
O provedor integrado fal de geração de imagens usa
fal/fal-ai/flux/dev por padrão.
| Recurso | Valor |
|---|---|
| Máximo de imagens | 4 por solicitação; Krea 2: 1 por solicitação |
| Substituições de tamanho | 1024x1024, 1024x1536, 1536x1024, 1024x1792, 1792x1024 |
| Proporção | Compatível em todos os casos, exceto imagem para imagem do Flux |
| Resolução | 1K, 2K, 4K (limites por modelo abaixo) |
| Formato de saída | png (padrão) ou jpeg; Krea 2 rejeita substituições de outputFormat |
As solicitações de edição (imagens de referência pelos parâmetros
compartilhados image / images) são encaminhadas para um endpoint de edição
específico do modelo, com limites de referência por modelo:
| Família de modelos | Referência do modelo após fal/ |
Endpoint de edição | Máximo de imagens de referência |
|---|---|---|---|
| Flux e outros modelos fal | fal-ai/flux/dev (padrão) |
/image-to-image |
1 |
| GPT Image | openai/gpt-image-* |
/edit |
10 |
| Grok Imagine | xai/grok-imagine-image |
/edit |
3 |
| Nano Banana (legado) | 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 |
nenhum (referências de estilo) | 10 referências de estilo |
Os modelos Krea 2 usam o esquema de payload nativo do Krea no fal. O OpenClaw
envia aspect_ratio, creativity e image_style_references em vez do payload
genérico image_size / endpoint de edição usado pelo Flux. As referências dos
modelos são:
fal/krea/v2/medium/text-to-imagefal/krea/v2/large/text-to-image
Use o Medium para ilustrações expressivas, anime, pintura e estilos artísticos
mais rápidos. Use o Large para resultados mais lentos com fotorrealismo,
textura bruta, granulação de filme e visual detalhado. O padrão do Krea é
fal.creativity: "medium"; os valores compatíveis são raw, low, medium
e high.
O Krea 2 expõe proporção, não image_size, no esquema de solicitação do fal.
Prefira aspectRatio; o OpenClaw mapeia size para a proporção compatível mais
próxima do Krea e rejeita resolution para o Krea em vez de descartá-la.
Use outputFormat: "png" quando quiser uma saída PNG de modelos fal que expõem
output_format. O fal não declara um controle explícito de fundo transparente
no OpenClaw, portanto background: "transparent" é informado como uma
substituição ignorada para modelos fal.
Os endpoints do Krea 2 não expõem um campo de solicitação output_format pelo
fal, portanto o OpenClaw rejeita substituições de outputFormat para
solicitações do Krea.
Para usar o Krea 2 Medium:
{ agents: { defaults: { imageGenerationModel: { primary: "fal/krea/v2/medium/text-to-image", }, }, },}Geração de vídeos
O provedor integrado fal de geração de vídeos usa
fal/fal-ai/minimax/video-01-live por padrão.
| Recurso | Valor |
|---|---|
| Modos | Texto para vídeo, referência de uma imagem, referência para vídeo do Seedance |
| Execução | Fluxo de envio/status/resultado baseado em fila para tarefas de longa duração |
| Tempo limite | 20 minutos por tarefa por padrão; status consultado a cada 5 segundos |
Modelos de vídeo disponíveis
MiniMax (padrão):
fal/fal-ai/minimax/video-01-live
Agente de vídeo 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
As solicitações do MiniMax Live e do HeyGen enviam apenas o prompt e uma
única imagem de referência opcional; outras substituições não são
encaminhadas. Os modelos Seedance aceitam aspectRatio, size,
resolution, durações de 4 a 15 segundos e uma opção de áudio.
Exemplo de configuração do Seedance 2.0
{ agents: { defaults: { videoGenerationModel: { primary: "fal/bytedance/seedance-2.0/fast/text-to-video", }, }, },}Exemplo de configuração de referência para vídeo do Seedance 2.0
{ agents: { defaults: { videoGenerationModel: { primary: "fal/bytedance/seedance-2.0/fast/reference-to-video", }, }, },}A referência para vídeo aceita até 9 imagens, 3 vídeos e 3 referências de
áudio pelos parâmetros compartilhados images, videos e audioRefs da
ferramenta video_generate, com no máximo 12 arquivos de referência no
total. As referências de áudio exigem pelo menos uma referência de imagem
ou vídeo na mesma solicitação.
Exemplo de configuração do agente de vídeo HeyGen
{ agents: { defaults: { videoGenerationModel: { primary: "fal/fal-ai/heygen/v2/video-agent", }, }, },}Geração de músicas
O Plugin integrado fal também registra um provedor de geração de músicas para
a ferramenta compartilhada music_generate.
| Recurso | Valor |
|---|---|
| Modelo padrão | fal/fal-ai/minimax-music/v2.6 |
| Modelos | fal-ai/minimax-music/v2.6 (mp3), fal-ai/ace-step/prompt-to-audio (wav), fal-ai/stable-audio-25/text-to-audio (wav) |
| Duração máxima | 240 segundos |
| Execução | Solicitação síncrona seguida do download do áudio gerado |
Use o fal como provedor de música padrão:
{ agents: { defaults: { musicGenerationModel: { primary: "fal/fal-ai/minimax-music/v2.6", }, }, },}fal-ai/minimax-music/v2.6 aceita letras explícitas e modo instrumental, mas
não ambos na mesma solicitação. ACE-Step e Stable Audio são endpoints de prompt
para áudio; escolha-os com a substituição model quando quiser essas famílias
de modelos. O ACE-Step rejeita letras explícitas; o Stable Audio rejeita tanto
letras quanto o modo instrumental.
Relacionados
Parâmetros compartilhados da ferramenta de imagem e seleção de provedor.
Parâmetros compartilhados da ferramenta de vídeo e seleção de provedor.
Parâmetros compartilhados da ferramenta de música e seleção de provedor.
Padrões do agente, incluindo a seleção de modelos de imagem, vídeo e música.