Skip to main content
POST

認証

string
必須
すべてのエンドポイントは Bearer Token 認証が必要ですAPI Key 管理ページ で API Key を取得してください:

生成モード

flux-3-video統一エントリです。フィールドからモードを推定するか、mode で明示指定できます。 mode の値:t2v / i2v / v2v / draft_enhance、または公式表記 text-to-video / image-continuation / video-continuation明示的な mode が最優先です。

画像から動画のキーフレーム意味

image_urls の順序が意味を持ちます — 並べ替えや重複排除をしないでください:

リクエストパラメータ

string
必須
固定値:flux-3-video
string
必須
プロンプト。draft_from_task_id 使用時は送信禁止(送信すると拒否されます)。
integer
デフォルト:"5"
長さ(秒)、整数 5~20、デフォルト 5
duration: "auto" は非対応です(課金に固定秒数が必要)。省略、"auto"、非整数 → エラーなく 5 秒として扱い、自動適応はしません。
動画継続では、実際の出力がリクエスト秒数より短くなる場合があります(例:5 秒要求で 4 秒)。要求秒数で仮請求し、完了後に差分を返金します。最終金額は照会の cost が基準です。テキスト/画像から動画ではこの差は出ません。
string
デフォルト:"hd"
解像度
  • hd(デフォルト、720p も可)
  • fhd1080p も可)
実測:hd は 16:9 で約 1280×704、fhd は約 1920×1088。
ドラフトモード(draft:true)は hd のみ許可。
string
デフォルト:"auto"
アスペクト比選択肢:21:92:116:94:31:13:49:16、または auto(デフォルト、プロンプトと素材から自動選択)
string[]
画像から動画のキーフレーム、1~10、公開 http(s) URL または base64
string
継続用の入力動画(mp4、公開 URL または base64)
string[]
video_url と同じ、先頭の要素を使用(互換用)
boolean
デフォルト:"true"
同期音声を生成、デフォルト truefalse は無音動画(値引きなし
boolean
デフォルト:"false"
ドラフトモード:約 1/3 価格の低品質プレビュー、resolution: hd のみ
string
ドラフト → 本編:自分の成功済みドラフトタスク ID
  • 変更可能なのは resolution のみ、プロンプト・長さ・画像・動画は変更不可
  • 本編の正規価格で課金、ドラフト料金は相殺されません
  • draft:true相互排他
integer
デフォルト:"2"
モデレーション許容度 0~4、デフォルト 2(大きいほど緩い)
FLUX.2 画像(05)や Kontext(06)と混同しないでください。
string
明示モード(任意)、生成モードを参照

ドラフトモード

反復が高コストな場合の二段階ワークフロー:

ドラフト作成

ドラフトから本編

ドラフトから本編へは、ドラフトに保存されたパラメータ(モード / プロンプト / シード / 素材)でフル品質レンダリングします。継続ドラフトの本編は継続の本編単価で課金されます。

リクエスト例

テキストから動画(縦向き)

画像から動画(開始 + 終了フレーム)

動画継続

無音動画

制約

よくある送信エラー(通常は課金なし)

モデレーション失敗は failed 終了となり全額返金されます。

機能カバレッジ

Response

integer
ステータスコード、成功時は 200
array
レスポンスデータ配列
結果の照会動画生成は非同期です。タスク状態の取得 でポーリングしてください。推奨間隔 5~10 秒、クライアントタイムアウト 15 分(20 秒 fhd はより遅い)。実測 t2v + hd + 5 秒で約 60 秒。成功時は result.videos[0].url を使用。成果物はプラットフォーム CDN にミラーされます。cost が最終請求額です。失敗時は全額返金。