Fal

OpenClaw には、ホスト型の画像、動画、音楽生成用の fal プロバイダーが同梱されています。

はじめに

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

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

画像生成

同梱の fal 画像生成プロバイダーは、デフォルトで fal/fal-ai/flux/dev を使用します。

編集リクエスト（共通の image / images パラメーターによる参照画像）は、 モデルごとの参照数制限が設定された、各モデル専用の編集エンドポイントにルーティングされます。

Krea 2 モデルは、fal ネイティブの Krea ペイロードスキーマを使用します。OpenClaw は、 Flux で使用する汎用の image_size / 編集エンドポイント用ペイロードではなく、 aspect_ratio、creativity、image_style_references を送信します。モデル参照は次のとおりです。

• 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: {      imageGenerationModel: {        primary: "fal/krea/v2/medium/text-to-image",      },    },  },}

動画生成

同梱の fal 動画生成プロバイダーは、デフォルトで fal/fal-ai/minimax/video-01-live を使用します。

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

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

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

音楽生成

同梱の fal Plugin は、共通の music_generate ツール用の音楽生成プロバイダーも登録します。

fal をデフォルトの音楽プロバイダーとして使用するには、次のように設定します。

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

fal-ai/minimax-music/v2.6 は、明示的な歌詞とインストゥルメンタルモードに対応していますが、 同じリクエストで両方を指定することはできません。ACE-Step と Stable Audio は、 プロンプトから音声を生成するエンドポイントです。これらのモデルファミリーを使用する場合は、 model の上書きで選択してください。ACE-Step は明示的な歌詞を拒否し、Stable Audio は 歌詞とインストゥルメンタルモードの両方を拒否します。

関連項目