Saltar al contenido principal
OpenClaw incluye un proveedor fal integrado para generación alojada de imágenes, video y música.
PropiedadValor
Proveedorfal
AutenticaciónFAL_KEY (canónico; FAL_API_KEY también funciona como respaldo)
APIendpoints de modelos fal (https://fal.run; los trabajos de video usan https://queue.fal.run)
URL baseSobrescribir con models.providers.fal.baseUrl

​
Primeros pasos

1

Configurar 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 configura fal/fal-ai/flux/dev como el modelo de imagen predeterminado cuando no hay ninguno configurado.
2

Configurar 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 de forma predeterminada fal/fal-ai/flux/dev.
CapacidadValor
Imágenes máximas4 por solicitud; Krea 2: 1 por solicitud
Sobrescrituras de tamaño1024x1024, 1024x1536, 1536x1024, 1024x1792, 1792x1024
Relación de aspectoAdmitida en todas partes excepto en Flux image-to-image
Resolución1K, 2K, 4K (límites por modelo a continuación)
Formato de salidapng (predeterminado) o jpeg; Krea 2 rechaza sobrescrituras 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 por modelo con límites de referencia por modelo:
Familia de modelosReferencia de modelo después de fal/Endpoint de ediciónImágenes de referencia máximas
Flux y otros modelos falfal-ai/flux/dev (predeterminado)/image-to-image1
GPT Imageopenai/gpt-image-*/edit10
Grok Imaginexai/grok-imagine-image/edit3
Nano Banana (heredado)fal-ai/nano-banana/edit3
Nano Banana 2fal-ai/nano-banana-*/edit14
Nano Banana 2 Litegoogle/nano-banana-2-lite/edit14
Krea 2krea/v2/{medium,large}/text-to-imageninguno (refs de estilo)10 referencias de estilo
Las solicitudes Flux image-to-image no admiten sobrescrituras de aspectRatio. Las solicitudes de edición GPT Image y Nano Banana 2 usan el endpoint /edit de fal y aceptan sugerencias 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 pequeño de relaciones de aspecto. Grok Imagine tiene su propia lista de relaciones (incluidas 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 sobrescrituras de resolution.
Los modelos Krea 2 usan el esquema de carga nativo de Krea de fal. OpenClaw envía aspect_ratio, creativity e image_style_references en lugar de la carga genérica image_size / de endpoint de edición usada por Flux. Las referencias de modelo son:
  • fal/krea/v2/medium/text-to-image
  • fal/krea/v2/large/text-to-image
Usa Medium para ilustración expresiva, anime, pintura y estilos artísticos más rápidos. Usa Large para estilos fotorrealistas más lentos, textura cruda, grano de película y aspectos detallados. Krea usa fal.creativity: "medium" de forma predeterminada; los valores admitidos son raw, low, medium y high. Krea 2 expone relación de aspecto, no image_size, en el esquema de solicitud de fal. Prefiere aspectRatio; OpenClaw asigna size a la relación de aspecto Krea admitida más cercana y rechaza resolution para Krea en lugar de descartarla. Usa outputFormat: "png" cuando quieras 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 informa como una sobrescritura ignorada para modelos fal. Los endpoints Krea 2 no exponen un campo de solicitud output_format mediante fal, por lo que OpenClaw rechaza las sobrescrituras de outputFormat para solicitudes Krea. Para usar Krea 2 Medium: 
{
  agents: {
    defaults: {
      imageGenerationModel: {
        primary: "fal/krea/v2/medium/text-to-image",
      },
    },
  },
}

​
Generación de video

El proveedor integrado de generación de video fal usa de forma predeterminada fal/fal-ai/minimax/video-01-live.
CapacidadValor
ModosTexto a video, referencia de una sola imagen, Seedance de referencia a video
Tiempo de ejecuciónFlujo de envío/estado/resultado respaldado por cola para trabajos de larga duración
Tiempo de espera20 minutos por trabajo de forma predeterminada; estado consultado cada 5 segundos
MiniMax (predeterminado):
  • fal/fal-ai/minimax/video-01-live
HeyGen video-agent:
  • 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 MiniMax Live y HeyGen solo envían el prompt más una imagen de referencia única opcional; no se reenvían otras sobrescrituras. Los modelos Seedance aceptan aspectRatio, size, resolution, duraciones de 4 a 15 segundos y un conmutador de audio.
{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "fal/bytedance/seedance-2.0/fast/text-to-video",
      },
    },
  },
}

{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "fal/bytedance/seedance-2.0/fast/reference-to-video",
      },
    },
  },
}
Reference-to-video acepta hasta 9 imágenes, 3 videos 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 video en la misma solicitud.
{
  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.
CapacidadValor
Modelo predeterminadofal/fal-ai/minimax-music/v2.6
Modelosfal-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áxima240 segundos
Tiempo de ejecuciónSolicitud sincrónica más descarga del audio generado
Usa 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, pero no ambos en la misma solicitud. ACE-Step y Stable Audio son endpoints de prompt a audio; elígelos con la sobrescritura model cuando quieras esas familias de modelos. ACE-Step rechaza letras explícitas; Stable Audio rechaza tanto letras como modo instrumental.
Las tablas y acordeones anteriores cubren las familias de modelos para las que el proveedor fal integrado tiene tratamiento especial. Otros ids de endpoints de imagen fal aún pueden seleccionarse como modelo de imagen; se tratan como Flux (carga genérica image_size, una imagen de referencia mediante /image-to-image).

​
Relacionado

Generación de imágenes

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

Generación de video

Parámetros compartidos de la herramienta de video 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, video y música.