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

    bash
    openclaw onboard --auth-choice fal-api-key

    Configuraçõ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

    json5
    {  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-image
    • fal/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:

    json5
    {  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-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

    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
    json5
    {  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
    json5
    {  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
    json5
    {  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:

    json5
    {  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

    Was this useful?
    On this page

    On this page