FLUX.3 動画 API の使い方は？テキスト生成・画像生成・動画延長の中国語チュートリアル

TL;DR

• FLUX.3 Video は Black Forest Labs の動画モデルで、HiAPI 上ではモデル名は flux-3 ひとつだけ。テキストからの動画生成、画像からの動画生成（キーフレーム1〜10枚）、動画延長のすべてに対応し、1本あたり5〜20秒、デフォルトで音声も同期されます。モデルページを開く とオンラインで生成でき、新規ユーザー登録で200クレジットが付与されます。
• 秒単位の課金：720p は毎秒 $0.25、1080p は毎秒 $0.42。Draft プレビューモードなら毎秒わずか $0.09。5秒の Draft プレビューで $0.45。
• プロンプトを調整するときは必ず先に draft: true を有効に：必須項目は prompt だけですが、他のパラメータを書かなくても正式プランで課金されます。

まずは仕上がりをチェック

モデルページのサンプル、720p、5秒、音声あり：

A silent maglev train glides through a vast solar-panel field at golden hour, reflective silver body catching warm directional light, low tracking shot alongside the train, distant maintenance drones crossing the sky, cinematic composition, rich cohesive color grade, premium commercial finish, subtle film grain, high dynamic range, smooth natural motion, stable cinematic camera movement, consistent lighting across frames

このプロンプトで生成 →（5秒、720p）

flux-3 モデルページのサンプル、720p、5秒、音声あり。正式プランなら $1.25、Draft プレビューなら $0.45。

価格

モード	720p / 秒	1080p / 秒
正式生成（テキスト生成・画像生成）	$0.25	$0.42
Draft プレビュー	$0.09	非対応
動画延長（start_video を渡す）	$0.59	$0.76
Draft + 動画延長	$0.18	非対応

HiAPI の現行価格、2026年10月15日確認。音声のオン・オフは価格に影響しません。

長さ	Draft 720p	正式 720p	正式 1080p
5秒	$0.45	$1.25	$2.10
10秒	$0.90	$2.50	$4.20
20秒	$1.80	$5.00	$8.40

おすすめの流れ：Draft でプロンプトと動きを調整し（1本 $0.45 から）、確定後に正式プランで 720p または 1080p を出力します。

curl：まず Draft を1本実行

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-3",
    "input": {
      "prompt": "一架纸飞机滑过洒满阳光的办公室，慢动作，镜头跟随",
      "duration": 5,
      "aspect_ratio": "16:9",
      "draft": true
    }
  }'

5秒の Draft で $0.45。taskId が返ってきたら結果を取得：

curl https://api.hiapi.ai/v1/tasks/tk-hiapi-... \
  -H "Authorization: Bearer $HIAPI_KEY"

status が success になったら、output[0].url から動画をダウンロードします。音声はすでに同じ MP4 に合成されています。

Python：送信、ポーリング、ダウンロード

# pip install requests；先 export HIAPI_KEY=你的 Key
import os, time, uuid, requests

KEY = os.environ["HIAPI_KEY"]
H = {"Authorization": f"Bearer {KEY}"}

def generate(timeout_s=900, **params):
    body = {"model": "flux-3", "input": params}
    # 重试提交同一个任务时带同一个 Idempotency-Key，避免重复扣费
    headers = {**H, "Idempotency-Key": str(uuid.uuid4())}
    r = requests.post("https://api.hiapi.ai/v1/tasks", json=body, headers=headers, timeout=30)
    r.raise_for_status()
    res = r.json()
    if res.get("code") != 200:
        raise RuntimeError(res)
    task_id = res["data"]["taskId"]
    deadline = time.time() + timeout_s
    while time.time() < deadline:
        d = requests.get(f"https://api.hiapi.ai/v1/tasks/{task_id}", headers=H, timeout=30).json()["data"]
        if d["status"] == "success":
            return d["output"][0]["url"]
        if d["status"] == "fail":
            raise RuntimeError(d)
        time.sleep(10)
    raise TimeoutError(task_id)

