fal/flux-3-max の API リファレンスです。Comfy Router が fal から提供します。
入力: テキスト、画像 · 出力: ビデオ + オーディオ
クイックスタート
Comfy ワークスペースでキーを作成し、COMFY_API_KEY としてエクスポートします。Python と TypeScript のスニペットは Comfy SDK(pip install comfy-sdk と npm install @comfyorg/sdk)を使用しています。cURL のスニペットは同じ呼び出しを生の HTTP で行うものです。
モデル ID: fal/flux-3-max
エンドポイント: POST https://api.comfy.org/v2/models/fal/flux-3-max
- 結果を待つ
- キューに入れて後で収集する
同じボディを
POST https://api.comfy.org/v2/models/fal/flux-3-max/requests に送信します。Router は実行が受け付けられるとすぐに 201 と request_id を返し、結果は準備ができ次第、このプロセスまたは別のプロセスから収集されます。キューの配信では、ステータス、キャンセル、収集について順を追って説明します。スキーマ
入力
string
デフォルト:"\"auto\""
生成されるビデオのアスペクト比。auto の場合、テキストプロンプトでは 16:9 になり、それ以外では最初の画像に従います。指定可能な値:
auto、21:9、2:1、16:9、4:3、1:1、3:4、9:16integer
デフォルト:"5"
生成されるビデオの再生時間(秒)。5 から 20 まで。fal はこの値の秒数に応じて課金します。範囲:
5 から 20boolean
デフォルト:"true"
同期されたオーディオを生成します。料金は同じです。
string
必須
ビデオとそのサウンドを説明するテキストプロンプト。
string
デフォルト:"\"high\""
生成前にモデルがプロンプトについてどれだけ推論し、展開するか。high はより低速です。料金は同じです。指定可能な値:
low、highstring
デフォルト:"\"720p\""
生成されるビデオの解像度。1080p は 720p より 1 秒あたりの料金が高くなります。指定可能な値:
720p、1080pinteger
ランダムシード。省略した場合はランダムなシードが選択されます。
GET /v2/models/fal/flux-3-max/openapi.json で提供するスキーマから生成されています。これはリクエストがプロバイダーに到達する前に Router が呼び出しを検証する際に使用するものと同じドキュメントです。
出力
integer
生成に使用されたシード。
object
秒単位のタイミング内訳。
object
必須
生成されたビデオファイル。
string
ビデオファイルの MIME タイプ。
number
ビデオの再生時間(秒)。
string
ビデオファイルの名前。
integer
ビデオファイルのサイズ(バイト)。
number
ビデオのフレームレート。
integer
ビデオの高さ(ピクセル)。
integer
ビデオのフレーム数。
string
必須
生成されたビデオの URL。
integer
ビデオの幅(ピクセル)。
例
入力
出力
出荷前の確認
SDK はIdempotency-Key を生成し、自動リトライで再利用します。手動リトライでは元のキーを再利用してください。Router は最大 10 分間接続を保持できます。
リクエストが失敗すると、Router は理由を説明する X-Comfy-Error-Type レスポンスヘッダーを送信します。422 は、プロバイダーを呼び出す前に Router が入力を拒否したことを意味し、413 はリクエスト本文が Router の受け入れ可能なサイズを超えていたことを意味します。生成されたアセットは 結果 URL の有効期限 があるため、早めにダウンロードしてください。
上記のフィールド説明に記載されているサイズ制限は、プロバイダーの仕様から引用した、そのフィールドに対するプロバイダー自身の上限です。Router はリクエスト本文全体に対して別の上限を適用し、base64 エンコードされたメディアもこれにカウントされます。リクエスト本文のサイズ を参照してください。
このページは、Comfy Router 経由で呼び出す 1 つのパートナーモデルについて説明しています。同じ comfy-sdk / @comfyorg/sdk パッケージには、Comfy Cloud 上で ComfyUI のワークフローグラフ全体を実行するための 2 つ目のクライアントも含まれています: Comfy(api_key=...) / new Comfy({ apiKey })、および client.workflows、client.assets、client.jobs。Comfy SDKs を参照してください。
ヘッダー
認証、冪等性、リクエスト ID、エラー分類、リトライ間隔、支出上限。
Router API の利用
モデルの検出、バリデーションエラー、リトライ、課金。
制限事項
Router が現在対応していないことと、代替手段。