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 です。

fal のリクエストスキーマでは、Krea 2 は image_size ではなくアスペクト比を公開します。 aspectRatio の使用を推奨します。OpenClaw は size を最も近い対応済みの Krea アスペクト比にマッピングし、 破棄するのではなく、Krea に対する resolution を拒否します。

output_format を公開している fal モデルから PNG 出力を得るには、outputFormat: "png" を使用します。 OpenClaw では、fal は透明背景を明示的に制御する機能を宣言していないため、 fal モデルでは background: "transparent" が無視された上書きとして報告されます。 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 は 歌詞とインストゥルメンタルモードの両方を拒否します。

関連項目