Fal

OpenClaw 提供了一个内置的 fal 提供程序，用于托管图像、视频和音乐生成。

属性	值
提供程序	`fal`
认证	`FAL_KEY`（canonical；`FAL_API_KEY` 也可作为回退）
API	fal 模型端点（`https://fal.run`；视频任务使用 `https://queue.fal.run`）
基础 URL	使用 `models.providers.fal.baseUrl` 覆盖

开始使用

设置 API 密钥

openclaw onboard --auth-choice fal-api-key

非交互式设置可以传入 --fal-api-key <key> 或导出 FAL_KEY。在未配置默认图像模型时，初始化还会将 fal/fal-ai/flux/dev 设为默认图像模型。

设置默认图像模型

{
  agents: {
    defaults: {
      mediaModels: {
        image: {
          primary: "fal/fal-ai/flux/dev",
        },
      },
    },
  },
}

图像生成

内置的 fal 图像生成提供程序默认使用 fal/fal-ai/flux/dev。

能力	值
最大图像数	每次请求最多 4 张；Krea 2：每次请求 1 张
尺寸覆盖项	`1024x1024`、`1024x1536`、`1536x1024`、`1024x1792`、`1792x1024`
宽高比	除 Flux 图像到图像外，其他所有地方都支持
分辨率	`1K`、`2K`、`4K`（见下方各模型限制）
输出格式	`png`（默认）或 `jpeg`；Krea 2 会拒绝 `outputFormat` 覆盖项

编辑请求（通过共享的 image / images 参数引用参考图像）会路由到每个模型各自的编辑端点，并遵循各模型的参考图像限制：

模型系列	`fal/` 后的模型引用	编辑端点	最大参考图像数
Flux 和其他 fal 模型	`fal-ai/flux/dev`（默认）	`/image-to-image`	1
GPT Image	`openai/gpt-image-*`	`/edit`	10
Grok Imagine	`xai/grok-imagine-image`	`/edit`	3
Nano Banana（旧版）	`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`	无（风格参考）	10 个风格参考

Flux 的图像到图像请求不支持 aspectRatio 覆盖项。GPT Image 和 Nano Banana 2 的编辑请求使用 fal 的 /edit 端点，并接受宽高比提示。Nano Banana 2 还接受额外的原生超宽／超高比例，例如 4:1、1:4、8:1 和 1:8；Krea 2 会验证其自身较小的宽高比子集。Grok Imagine 有自己的比例列表（包括 2:1、 20:9、19.5:9 及其反向比例），并且只接受 1K／2K 分辨率；旧版 Nano Banana 和 Nano Banana 2 Lite 会拒绝 resolution 覆盖项。

Krea 2 模型使用 fal 的原生 Krea 负载架构。OpenClaw 发送 aspect_ratio、creativity 和 image_style_references，而不是 Flux 使用的通用 image_size／编辑端点负载。模型引用为：

fal/krea/v2/medium/text-to-image
fal/krea/v2/large/text-to-image

Medium 适合更快的表现型插画、动漫、绘画和艺术风格。Large 适合更慢的写实、原始纹理、胶片颗粒和更细致的效果。Krea 默认 fal.creativity: "medium"；支持的值为 raw、low、medium 和 high。 Krea 2 在 fal 的请求架构中暴露的是宽高比，而不是 image_size。优先使用 aspectRatio； OpenClaw 会将 size 映射为最接近的 Krea 支持的宽高比，并拒绝 Krea 的 resolution 覆盖项，而不是忽略它。当您希望从暴露 output_format 的 fal 模型获得 PNG 输出时，请使用 outputFormat: "png"。fal 在 OpenClaw 中没有声明明确的透明背景控制，因此 background: "transparent" 会被报告为 fal 模型被忽略的覆盖项。 Krea 2 端点不会通过 fal 暴露 output_format 请求字段，因此 OpenClaw 会拒绝 Krea 请求中的 outputFormat 覆盖项。要使用 Krea 2 Medium：

