はじめに
FLUX 3 テキストから動画は Black Forest Labs の動画モデルで、API は 2026 年 8 月 4 日に公開されます。文章のプロンプトから、同期したサウンド付きの 5〜20 秒のクリップを、720p または 1080p、7 種類の形で生成します。最低価格でショットを確認できる高速なドラフト段階も備えています。
素材から使うモードを選ぶ
| お手元にあるもの | モード |
|---|---|
| 文章の企画 | FLUX 3 Text to video |
| 動かしたい静止画(任意で最後のフレーム付き) | FLUX 3 Image to video |
| 続きを作りたいクリップ | FLUX 3 Video extend |
| 拡大したいクリップ | FLUX 3 Video upscale |
主な機能とハイライト
映像とサウンドを一緒に
サウンドは映像と同じ処理で生成されます。引用符付きの台詞は私たちのプロンプトと一字一句一致し、Sound: の行で雨や足音などの環境音を調整できます。サウンドをオフにしても料金は同じです。
ドラフト段階
ドラフトは常に 720p の、高速で低コストなプレビューです。ディテールは標準より柔らかくなりますが、本番のレンダリング前に構図、動き、ムードを判断するには十分です。
秒単位の課金
価格は長さと段階で決まります。ドラフトが最も安く、次に標準 720p、標準 1080p の順です。アスペクト比とサウンドの設定は価格に影響せず、拒否されたリクエストや失敗したリクエストは課金されません。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | 最大 5,000 文字。被写体、動き、カメラ、光、サウンドを書き、環境音には Sound: の行を足し、話される言葉は引用符で囲みます。 1 文字以上 · 5000 文字以内 |
aspect_ratio | いいえ | 16:9(既定)、9:16、1:1、4:3、3:4、21:9、2:1 のいずれか。形は価格に影響しません。 |
quality | いいえ | standard(既定)は選んだ解像度でレンダリングします。draft は常に 720p ( |
resolution | いいえ | 720p(既定)または 1080p。1080p は高くなります。 |
duration_seconds | いいえ | 長さを 5〜20 の整数秒で指定します。既定は 5 秒です。 |
generate_audio | いいえ | 映像と同期したサウンドを生成します。既定はオンで、オフにすると無音のファイルになります。 デフォルト値: |
料金
動画 1 秒あたりで、段階ごとに課金されます。ドラフトが最も安く、次に標準 720p、標準 1080p の順です。サウンドのオンとオフは同額で、アスペクト比も価格に影響しません。拒否されたリクエストと失敗したリクエストは課金されません。
| 解像度 | 品質: ドラフト | 品質: 標準 |
|---|---|---|
| $0.06 / 秒 | $0.29 / 秒 |
| $0.06 / 秒 | $0.17 / 秒 |
ユースケース
台詞とムードのシーン
登場人物 1 人、台詞 1 つ、部屋の音、ゆっくりしたカメラワーク。
絵コンテ
各ショットをドラフトでプレビューし、残すものだけ作り直します。
SNS と縦長のクリップ
9:16 と 1:1 を標準で備え、21:9 と 2:1 はワイドなシネマティックな画面に対応します。
プロンプトガイドと実践のヒント
ショットのように書く
被写体と衣装、場所、動き、カメラワーク、光の順に書き、最後に Sound: で始まる行を置きます。
台詞は引用符で囲む
話される言葉は、聞きたい言語で引用符に入れてください。
1 クリップにつき 1 つの動き
明確な動き 1 つとカメラワーク 1 つがいちばん破綻しにくく、光や場所の大きな変化はカットやディゾルブの原因になります。
まずドラフトで
ドラフトで構図を整えてから、同じプロンプトを標準で実行します。
コンテンツの範囲を理解しておく
描画されるのは軽めのレベルの見た目だけで、それより強いものは拒否され、課金されません。
API クイックスタート
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "black-forest-labs/flux-3/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"quality": "standard",
"resolution": "720p",
"aspect_ratio": "16:9",
"duration_seconds": 5
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
認証、完全なスキーマ、ポーリング、エラー処理は API リファレンスを参照してください。


























