Fal

OpenClaw incluye un proveedor fal para la generación alojada de imágenes, videos y música.

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

Cómo empezar

Establezca la clave de API

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

Establezca un modelo de imagen predeterminado

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

Generación de imágenes

El proveedor de generación de imágenes fal incluido tiene como valor predeterminado fal/fal-ai/flux/dev.

Capacidad	Valor
Máximo de imágenes	4 por solicitud
Modo de edición	Flux: 1 imagen de referencia; GPT Image 2: 10; Nano Banana 2: 14
Sobrescrituras de tamaño	Compatible
Relación de aspecto	Soportado para generate y edición de GPT Image 2/Nano Banana 2
Resolución	Compatible
Formato de salida	`png` o `jpeg`

Use outputFormat: "png" cuando quiera salida PNG. fal no declara un control explícito de fondo transparente en OpenClaw, por lo que background: "transparent" se reporta como una anulación ignorada para los modelos de 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 de generación de video fal incluido tiene como valor predeterminado fal/fal-ai/minimax/video-01-live.

Capacidad	Valor
Modos	Texto a video, referencia de imagen única, referencia a video de Seedance
Tiempo de ejecución	Flujo de envío/estado/resultado con soporte de cola para trabajos de larga duración

Modelos de video disponibles

Agente de video 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",
      },
    },
  },
}

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

Ejemplo de configuración de video-agent de HeyGen

{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "fal/fal-ai/heygen/v2/video-agent",
      },
    },
  },
}

Generación de música

El complemento incluido fal también registra un proveedor de generación de música para la herramienta compartida music_generate.

Capacidad	Valor
Modelo predeterminado	`fal/fal-ai/minimax-music/v2.6`
Modelos	`fal-ai/minimax-music/v2.6`, `fal-ai/ace-step/prompt-to-audio`, `fal-ai/stable-audio-25/text-to-audio`
Tiempo de ejecución	Solicitud síncrona más descarga de audio generado

Use fal como proveedor de música predeterminado:

{
  agents: {
    defaults: {
      musicGenerationModel: {
        primary: "fal/fal-ai/minimax-music/v2.6",
      },
    },
  },
}

fal-ai/minimax-music/v2.6 admite letras explícitas y modo instrumental. ACE-Step y Stable Audio son puntos de conexión de prompt a audio; selecciónelos con la anulación model cuando desee esas familias de modelos.

Relacionado

Generación de imágenes

Parámetros compartidos de la herramienta de imagen y selección de proveedor.

Generación de vídeo

Parámetros compartidos de la herramienta de vídeo y selección del proveedor.

Generación de música

Parámetros compartidos de la herramienta de música y selección del proveedor.

Referencia de configuración

Valores predeterminados del agente, incluida la selección de modelos de imagen, vídeo y música.