FLUX 3 Video APIドキュメント
コードからFLUX 3 Videoを呼び出すために必要な情報をすべて掲載しています。ベースURLはhttps://cheapergen.com/api/v1です。まずプレイグラウンドでお試しください。
コーディングエージェントを使いますか?
これをClaude Code、Cursor、Codex、または任意のコーディングエージェントに貼り付けてください。プロジェクトにAPIを追加し、キーをCHEAPERGEN_API_KEYに保存して、支払いが発生する前に無料見積もりでテストします。
Add FLUX 3 Video (CheaperGen endpoint bfl/ flux-3-video/ text-to-video) to this project by following https:/ / cheapergen.com/ agents/ integrate.md認証
ダッシュボード → APIキーでキーを作成し、Bearerトークンとして送信してください。キーはサーバー側で管理してください。
export CHEAPERGEN_API_KEY="cg_live_…"
# every request
Authorization: Bearer $CHEAPERGEN_API_KEYFLUX 3 Video テキストから動画を生成 API
POST
/api/v1/run/bfl/flux-3-video/text-to-video非同期ジョブを送信すると、生成IDを含む202が返されます。GET /api/v1/generations/{id}をポーリングするか、webhook_urlを指定してください。詳細はジョブのライフサイクルをご覧ください。
入力パラメーター
| 名前 | 種類 | 説明 | 料金に影響 |
|---|---|---|---|
prompt必須 | string | ショットを説明してください:被写体、動き、カメラワーク、照明、スタイル。 | いいえ |
aspect_ratio | string (enum) | 出力画像の形状。 値:16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9 · 2:1 デフォルト:16:9 | はい |
duration | integer | 生成クリップの長さ(5〜20秒)。秒単位で課金されます。 範囲:5~20s デフォルト:5 | はい |
generate_audio | boolean | 同期した音声、環境音、セリフを生成します。追加料金はありません。 デフォルト:true | いいえ |
webhook_url | string (URL) | 任意。生成が完了すると、Webhookシークレットで署名してここにPOSTします。Webhook | いいえ |
リクエスト
const API = "https://cheapergen.com/api/v1";
const headers = {
Authorization: `Bearer ${process.env.CHEAPERGEN_API_KEY}`,
"Content-Type": "application/json",
};
// 1. Submit the job
let job = await fetch(`${API}/run/bfl/flux-3-video/text-to-video`, {
method: "POST",
headers,
body: JSON.stringify({
"prompt": "日の出のカッパドキア上空を熱気球が漂い、バーナーが鳴り響く。カメラはバスケットに沿って上昇。",
"aspect_ratio": "16:9",
"duration": 5
}),
}).then((r) => r.json());
// 2. Poll until it finishes (or pass webhook_url and skip polling)
while (job.status === "queued" || job.status === "running") {
await new Promise((r) => setTimeout(r, 3000));
job = await fetch(`${API}/generations/${job.id}`, { headers }).then((r) => r.json());
}
console.log(job.status === "succeeded" ? job.output.video.url : job.error);レスポンス
{
"id": "gen_8c2QmX1nq0k4",
"object": "generation",
"model": "bfl/flux-3-video",
"endpoint": "bfl/flux-3-video/text-to-video",
"mode": "text-to-video",
"status": "queued",
"input": {
"prompt": "日の出のカッパドキア上空を熱気球が漂い、バーナーが鳴り響く。カメラはバスケットに沿って上昇。",
"aspect_ratio": "16:9",
"duration": 5
},
"output": null,
"error": null,
"cost": {
"amount_usd": 0.2255,
"currency": "usd",
"estimated": true,
"official_usd": null,
"list_price_source": "reference",
"list_price_label": "fal API",
"saved_usd": null
},
"source": "api",
"started_at": null,
"completed_at": null,
"urls": {
"get": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4",
"cancel": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4/cancel"
},
"created_at": "2026-10-15T09:21:04Z"
}FLUX 3 Video 画像から動画を生成 API
POST
/api/v1/run/bfl/flux-3-video/image-to-video非同期ジョブを送信すると、生成IDを含む202が返されます。GET /api/v1/generations/{id}をポーリングするか、webhook_urlを指定してください。詳細はジョブのライフサイクルをご覧ください。
入力パラメーター
| 名前 | 種類 | 説明 | 料金に影響 |
|---|---|---|---|
prompt必須 | string | ショットを説明してください:被写体、動き、カメラワーク、照明、スタイル。 | いいえ |
image_url必須 | string (URL) | 開始フレームに使う画像。JPG/PNG/WebP、URLまたはアップロード。 | いいえ |
end_image_url | string (URL) | 任意の終了フレーム。モデルが2つのフレームの間を動画にします。 | いいえ |
duration | integer | 生成クリップの長さ(5〜20秒)。秒単位で課金されます。 範囲:5~20s デフォルト:5 | はい |
generate_audio | boolean | 同期した音声、環境音、セリフを生成します。追加料金はありません。 デフォルト:true | いいえ |
webhook_url | string (URL) | 任意。生成が完了すると、Webhookシークレットで署名してここにPOSTします。Webhook | いいえ |
リクエスト
const API = "https://cheapergen.com/api/v1";
const headers = {
Authorization: `Bearer ${process.env.CHEAPERGEN_API_KEY}`,
"Content-Type": "application/json",
};
// 1. Submit the job
let job = await fetch(`${API}/run/bfl/flux-3-video/image-to-video`, {
method: "POST",
headers,
body: JSON.stringify({
"prompt": "花がつぼみから満開になるまで、ゆっくり寄りながら撮影してください。",
"image_url": "https://cdn.cheapergen.com/samples/portrait.jpg",
"duration": 5
}),
}).then((r) => r.json());
// 2. Poll until it finishes (or pass webhook_url and skip polling)
while (job.status === "queued" || job.status === "running") {
await new Promise((r) => setTimeout(r, 3000));
job = await fetch(`${API}/generations/${job.id}`, { headers }).then((r) => r.json());
}
console.log(job.status === "succeeded" ? job.output.video.url : job.error);レスポンス
{
"id": "gen_8c2QmX1nq0k4",
"object": "generation",
"model": "bfl/flux-3-video",
"endpoint": "bfl/flux-3-video/image-to-video",
"mode": "image-to-video",
"status": "queued",
"input": {
"prompt": "花がつぼみから満開になるまで、ゆっくり寄りながら撮影してください。",
"image_url": "https://cdn.cheapergen.com/samples/portrait.jpg",
"duration": 5
},
"output": null,
"error": null,
"cost": {
"amount_usd": 0.2255,
"currency": "usd",
"estimated": true,
"official_usd": null,
"list_price_source": "reference",
"list_price_label": "fal API",
"saved_usd": null
},
"source": "api",
"started_at": null,
"completed_at": null,
"urls": {
"get": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4",
"cancel": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4/cancel"
},
"created_at": "2026-10-15T09:21:04Z"
}結果を取得する
生成処理は非同期です。statusがsucceeded、failed、またはcanceledになるまでポーリングしてください。送信時にwebhook_urlを指定する方法もあります。失敗した生成は自動返金されます。
curl https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4 \
-H "Authorization: Bearer $CHEAPERGEN_API_KEY"その他:ジョブのライフサイクル · Webhook · エラー
FLUX 3 Videoの料金
従量課金: 動画1秒あたりを使った分だけ支払えます。サブスクリプションは不要です (月額プランは任意)。生成に失敗した場合は自動で返金されます。
| プラン | fal API | CheaperGen | 節約額 |
|---|---|---|---|
720p 音声付き | $0.1564/s | −8% |
- fal API:falが公開するFLUX 3 Videoの720p料金(音声込みで1秒あたり$0.17) — https://fal.ai/models/blackforestlabs/flux-3/text-to-video。価格確認日:2026年10月21日。
- 1080p以上はまだ提供していません。現時点では参照価格より安く提供できないためです。