En esta página
En esta página
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
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
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-imagefal/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:
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-videofal/fal-ai/wan/v2.2-a14b/text-to-videofal/fal-ai/wan/v2.2-a14b/image-to-video
Seedance 2.0:
fal/bytedance/seedance-2.0/fast/text-to-videofal/bytedance/seedance-2.0/fast/image-to-videofal/bytedance/seedance-2.0/fast/reference-to-videofal/bytedance/seedance-2.0/text-to-videofal/bytedance/seedance-2.0/image-to-videofal/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
Ejemplo de configuración de referencia a vídeo de Seedance 2.0
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
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:
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
Parámetros compartidos de la herramienta de imágenes y selección de proveedor.
Parámetros compartidos de la herramienta de vídeo y selección de proveedor.
Parámetros compartidos de la herramienta de música y selección de proveedor.
Valores predeterminados del agente, incluida la selección de modelos de imagen, vídeo y música.