Providers
Fal
OpenClaw incluye un proveedor fal integrado para generación alojada de imágenes, video y música.
| Propiedad | Valor |
|---|---|
| Proveedor | fal |
| Autenticación | FAL_KEY (canónico; FAL_API_KEY también funciona como respaldo) |
| API | endpoints de modelos fal (https://fal.run; los trabajos de video usan https://queue.fal.run) |
| URL base | Sobrescribir con models.providers.fal.baseUrl |
Primeros pasos
Configurar la clave de API
openclaw onboard --auth-choice fal-api-keyLas 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.
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.
| Capacidad | Valor |
|---|---|
| Imágenes máximas | 4 por solicitud; Krea 2: 1 por solicitud |
| Sobrescrituras de tamaño | 1024x1024, 1024x1536, 1536x1024, 1024x1792, 1792x1024 |
| Relación de aspecto | Admitida en todas partes excepto en Flux image-to-image |
| Resolución | 1K, 2K, 4K (límites por modelo a continuación) |
| Formato de salida | png (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 modelos | Referencia de modelo después de fal/ |
Endpoint de edición | Imágenes de referencia máximas |
|---|---|---|---|
| Flux y otros modelos 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 (refs de estilo) | 10 referencias de estilo |
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-imagefal/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.
| Capacidad | Valor |
|---|---|
| Modos | Texto a video, referencia de una sola imagen, Seedance de referencia a video |
| Tiempo de ejecución | Flujo de envío/estado/resultado respaldado por cola para trabajos de larga duración |
| Tiempo de espera | 20 minutos por trabajo de forma predeterminada; estado consultado cada 5 segundos |
Modelos de video disponibles
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-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 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.
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 Seedance 2.0 de referencia a 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.
Ejemplo de configuración de HeyGen video-agent
{ 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 |
| Tiempo de ejecución | Solicitud 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.
Relacionado
Parámetros compartidos de la herramienta de imágenes y selección de proveedor.
Parámetros compartidos de la herramienta de video 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, video y música.