本页内容
本页内容
供应商
Fal
OpenClaw 提供了一个内置的 fal 提供程序,用于托管图像、视频和音乐生成。
| 属性 | 值 |
|---|---|
| 提供者 | fal |
| 认证 | FAL_KEY(首选;FAL_API_KEY 也可作为后备) |
| API | fal 模型端点(https://fal.run;视频任务使用 https://queue.fal.run) |
| 基础 URL | 使用 models.providers.fal.baseUrl 覆盖 |
入门
获取 API 密钥
在 fal.ai/dashboard/keys. 创建密钥
设置API密钥
非交互式设置可以传入 --fal-api-key <key> 或导出 FAL_KEY。 在未配置默认图像模型时,初始化还会将 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; GPT 图像 2.5 也支持 webp; Krea 2 拒绝覆盖 |
编辑请求(通过共享的 image / images 参数引用参考图像) 会路由到每个模型各自的编辑端点,并遵循各模型的参考图像限制:
| 模型系列 | fal/ 后的模型引用 |
编辑端点 | 最大参考图像数 |
|---|---|---|---|
| Flux 和其他 fal 模型 | fal-ai/flux/dev(默认) |
/image-to-image |
1 |
| GPT 图片 2.5 | openai/gpt-image-2.5/{flare,sunburst}/text-to-image |
兄弟 /edit |
16 |
| 较旧的 GPT 图像 | openai/gpt-image-* |
/edit |
10 |
| Grok 想象一下 | xai/grok-imagine-image |
/edit |
3 |
| Nano Banana(旧版) | fal-ai/nano-banana |
/edit |
3 |
| 纳米香蕉2 | fal-ai/nano-banana-* |
/edit |
14 |
| 纳米香蕉2 Lite | google/nano-banana-2-lite |
/edit |
14 |
| 韩国2号 | krea/v2/{medium,large}/text-to-image |
无(风格参考) | 10 个风格参考 |
GPT 图片 2.5
选择任一变体:
fal/openai/gpt-image-2.5/flare/text-to-imagefal/openai/gpt-image-2.5/sunburst/text-to-image
引用选择同级 /edit 端点。您还可以明确选择 fal/openai/gpt-image-2.5/flare/edit 或 fal/openai/gpt-image-2.5/sunburst/edit。
两种变体都支持 quality: "low"、"medium"、"high"、"xhigh"、"max" 或 "auto"。 fal 默认为 high。他们接受 background: "transparent"、"opaque" 或 "auto"。对于透明度,请使用 outputFormat: "png" 或 "webp"。这些控件不会改变旧的 fal 模型。
使用 size: "auto" 或显式尺寸,例如 1536x864。尺寸必须能被 16 整除,且边缘不得超过 3840 像素。总像素必须为 655,360-8,294,400,长宽比为 1:3 到 3:1。 OpenClaw 将宽高比提示转换为有效尺寸。例如,aspectRatio: "3:2" 生成 1536x1024。使用 size 选择精确尺寸。 OpenClaw 拒绝无效的显式大小。这些模型拒绝 resolution 覆盖。没有几何提示的编辑保留 fal 的自动尺寸选择。
韩国2
Krea 2 模型使用 fal 的原生 Krea 负载架构。OpenClaw 发送 aspect_ratio、creativity 和 image_style_references,而不是 Flux 使用的通用 image_size/编辑端点负载。模型引用为:
fal/krea/v2/medium/text-to-imagefal/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 覆盖项,而不是忽略它。
使用outputFormat: "png"当你想要的时候PNG输出来自fal暴露的模型output_format。外部GPT图像2.5, fal模型没有声明透明背景控件OpenClaw。他们报告background作为被忽略的覆盖。克里亚2端点不暴露output_format请求字段通过fal, so OpenClaw拒绝outputFormat覆盖 Krea 请求。
要使用 Krea 2 Medium:
视频生成
内置的 fal 视频生成提供程序默认使用 fal/fal-ai/minimax/video-01-live。
| 能力 | 值 |
|---|---|
| 模式 | 文本生成视频、单张图像参考、Seedance 参考生成视频 |
| 运行时 | 面向长时间运行任务的队列支持 submit/status/result 流程 |
| 超时 | 默认每个任务 20 分钟;每 5 秒轮询一次状态 |
可用的视频模型
MiniMax(默认):
fal/fal-ai/minimax/video-01-live
HeyGen 视频代理:
fal/fal-ai/heygen/v2/video-agent
Kling 和 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
MiniMax Live 和 HeyGen 请求只发送提示词以及可选的单张参考图像;不会传递其他覆盖项。Seedance 模型接受 aspectRatio、size、resolution、4 到 15 秒的时长,以及音频开关。
Seedance 2.0 配置示例
Seedance 2.0 参考视频配置示例
参考生成视频最多可通过共享的 video_generate images、videos 和 audioRefs 参数接受 9 张图片、3 个视频和 3 个音频参考, 总参考文件数最多为 12 个。音频参考要求同一请求中至少包含一个图片或视频参考。
HeyGen 视频代理配置示例
音乐生成
内置的 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 设为默认音乐提供程序:
fal-ai/minimax-music/v2.6 支持显式歌词和纯音乐模式, 但不能在同一次请求中同时使用。ACE-Step 和 Stable Audio 是 prompt-to-audio 端点;当你需要这些模型系列时, 请使用 model 覆盖来选择它们。ACE-Step 会拒绝显式歌词;Stable Audio 会拒绝歌词和纯音乐模式。