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を送信します。モデルrefは次のとおりです。

• 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で明示的な透明背景コントロールを宣言していないため、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はprompt-to-audioエンドポイントです。これらのモデルファミリーを使いたい場合は、model上書きで選択してください。ACE-Stepは明示的な歌詞を拒否します。Stable Audioは歌詞とインストゥルメンタルモードの両方を拒否します。

関連