Providers

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

    bash
    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

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

    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:

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

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

    Contenido relacionado

    Was this useful?
    On this page

    On this page