Skip to main content
FLUX 3 Video の API リファレンス。FLUX 3 Video は Black Forest Labs のビデオ生成モデルで、テキストプロンプトから同期したオーディオ付きの短いクリップを生成します。

クイックスタート

Comfy ワークスペースでキーを作成し、COMFY_API_KEY としてエクスポートします。Python と TypeScript のスニペットは Comfy SDK(pip install comfy-sdknpm install @comfyorg/sdk)を使用しています。cURL のスニペットは、同じ呼び出しを生の HTTP で行うものです。 モデル ID: bfl/flux-3-video エンドポイント: POST https://api.comfy.org/v2/models/bfl/flux-3-video

スキーマ

入力

string
デフォルト:"\"auto\""
出力アスペクト比: auto、21:9、2:1、16:9、4:3、1:1、3:4、または 9:16。auto を指定すると、BFL がプロンプトと参照素材から選択します。
boolean
デフォルト:"false"
ドラフトモード: 高速なプレビューを生成します。その結果には draft_cache のダウンロード URL が含まれます。そのバンドルを mode draft_enhance とともに送り返すと、同じ生成のフル品質版がレンダリングされます。
string
draft_enhance 専用。以前のドラフト生成で得られた暗号化されたドラフトキャッシュバンドルを、base64 エンコードされたダウンロード済みバンドル、またはまだ有効な http(s) URL として指定します。元の入力はバンドルに埋め込まれています。
integer | string
デフォルト:"\"auto\""
ビデオの再生時間(秒、5 から 20 までの任意の整数秒)、またはコンテンツに合わせる場合は auto。範囲: 5 から 20
boolean
デフォルト:"true"
ビデオと同時に同期オーディオを生成します。
string | number | string[] | string[] | number | string[][]
i2v 専用。ビデオのフレームとなる画像で、それぞれ http(s) URL または base64、合計 1 枚から 10 枚です。単一の画像、画像のリスト(1 枚ならビデオの開始、2 枚なら開始と終了、それ以上は均等に配置され、再生時間の指定が必要)、またはタイムスタンプ付きの [秒, 画像] ペアを時系列順に指定できます。例: [[0, ”…”], [3.5, ”…”] ]。ペアは 2 要素の配列で、最初が秒数、次が画像です。
string
必須
生成モード: t2v(テキストから動画へ)、i2v(画像からの継続)、v2v(ビデオからの継続)、または draft_enhance(以前のドラフトのフル品質レンダリング)。text-to-video のような省略しない別名も受け付けます。
string
ビデオを記述する自由形式のプロンプト。draft_enhance を除くすべてのモードで必須です。
string
ビデオの解像度クラス: hd、またはビデオアップサンプラーで仕上げられた高解像度の結果を得る fhd。デフォルトは t2v、i2v、v2v では hd、draft_enhance では fhd です。正確な寸法はアスペクト比によって異なります。指定可能な値: hd, fhd
integer
デフォルト:"2"
入力および出力の有害性モデレーションの許容値で、0 が最も厳格です。性的コンテンツは要求された許容値にかかわらずレベル 3 に、ヘイトコンテンツはレベル 2 に制限されます。条件付けメディアを含むリクエストはレベル 2 に制限されます。範囲: 0 から 4
string
v2v 専用。継続するビデオで、http(s) URL または base64 MP4 です。生成されるクリップはその最終フレームから続きます。
string
デフォルト:"\"latest\""
エンドポイントのバージョン。latest は現在のリリースを提供し、日付付きの固定可能なリリースタグは公開され次第追加されます。
この内容は、Router が GET /v2/models/bfl/flux-3-video/openapi.json で提供するスキーマから生成されたもので、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する対象となるドキュメントと同じものです。

出力

number
プロバイダーが報告するクレジット単位のコスト。タスクが Ready になると設定されます。形式: float
string
必須
BFL のタスク識別子。
number
BFL が報告する任意の生成進捗。範囲: 0 から 1形式: float
object
必須
完了した生成。2 つの URL リーフのうち、どちらか一方だけが設定されます。デフォルトモードでは sampledraft: true モードでは draft_cache です。
number
プロバイダーが報告するタスクコスト。これは BFL の数値であり、Comfy の課金ではありません。形式: double
string (uri)
draft: true モードで sample の代わりに返される署名付き URL。sample と同じ方法で Comfy ストレージに再ホストされます。通常は最大 24 時間有効な Comfy ホストの URL で、再ホストを実行できなかった場合は BFL 自身のおおよそ 2 時間有効な配信 URL になります。形式: uri
string (uri)
生成された MP4 の署名付き URL。Router はアセットを Comfy ストレージに再ホストしてこのフィールドを書き換えるため、通常は最大 24 時間有効な Comfy ホストの URL になります。発行時に 24 時間で署名され、23 時間のメモから再生されるため、後でのポーリングでは残り 1 時間しかない URL が返されることがあります。再ホストを実行できなかったリーフは、代わりに BFL 自身のおおよそ 2 時間有効な配信 URL を保持します。draft: true モードでは存在しません。形式: uri
string
必須
タスクのステータス: Pending、Reasoning、Generating、Ready、Request Moderated、Content Moderated、Error、または Task not found。大文字と小文字を区別せずに比較してください。Router は BFL の表記をそのまま転送します。

入力

出力

result.sample は通常、Comfy がホストする署名付き URL で、作成から最大 24 時間有効です。リプレイでは古い URL が返されることがあり、再ホストできなかったアセットは有効期間の短いプロバイダー URL のままになります。リンクを保存せず、MP4 を速やかにダウンロードしてください。draft: true の場合は、result.sample を期待するのではなく result.draft_cache を参照してください。

出荷前の確認

SDK は Idempotency-Key を生成し、自動リトライで再利用します。手動リトライでは元のキーを再利用してください。Router は最大 10 分間接続を保持できます。 リクエストが失敗すると、Router は理由を示す X-Comfy-Error-Type レスポンスヘッダーを送信します。422 は、プロバイダーを呼び出す前に Router が入力を拒否したことを意味します。生成されたアセットは 結果 URL の有効期限 があるため、早めにダウンロードしてください。

ヘッダー

認証、冪等性、リクエスト ID、エラー分類、リトライ間隔、支出上限。

Router API の利用

モデルの検出、バリデーションエラー、リトライ、課金。

制限事項

Router が現在対応していないことと、代替手段。