# 定稿后出正式 1080p
url = generate(
    prompt="一架纸飞机滑过洒满阳光的办公室，慢动作，镜头跟随",
    duration=8, resolution="1080p", aspect_ratio="16:9",
)
with open("clip.mp4", "wb") as f:
    f.write(requests.get(url).content)

これは8秒の 1080p で $3.36。

画像からの動画生成：先頭フレーム1枚、または最大10枚のキーフレーム

input に images（image_urls ではない）を追加し、枚数によって使い方が変わります：

• 1枚：先頭フレーム。
• 2枚：先頭フレーム＋末尾フレーム。モデルが間の遷移を補完します。
• 3〜10枚：キーフレームのストーリーボード。動画全体に均等に配置されます。

{
  "model": "flux-3",
  "input": {
    "prompt": "从日出平滑过渡到霓虹闪烁的夜晚城市，镜头稳定",
    "images": [
      "https://your-cdn.example.com/start.webp",
      "https://your-cdn.example.com/end.webp"
    ],
    "resolution": "1080p",
    "duration": 8
  }
}

画像は PNG、JPEG、WebP に対応。画像からの動画生成とテキストからの動画生成は同価格です。

動画延長：既存の動画の続きを撮る

start_video を渡すと、モデルはこの動画の末尾から生成を続けます：

{
  "model": "flux-3",
  "input": {
    "prompt": "镜头继续向前推进，列车驶入明亮的山间隧道",
    "start_video": "https://your-cdn.example.com/source.mp4",
    "duration": 5,
    "draft": true
  }
}

• start_video は MP4 のみ対応、最長15秒、最大50 MB。
• images と start_video は同時に渡せません。
• 延長は単価が高め：720p は毎秒 $0.59、Draft 延長は毎秒 $0.18。

パラメータ一覧

パラメータ	値	説明
prompt	文字列、必須	シーン、動作、カメラワーク、セリフ、音声をすべてここに記述
duration	5〜20 の整数、デフォルト 5	単位は秒
resolution	720p / 1080p、デフォルト 720p	Draft は 720p のみ。Draft と 1080p の組み合わせは拒否されます
aspect_ratio	auto 21:9 2:1 16:9 4:3 1:1 3:4 9:16、デフォルト auto
draft	デフォルト false	低価格プレビュープラン
generate_audio	デフォルト true	オフにすると無音動画を出力。価格は変わりません
images	最大10枚	画像からの動画生成
start_video	MP4 の URL	動画延長

本番運用前の注意点

• ポーリングではなくコールバックを使う：リクエストのトップレベル（input と同じ階層）に "callback": {"url": "https://你的域名/hiapi/callback"} を追加し、taskId で重複排除します。
• 速やかに転送・保存：output[0].url は一時リンクなので、取得後すぐに自分のストレージへ保存してください。
• リトライには冪等キーを付ける：リクエストヘッダーに Idempotency-Key を追加すると、同じキーでのリトライはタスクが1回だけ作成され、二重課金されません。
• 失敗時は自動返金：成功した動画の生成分のみ課金されます。

よくある質問

1本の最長はどれくらい？

20秒です。より長くしたい場合は動画延長で続きを生成してください。

音声はオフにできる？オフにすると安くなる？

できます。generate_audio: false を指定します。価格は解像度、Draft、延長かどうかだけで決まり、音声をオフにしても安くなりません。

Draft と正式プランの差はどれくらい？

720p で毎秒 $0.09 対 $0.25、Draft は約64%安く、生成も速いのでプロンプト調整に適しています。

モデル名に /text-to-video のサフィックスがないのはなぜ？

FLUX.3 はテキスト生成、画像生成、延長をひとつの flux-3 に統合し、images や start_video を渡すかどうかで区別します。

まず1本試したい方は、モデルページで生成してみてください。他の動画モデルの価格比較は料金ページをご覧ください。