Flux 3 API

Black Forest Labs 初のビデオモデルを1つの統合 API で。プロンプト、最大10枚の画像、続きを生成したいクリップから、同期音声付きの 720p / 1080p 動画を最長20秒まで生成できます。単一の REST エンドポイント、非同期ジョブ、Webhook に対応。

Flux 3 を1回のAPIコールで統合できます。1つのキー、1つの統一エンドポイント、そしてApiframe上のすべてのモデルで共通の請求。

APIキーを取得 Apiframe Studioで使う Flux 3 APIドキュメントを見る

model: "flux-3"

Flux 3 の特長

動画1秒あたりの課金

リクエストしたクリップの長さに応じて課金されます。720p は毎秒29クレジット（$0.29）、1080p は毎秒49クレジット（$0.49）で、音声込みです。5秒の 720p クリップは145クレジット（$1.45）、10秒の 1080p クリップは490クレジット（$4.90）です。

音声を同じ処理で生成

環境音・セリフ・効果音が映像と同時に生成され、同期します。追加料金はかかりません。無音にしたい場合はフラグ1つでオフにできます。

1回の生成で最長20秒

5〜20秒の任意の整数秒を指定できます。省略すれば、内容に合った長さをモデルが選びます。

最大10枚の画像でストーリーボード

1枚なら先頭フレームとしてピクセル単位でそのまま使われ、2枚なら最初と最後のフレームを指定、3枚以上ならタイムライン上に均等に配置されるキーフレームになります。

ショットを継続してつなげる

完成した mp4 を start_video として渡すと、その最終フレームから続きを生成します。連鎖させれば1回あたり20秒の上限を超える長さも作れます。

試行中は低コストなドラフト

ドラフトモードなら毎秒10クレジット（$0.10）で高速な 720p プレビューが返ります。本番品質のレートの約3分の1なので、コストをかける前にプロンプトを検証できます。

Flux 3 で試したいプロンプト

Apiframeの Flux 3 API で実行できるプロンプト例です。

夜明けに灯台守がらせん階段を上る。下では波が砕け、風とカモメの声が響く

暖かなランプの下で屋台の店主が麺を盛る。湯気が立ち上り、鉄鍋の音と人々の話し声

無人の劇場をゆっくりとドリー撮影。客席の照明が上がり、光の筋にほこりが舞い、遠くでオーケストラの音合わせ

松林の上空へ上昇し、低い雲へ入っていく空撮。風の音が次第に強まる

概要

エンドポイント: POST /v2/videos/generate
モデルID: flux-3
パラメータキー: flux3Params
モダリティ: 動画
プロバイダー: Black Forest Labs
平均完了時間: ~240s

機能

アスペクト比auto, 16:9, 21:9, 2:1, 4:3, 1:1, 3:4, 9:16

解像度720p, 1080p

長さ5秒, 6秒, 7秒, 8秒, 9秒, 10秒, 11秒, 12秒, 13秒, 14秒, 15秒, 16秒, 17秒, 18秒, 19秒, 20秒

画像入力対応

音声対応

平均時間~240秒

クイックスタート

APIキーを添えて POST /v2/videos/generate に1回リクエストを送るだけで Flux 3 による生成が始まります。レスポンスには、ポーリングまたはWebhookで受け取れる jobId が返ります。

curl -X POST https://api.apiframe.ai/v2/videos/generate \
  -H "X-API-Key: afk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
        "prompt": "a cinematic sunrise over a futuristic cityscape, smooth camera push-in",
        "model": "flux-3",
        "flux3Params": {
            "images": [
                "https://example.com/input.jpg"
            ],
            "start_video": "https://example.com/input.jpg",
            "resolution": "720p",
            "generate_audio": true
        }
    }'

import requests

response = requests.post(
    "https://api.apiframe.ai/v2/videos/generate",
    headers={
        "X-API-Key": "afk_your_api_key_here",
        "Content-Type": "application/json",
    },
    json={
        "prompt": "a cinematic sunrise over a futuristic cityscape, smooth camera push-in",
        "model": "flux-3",
        "flux3Params": {
            "images": [
                "https://example.com/input.jpg"
            ],
            "start_video": "https://example.com/input.jpg",
            "resolution": "720p",
            "generate_audio": True
        }
    },
)
print(response.json())  # { "jobId": "...", "status": "QUEUED" }

const response = await fetch("https://api.apiframe.ai/v2/videos/generate", {
  method: "POST",
  headers: {
    "X-API-Key": "afk_your_api_key_here",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "prompt": "a cinematic sunrise over a futuristic cityscape, smooth camera push-in",
    "model": "flux-3",
    "flux3Params": {
      "images": [
        "https://example.com/input.jpg"
      ],
      "start_video": "https://example.com/input.jpg",
      "resolution": "720p",
      "generate_audio": true
    }
  }),
});
const { jobId } = await response.json();
console.log(jobId);

