Providers

Fal

OpenClaw incluye un proveedor fal integrado para la generación alojada de imágenes y video.

Propiedad Valor
Proveedor fal
Autenticación FAL_KEY (canónico; FAL_API_KEY también funciona como alternativa)
API endpoints de modelos de fal

Primeros pasos

  • Configura la clave de API

    openclaw onboard --auth-choice fal-api-key
    
  • Configura un modelo de imagen predeterminado

    {
      agents: {
        defaults: {
          imageGenerationModel: {
            primary: "fal/fal-ai/flux/dev",
          },
        },
      },
    }
    
  • Generación de imágenes

    El proveedor integrado de generación de imágenes fal usa por defecto fal/fal-ai/flux/dev.

    Capacidad Valor
    Máximo de imágenes 4 por solicitud
    Modo de edición Activado, 1 imagen de referencia
    Reemplazos de tamaño Compatibles
    Relación de aspecto Compatible
    Resolución Compatible
    Formato de salida png o jpeg

    Usa outputFormat: "png" cuando quieras salida PNG. fal no declara un control explícito de fondo transparente en OpenClaw, por lo que background: "transparent" se informa como un reemplazo ignorado para los modelos fal.

    Para usar fal como proveedor de imágenes predeterminado:

    {
      agents: {
        defaults: {
          imageGenerationModel: {
            primary: "fal/fal-ai/flux/dev",
          },
        },
      },
    }
    

    Generación de video

    El proveedor integrado de generación de video fal usa por defecto fal/fal-ai/minimax/video-01-live.

    Capacidad Valor
    Modos Texto a video, referencia de una sola imagen, referencia a video de Seedance
    Ejecución Flujo de envío/estado/resultado respaldado por cola para trabajos de larga duración
    Modelos de video disponibles

    Agente de video de HeyGen:

    • fal/fal-ai/heygen/v2/video-agent

    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
    Ejemplo de configuración de Seedance 2.0
    {
      agents: {
        defaults: {
          videoGenerationModel: {
            primary: "fal/bytedance/seedance-2.0/fast/text-to-video",
          },
        },
      },
    }
    
    Ejemplo de configuración de referencia a video de Seedance 2.0
    {
      agents: {
        defaults: {
          videoGenerationModel: {
            primary: "fal/bytedance/seedance-2.0/fast/reference-to-video",
          },
        },
      },
    }
    

    La referencia a video acepta hasta 9 imágenes, 3 videos y 3 referencias de audio mediante los parámetros compartidos images, videos y audioRefs de video_generate, con un máximo de 12 archivos de referencia en total.

    Ejemplo de configuración del agente de video de HeyGen
    {
      agents: {
        defaults: {
          videoGenerationModel: {
            primary: "fal/fal-ai/heygen/v2/video-agent",
          },
        },
      },
    }
    

    Relacionado