Fal

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

Propiedad	Valor
Proveedor	`fal`
Autenticación	`FAL_KEY` (canónica; `FAL_API_KEY` también funciona como alternativa)
API	Endpoints de modelos fal (`https://fal.run`; los trabajos de vídeo usan `https://queue.fal.run`)
URL base	Se puede sustituir con `models.providers.fal.baseUrl`

Primeros pasos

Establecer la clave de API

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

Las configuraciones no interactivas pueden pasar --fal-api-key <key> o exportar FAL_KEY. La incorporación también establece fal/fal-ai/flux/dev como modelo de imagen predeterminado cuando no hay ninguno configurado.

Establecer 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 utiliza de forma predeterminada fal/fal-ai/flux/dev.

Capacidad	Valor
Máximo de imágenes	4 por solicitud; Krea 2: 1 por solicitud
Sustituciones de tamaño	`1024x1024`, `1024x1536`, `1536x1024`, `1024x1792`, `1792x1024`
Relación de aspecto	Compatible en todos los casos excepto en la transformación de imagen a imagen de Flux
Resolución	`1K`, `2K`, `4K` (límites por modelo a continuación)
Formato de salida	`png` (predeterminado) o `jpeg`; Krea 2 rechaza las sustituciones de `outputFormat`

Las solicitudes de edición (imágenes de referencia mediante los parámetros compartidos image / images) se dirigen a un endpoint de edición específico de cada modelo, con límites de referencias por modelo:

Familia de modelos	Referencia del modelo después de `fal/`	Endpoint de edición	Máximo de imágenes de referencia
Flux y otros modelos de fal	`fal-ai/flux/dev` (predeterminado)	`/image-to-image`	1
GPT Image	`openai/gpt-image-*`	`/edit`	10
Grok Imagine	`xai/grok-imagine-image`	`/edit`	3
Nano Banana (heredado)	`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`	ninguno (referencias de estilo)	10 referencias de estilo

Las solicitudes de transformación de imagen a imagen de Flux no admiten sustituciones de aspectRatio. Las solicitudes de edición de GPT Image y Nano Banana 2 usan el endpoint /edit de fal y aceptan indicaciones de relación de aspecto. Nano Banana 2 también acepta relaciones anchas/altas nativas adicionales, como 4:1, 1:4, 8:1 y 1:8; Krea 2 valida su propio subconjunto más reducido de relaciones de aspecto. Grok Imagine tiene su propia lista de relaciones (incluidos 2:1, 20:9, 19.5:9 y sus inversas) y solo acepta resoluciones 1K/2K; Nano Banana heredado y Nano Banana 2 Lite rechazan las sustituciones de resolution.

Los modelos Krea 2 usan el esquema de carga útil nativo de Krea de fal. OpenClaw envía aspect_ratio, creativity y image_style_references en lugar de la carga útil genérica de image_size / endpoint de edición utilizada por Flux. Las referencias de los modelos son:

fal/krea/v2/medium/text-to-image
fal/krea/v2/large/text-to-image

Use Medium para ilustraciones expresivas, anime, pintura y estilos artísticos más rápidos. Use Large para acabados fotorrealistas, texturas sin procesar, grano de película y aspectos detallados más lentos. Krea utiliza fal.creativity: "medium" de forma predeterminada; los valores compatibles son raw, low, medium y high. Krea 2 expone la relación de aspecto, no image_size, en el esquema de solicitud de fal. Se recomienda aspectRatio; OpenClaw asigna size a la relación de aspecto compatible con Krea más cercana y rechaza resolution para Krea en lugar de descartarlo. Use outputFormat: "png" cuando quiera una salida PNG de modelos fal que expongan output_format. fal no declara un control explícito de fondo transparente en OpenClaw, por lo que background: "transparent" se indica como una sustitución ignorada para los modelos fal. Los endpoints de Krea 2 no exponen un campo de solicitud output_format mediante fal, por lo que OpenClaw rechaza las sustituciones de outputFormat en las solicitudes de Krea. Para usar Krea 2 Medium:

{
  agents: {
    defaults: {
      imageGenerationModel: {
        primary: "fal/krea/v2/medium/text-to-image",
      },
    },
  },
}

Generación de vídeo

El proveedor integrado de generación de vídeo fal utiliza de forma predeterminada fal/fal-ai/minimax/video-01-live.

Capacidad	Valor
Modos	Texto a vídeo, referencia de una sola imagen, referencia a vídeo de Seedance
Ejecución	Flujo de envío/estado/resultado respaldado por una cola para trabajos de larga duración
Tiempo de espera	20 minutos por trabajo de forma predeterminada; el estado se consulta cada 5 segundos

Modelos de vídeo disponibles

MiniMax (predeterminado):

fal/fal-ai/minimax/video-01-live

Agente de vídeo de HeyGen:

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

Kling y 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

Las solicitudes de MiniMax Live y HeyGen solo envían la instrucción y una imagen de referencia única opcional; las demás sustituciones no se reenvían. Los modelos Seedance aceptan aspectRatio, size, resolution, duraciones de 4-15 segundos y una opción de audio.

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 vídeo de Seedance 2.0

{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "fal/bytedance/seedance-2.0/fast/reference-to-video",
      },
    },
  },
}

La referencia a vídeo acepta hasta 9 imágenes, 3 vídeos y 3 referencias de audio mediante los parámetros compartidos video_generate images, videos y audioRefs, con un máximo de 12 archivos de referencia en total. Las referencias de audio requieren al menos una referencia de imagen o vídeo en la misma solicitud.

Ejemplo de configuración del agente de vídeo de HeyGen

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

Generación de música

El plugin integrado 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` (mp3), `fal-ai/ace-step/prompt-to-audio` (wav), `fal-ai/stable-audio-25/text-to-audio` (wav)
Duración máxima	240 segundos
Ejecución	Solicitud síncrona y descarga del audio generado

Para usar 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 el modo instrumental, pero no ambos en la misma solicitud. ACE-Step y Stable Audio son endpoints de instrucción a audio; selecciónelos con la sustitución model cuando quiera esas familias de modelos. ACE-Step rechaza las letras explícitas; Stable Audio rechaza tanto las letras como el modo instrumental.

Las tablas y los acordeones anteriores abarcan las familias de modelos para las que el proveedor fal integrado aplica un tratamiento especial. También se pueden seleccionar otros identificadores de endpoints de imagen de fal como modelo de imagen; se tratan como Flux (carga útil genérica de image_size, una imagen de referencia mediante /image-to-image).

Contenido relacionado

Generación de imágenes

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

Generación de vídeo

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

Generación de música

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

Referencia de configuración

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

Overview

Concepts and configuration

Providers

Primeros pasos

Generación de imágenes

Generación de vídeo

Generación de música

Contenido relacionado

Generación de imágenes

Generación de vídeo

Generación de música

Referencia de configuración

​Primeros pasos

​Generación de imágenes

​Generación de vídeo

​Generación de música

​Contenido relacionado

Generación de imágenes

Generación de vídeo

Generación de música

Referencia de configuración

Primeros pasos

Generación de imágenes

Generación de vídeo

Generación de música

Contenido relacionado