レスポンスとジョブのライフサイクル

生成は非同期で行われます。送信が成功すると 202 Accepted と jobId が返ります。ステータスが COMPLETED になるまで GET /v2/jobs/{id} をポーリングする（または webhook_url を指定する）と、result フィールドに出力URLが格納されます。

1. 送信レスポンス (202)

{
  "jobId": "b2c3d4e5-f6a7-8901-bcde-f23456789012",
  "status": "QUEUED"
}

2. 結果をポーリング

curl https://api.apiframe.ai/v2/jobs/JOB_ID \
  -H "X-API-Key: afk_your_api_key_here"

import requests, time

while True:
    job = requests.get(
        "https://api.apiframe.ai/v2/jobs/JOB_ID",
        headers={"X-API-Key": "afk_your_api_key_here"},
    ).json()
    if job["status"] in ("COMPLETED", "FAILED"):
        break
    time.sleep(2)
print(job["result"])

let job;
do {
  await new Promise((r) => setTimeout(r, 2000));
  job = await fetch("https://api.apiframe.ai/v2/jobs/JOB_ID", {
    headers: { "X-API-Key": "afk_your_api_key_here" },
  }).then((r) => r.json());
} while (job.status !== "COMPLETED" && job.status !== "FAILED");
console.log(job.result);

入力スキーマ

Flux 3 エンドポイントが受け付けるリクエストパラメータです。モデル固有のオプションは、下記のパラメータオブジェクトの中にネストされます。

パラメータ	型	必須	デフォルト	許可値 / 範囲	説明
prompt	string	必須	—	—	生成する内容のテキスト説明。
model	string	必須	"flux-3"	"flux-3"	このエンドポイントのモデル識別子。
flux3Params.images	string[] (URLs)	任意	—	—	None = text-to-video, one opens the clip, two start and end it, three or more become a storyboard (pick a duration).
flux3Params.start_video	string (URL)	任意	—	—	Continue a clip from its final frames. Cannot be combined with images.
flux3Params.resolution	string	任意	"720p"	"720p", "1080p"	Resolution
flux3Params.generate_audio	boolean	任意	true	—	Synchronized ambient sound, speech, and effects. On by default.
flux3Params.draft	boolean	任意	false	—	Fast, low-cost 720p preview for iterating on a prompt.

よくある質問

Flux 3 APIに関するよくある質問をまとめました。

Flux 3 の動画はどのくらいの長さまで生成できますか？

1回の生成で5〜20秒の任意の整数秒です。duration を省略すると、プロンプトに合う長さをモデルが選びますが、その場合は最大の20秒分で課金されるため、正確な料金を望むなら duration を明示してください。さらに長くしたい場合は、完成したクリップを start_video として渡し、生成を連鎖させます。

Apiframe での Flux 3 の料金は？

動画1秒あたりの課金です。720p は毎秒29クレジット（$0.29）、1080p は毎秒49クレジット（$0.49）で、音声込みです。ドラフトプレビューは毎秒10クレジット（$0.10）。既存動画の続きを生成する場合は 720p が毎秒70クレジット（$0.70）、1080p が毎秒90クレジット（$0.90）です。duration を省略した場合は最大の20秒分で課金されます。

音声も生成されますか？

はい。同期した環境音・セリフ・効果音が映像と同じ処理で生成され、既定でオンです。追加料金はかかりません。無音にする場合は generate_audio を false にしてください。

最初と最後のフレームはどう指定しますか？

flux3Params の images で指定します。1枚なら先頭フレームとしてピクセル単位でそのまま使われ、2枚なら開始と終了を指定します。3枚以上（最大10枚）はクリップ全体に均等配置されるストーリーボードになり、このモードでは duration の明示が必要です。

生成済みの動画を延長できますか？

はい。その URL を flux3Params.start_video に渡すと、最終フレームから続きを生成します。入力は 50MB 以下・15秒以内の mp4 で、images との併用はできません。

Flux 2 との違いは何ですか？

Flux 2 は画像モデルです。Flux 3 は Black Forest Labs の Self-Flow アーキテクチャに基づくマルチモーダルモデルで、画像・動画・音声を横断して学習されており、音声付きの動画を出力します。

対応する解像度とアスペクト比は？

720p または 1080p で、21:9、2:1、16:9、4:3、1:1、3:4、9:16 に対応します。アスペクト比を auto のままにすると、プロンプトと入力からモデルが選びます。

解決しませんでしたか？

サポートに問い合わせる Discordに参加

Flux 3 API で開発を始めよう

APIキーを取得すれば数分で Flux 3 を統合できます — 従量課金。

無料クレジットですぐに開始

すべてのモデルを1つのAPIで

Webhook・SDK・冪等性に対応

プロバイダーのアカウント不要

無料で始めるドキュメントを見る

ご質問はありますか？ Discordに参加または営業に問い合わせる。