{
  agents: {
    defaults: {
      mediaModels: {
        image: {
          primary: "fal/krea/v2/medium/text-to-image",
        },
      },
    },
  },
}

视频生成

内置的 fal 视频生成提供程序默认使用 fal/fal-ai/minimax/video-01-live。

能力	值
模式	文本生成视频、单张图像参考、Seedance 参考生成视频
运行时	面向长时间运行任务的队列支持 submit/status/result 流程
超时	默认每个任务 20 分钟；每 5 秒轮询一次状态

可用的视频模型

MiniMax（默认）：

fal/fal-ai/minimax/video-01-live

HeyGen video-agent：

fal/fal-ai/heygen/v2/video-agent

Kling 和 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

MiniMax Live 和 HeyGen 请求只发送提示词以及可选的单张参考图像；不会传递其他覆盖项。Seedance 模型接受 aspectRatio、size、resolution、4 到 15 秒的时长，以及音频开关。

Seedance 2.0 配置示例

{
  agents: {
    defaults: {
      mediaModels: {
        video: {
          primary: "fal/bytedance/seedance-2.0/fast/text-to-video",
        },
      },
    },
  },
}

Seedance 2.0 参考生成视频配置示例

{
  agents: {
    defaults: {
      mediaModels: {
        video: {
          primary: "fal/bytedance/seedance-2.0/fast/reference-to-video",
        },
      },
    },
  },
}

参考生成视频最多可通过共享的 video_generate images、videos 和 audioRefs 参数接受 9 张图片、3 个视频和 3 个音频参考，总参考文件数最多为 12 个。音频参考要求同一请求中至少包含一个图片或视频参考。

HeyGen video-agent 配置示例

{
  agents: {
    defaults: {
      mediaModels: {
        video: {
          primary: "fal/fal-ai/heygen/v2/video-agent",
        },
      },
    },
  },
}

音乐生成

内置的 fal 插件还为共享的 music_generate 工具注册了一个音乐生成提供程序。

能力	值
默认模型	`fal/fal-ai/minimax-music/v2.6`
模型	`fal-ai/minimax-music/v2.6`（mp3）、`fal-ai/ace-step/prompt-to-audio`（wav）、`fal-ai/stable-audio-25/text-to-audio`（wav）
最大时长	240 秒
运行时	同步请求加生成音频下载

将 fal 设为默认音乐提供程序：

{
  agents: {
    defaults: {
      mediaModels: {
        music: {
          primary: "fal/fal-ai/minimax-music/v2.6",
        },
      },
    },
  },
}

fal-ai/minimax-music/v2.6 支持显式歌词和纯音乐模式，但不能在同一次请求中同时使用。ACE-Step 和 Stable Audio 是 prompt-to-audio 端点；当你需要这些模型系列时，请使用 model 覆盖来选择它们。ACE-Step 会拒绝显式歌词；Stable Audio 会拒绝歌词和纯音乐模式。

上面的表格和折叠面板涵盖了内置 fal 提供程序进行特殊处理的模型系列。其他 fal 图像端点 id 仍然可以被选为图像模型；它们会像 Flux 一样处理（通用的 image_size 负载，通过 /image-to-image 仅使用一张参考图像）。

图像生成

共享的图像工具参数和提供程序选择。

视频生成

共享的视频工具参数和提供程序选择。

音乐生成

共享的音乐工具参数和提供程序选择。

配置参考

代理默认设置，包括图像、视频和音乐模型选择。

概览

概念与配置

提供商

开始使用

图像生成

视频生成

音乐生成

相关内容

图像生成

视频生成

音乐生成

配置参考

​开始使用

​图像生成

​视频生成

​音乐生成

​相关内容

图像生成

视频生成

音乐生成

配置参考

开始使用

图像生成

视频生成

音乐生成

相关内容