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 de fal (https://fal.run; los trabajos de vídeo usan https://queue.fal.run)
URL base Se reemplaza 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 proporcionar --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 fal integrado para la generación de imágenes usa de forma predeterminada fal/fal-ai/flux/dev.

    Capacidad Valor
    Máximo de imágenes 4 por solicitud; Krea 2: 1 por solicitud
    Reemplazos de tamaño 1024x1024, 1024x1536, 1536x1024, 1024x1792, 1792x1024
    Relación de aspecto Compatible en todas partes excepto en la conversión de imagen a imagen de Flux
    Resolución 1K, 2K, 4K (límites por modelo indicados a continuación)
    Formato de salida png (predeterminado) o jpeg; Krea 2 rechaza los reemplazos 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 en fal. OpenClaw envía aspect_ratio, creativity e image_style_references en lugar de la carga útil genérica de image_size / endpoint de edición que usa 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 con mayor rapidez. Use Large para resultados fotorrealistas más lentos, texturas sin procesar, grano de película y acabados detallados. El valor predeterminado de Krea es fal.creativity: "medium"; 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 de Krea compatible más cercana y rechaza resolution para Krea en lugar de descartarla.

    Use outputFormat: "png" cuando quiera obtener una salida PNG de los modelos de fal que exponen output_format. 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 de fal. Los endpoints de Krea 2 no exponen un campo de solicitud output_format mediante fal, por lo que OpenClaw rechaza los reemplazos 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ídeos

    El proveedor fal integrado para la generación de vídeos usa 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 con Seedance
    Ejecución Flujo de envío, estado y 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; no se reenvían otros reemplazos. Los modelos Seedance admiten aspectRatio, size, resolution, duraciones de 4 a 15 segundos y un conmutador 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 con Seedance 2.0
    json5
    {  agents: {    defaults: {      videoGenerationModel: {        primary: "fal/bytedance/seedance-2.0/fast/reference-to-video",      },    },  },}

    La conversión de referencia a vídeo admite hasta 9 imágenes, 3 vídeos 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. 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 fal integrado 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

    Use 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 modo instrumental, pero no ambos en la misma solicitud. ACE-Step y Stable Audio son endpoints de instrucción a audio; selecciónelos mediante el reemplazo model cuando quiera usar 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