Black Forest Labs: FLUX Video Upscale
FLUX Video Upscale は、元映像に忠実な、または創造的な細部強化によって既存クリップを拡大します。文書化された仕様は 1.5~3 倍の拡大に対応し、元の音声とフレーミングを維持しながら、元動画の長さ、入力解像度、出力フレーム面積を制限します。
モデルについて
この説明はモデルの機能を紹介するものです。Ailootで利用できる入力、出力、オプションは、選択したメソッドごとに以下に記載されています。
FLUX Video Upscale は、Black Forest Labs の FLUX 3 を使った動画超解像ワークフローです。既存クリップを受け取り、元のフレーミングと音声を引き継いだ拡大 MP4 を返します。任意の短い説明で、強化する視覚的な細部を誘導できます。2 つのモードは、すべての大きな画像を同等に忠実な再構成と見なすのではなく、入力外観に近づけるか、より積極的に細部を生成するかという重要な選択を設けます。
精密または創造的な強化を選ぶ
creativity 設定でモードを選びます。値 0 は精密で元映像に忠実な仕様です。メーカーは、顔、製品、ブランド素材の同一性を保つ必要がある場合に推奨しています。値 1 は創造的な細部強化を有効にし、既定値です。より積極的に質感を復元・創作でき、生成映像、風景、群衆、細部を創造的に発展させられる表面に役立ちます。
メーカーは、創造的な強化では顔や製品を同じ厳密さで保てないと明記しています。顔の外観、製品の輪郭、文字、素材模様、ロゴなど、識別可能なまま保つ必要がある特徴を確認してください。より鮮明に見えても、変わった細部や新しく創作された細部を含む場合があります。製品実演では、質感が精巧という理由だけで版を選ばず、意図した製品外観を確認基準にします。
任意のプロンプトは、強化を誘導するためクリップの内容を説明します。空の説明は中立的な拡大を要求します。元の生成シーンの指示なら、苔に覆われた石壁、柔らかな昼光、細かな葉の質感を指定できます。精細化する素材についての言葉にとどめてください。物体の置換、設定の再構築、台詞の変更は編集の判断に属し、この仕様は元の音声トラックを保ちます。
倍率と出力フレーム面積
文書化された upscale_factor の範囲は 1.5~3、既定は 2 です。アスペクト比を保って元解像度を拡大します。選択倍率と入力寸法で目的の出力が決まるため、横長クリップも縦構図も実際のフレームから計画してください。どの程度の拡大が有用かを選ぶ前に、目標の表示サイズを準備します。
厳密な仕様は、出力の各フレームをメーカー定義のメガピクセル単位で 13.75 に制限します。文書は 1 単位を 1,048,576 ピクセルと定義しており、上限は 14,417,920 ピクセル、約 1,440 万です。これがガイドの丸めた 14.4 メガピクセルという表記を説明します。そのため大きな元映像では、要求倍率より小さい拡大になる場合があります。3 倍の要求が常に各辺を 3 倍にすると考えず、届いた寸法を確認してください。
公開された元解像度の上限は 2560×1440 です。このワークフローは対象となる元映像を 4K 以上へ拡大しますが、高い出力が欲しいというだけで、すでに上限を超える元映像を受け付けるわけではありません。この仕様を使う前に縮小するか、適切な作業用コピーを準備します。最終比較がリサイズした中間素材だけにならないよう、元録画を別途保管してください。
短く読み取りやすい元映像を準備する
メーカーの通常の準備ガイドは、元映像を 20 秒、50 MB までに制限します。クリップは動画 URL またはエンコード済み MP4 で渡します。厳密な参照文書は、最初の 20 秒を処理すると記しています。わずかな長さ超過ならそこまでだけ処理される場合があり、大幅に長いクリップは拒否されます。数値的な許容幅は公開されていません。未指定の境界挙動に依存せず、意図した 20 秒以内の区間へトリミングしてください。
利用できる中で最も圧縮の少ない版を選びます。圧縮ノイズはアップスケーラーが復元できる実在の細部を制限し、創造的な強化は元シーンに何があったかを確立せず、もっともらしい質感を作れます。選択クリップを拡大する前に、意図した編集とトリミングを完了してください。例えば、まず製品ショットを仕上げ、有用な行動区間を選び、比較用に未変更の元映像を残して最終選択を拡大する流れです。
結果は元の音声トラックを保ちます。特に選択区間の冒頭と最後で、映像とのタイミングを確認してください。文書化された仕様には、独立したフレームレート選択、新しい台詞の生成、画像参照による編集制御はありません。目的は拡大動画と選択した細部処理であり、処理区間内の元の時間的・音響的素材を維持します。
届いたクリップを保管・確認する
メーカーのワークフローは非同期です。送信したタスクから識別子と状態確認先が提供され、完了結果に署名付き MP4 配信リンクが含まれます。リンクは約 1 時間後に失効します。一時的な場所に依存せず、実際のクリップ、元映像、選択倍率、creativity モード、内容説明を保管してください。失敗やモデレーションの状態を、完成動画と区別します。
個々のフレームで顔、印字、表面の変化を確認し、その後シーケンスを見て連続性、動き、音声の位置合わせを確かめます。精密・創造的な出力は異なる視覚要件に応えます。実用的な成果物は、目的の表示サイズで選択した忠実性の目標を満たす拡大クリップです。解像度が大きいだけでは、元の同一性、言葉、細部が正しく保たれた証拠にはなりません。
Ailoot Ultra · 動画 POST /v1/videos black-forest-labs/flux-video-upscale
black-forest-labs/flux-video-upscale
black-forest-labs/flux-video-upscaleはじめに
FLUX Video Upscale は、元映像に忠実な、または創造的な細部強化によって既存クリップを拡大します。文書化された仕様は 1.5~3 倍の拡大に対応し、元の音声とフレーミングを維持しながら、元動画の長さ、入力解像度、出力フレーム面積を制限します。
- 対応する入力
- テキスト · 画像 · 音声 · 動画
- 結果
- 動画
Ailootで利用可能 · 入力とメソッド
Ailoot Ultra · 動画 POST /v1/videos
- 入力の種類
text,image,audio,video- 出力の種類
video
| フィールド | 種類 | 要件 | 値と制限 | デフォルト |
|---|---|---|---|---|
フィールドmodel | 種類string | 要件必須 | 値と制限 black-forest-labs/flux-video-upscale | デフォルト— |
フィールドinput_references | 種類array | 要件必須 | 値と制限 最小項目数: 1 最大項目数: 1 | デフォルト— |
フィールドupscale_factor | 種類number | 要件必須 | 値と制限 最小値: 1.5 最大値: 3 | デフォルト— |
フィールドcreativity | 種類integer | 要件必須 | 値と制限 0, 1 | デフォルト— |
メソッドのパラメータとライフサイクル
| パラメータ | 仕様 |
|---|---|
パラメータcontent_type | 仕様application/json |
パラメータrequired | 仕様model, input_references, upscale_factor, creativity |
パラメータmaterial_types | 仕様text, image, audio, video |
パラメータmaterial_conditions | 仕様実際に完了した所有動画アセットのコンテンツURLを、返された署名付きで厳密に一つ使用してください。アセットの所有者、型、および保存済みバイト列の証跡は、リクエストと一致する必要があります。 |
ライフサイクル: asynchronous_job_then_owned_outputs
GET /v1/videos/{request_id} · 実際に返されたidまたはpolling_url
GET /v1/videos/{request_id}/content
料金
最終料金の計算方法
表示料金は生成前の費用の見積もりです。最終請求額は、元の生成処理に記録された費用から計算されます。実測された出力時間や予測数量が、そのまま最終的な課金数量になるわけではありません。
料金情報はリクエストの機能を追加しません。対応するパラメーターは選択したメソッドに記載されています。
- 高速モード
- 未指定 高速モードが選択されている場合
- Flex モード
- 未指定 flex モードが選択されている場合
- 最大推論量
- 未指定 推論量が最大で、調整に既定値(default)を使用する場合
比較用の推定料金
設定別の価格
各料金を表示された条件と照合してください。選択肢となる設定の各組には、いずれか1つの料金を適用します。
| 設定 | 料金表 | 予測数量 | 課金単位 | 課金条件 | 1メガピクセルあたりのピクセル数 | 料金 |
|---|---|---|---|---|---|---|
| 設定基本トークン料金 | 料金表基本料金 | 予測数量— | 課金単位— | 課金条件— | 1メガピクセルあたりのピクセル数— | 料金 入力 · 入力トークン · 比較専用の見積もり — / 1K トークン 出力 · 出力トークン · 比較専用の見積もり — / 1K トークン 入力 · キャッシュ読み取り · 比較専用の見積もり — / 1K トークン 入力 · キャッシュ書き込み · 比較専用の見積もり — / 1K トークン 入力 · キャッシュ書き込み、1時間 · 比較専用の見積もり — / 1K トークン |
| 設定動画料金 | 料金表— | 予測数量— | 課金単位メガピクセル秒あたり | 課金条件品質:creative | 1メガピクセルあたりのピクセル数1,048,576 | 料金 出力 · 動画料金 · 比較専用の見積もり $0.21 メガピクセル秒あたり |
| 設定動画料金 | 料金表— | 予測数量— | 課金単位メガピクセル秒あたり | 課金条件quality: precise | 1メガピクセルあたりのピクセル数1,048,576 | 料金 出力 · 動画料金 · 比較専用の見積もり $0.15 メガピクセル秒あたり |
| 設定生成費用の見積もり | 料金表— | 予測数量生成1回分の概算 | 課金単位— | 課金条件— | 1メガピクセルあたりのピクセル数— | 料金 出力 · 推定生成コスト · 比較専用の見積もり $0.15 生成前の見積もり この見積もりは追加料金ではなく、完了した生成処理に対する固定料金でもありません。 |
Ailootはリクエスト前に見積額を確保します。結果の取得後、実測使用量に基づいて最終料金を精算します。ストリーミング時の精算には最終の使用量記録を使用します。金額の確保と精算の仕組み →
リクエスト例
Ailoot Ultra · 動画
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_INPUT_REFERENCES_JSON:?Set the actual documented input value}"
export AILOOT_INPUT_REFERENCES_JSON
: "${AILOOT_UPSCALE_FACTOR:?Set the actual documented input value}"
export AILOOT_UPSCALE_FACTOR
: "${AILOOT_CREATIVITY:?Set the actual documented input value}"
export AILOOT_CREATIVITY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
request={'model': 'black-forest-labs/flux-video-upscale', 'input_references': '${ACTUAL_OWNED_INPUT_REFERENCES}', 'upscale_factor': '${ACTUAL_UPSCALE_FACTOR}', 'creativity': '${ACTUAL_CREATIVITY}'}
request['input_references']=json.loads(os.environ['AILOOT_INPUT_REFERENCES_JSON'])
request['upscale_factor']=float(os.environ['AILOOT_UPSCALE_FACTOR'])
request['creativity']=int(os.environ['AILOOT_CREATIVITY'])
Path('request.json').write_text(json.dumps(request,ensure_ascii=False),encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o response.bin
# Retain the complete response and headers, every actual output, original returned identifiers and all usage fields. Recover the original operation without submitting creation again.
結果を受け取って保存
Ailoot Ultra · 動画
GET /v1/videos/{request_id}GET /v1/videos/{request_id}/content
完了したアセットをすべて保存
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_STATUS_FILE:?Set the actual completed status JSON file}"
export AILOOT_STATUS_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
from urllib.parse import urlsplit,urljoin
f=Path(os.environ["AILOOT_STATUS_FILE"])
if not f.is_file():raise SystemExit("Choose the actual completed status file")
r=json.loads(f.read_text())
if r.get("status")!="completed" or not isinstance(r.get("data"),list) or not r["data"]:raise SystemExit("Wait for a completed status with asset paths")
urls=[]
for x in r["data"]:
if not isinstance(x,str) or "\n" in x or "\r" in x:raise SystemExit("Invalid asset path")
u=urljoin("https://api.ailoot.ai",x)
z=urlsplit(u)
if z.scheme!="https" or z.netloc!="api.ailoot.ai" or z.username or z.password:raise SystemExit("Use the actual Ailoot asset paths from status")
urls.append(u)
Path("asset-urls.txt").write_text("\n".join(urls)+"\n")
PY_REQUEST
index=0
while IFS= read -r asset_url; do
curl --fail-with-body --silent --show-error "$asset_url" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o "video-${index}.mp4"
index=$((index + 1))
done < asset-urls.txt
完了した結果をすべて保存
完了した動画や返されたファイルをすべて保存し、実際に返されたすべてのアセットURLから取得してください。
レスポンスとヘッダーの全体、実際の出力すべて、最初に返された識別子、使用量フィールドすべてを保存してください。作成リクエストを再送せずに、元の操作を復旧してください。
元のレスポンスを確認する場合
X-Client-Request-ID、X-Ailoot-Task-Id、および実際に返されたid/polling_urlを保持してください。元のジョブを継続し、作成リクエストを再送信しないでください。
レスポンスのフィールド
| フィールド | 種類 |
|---|---|
フィールドid | 種類 |
フィールドstatus | 種類 |
フィールドdata[] | 種類 |
フィールドoutputs[] | 種類 |
エイリアス
モデルのエイリアス
Ailoot Ultra black-forest-labs/flux-video-upscale
メソッドパスのエイリアス
上記に表示されたメソッドパスを使用してください。
関連する呼び出し用ID
FAQ · Black Forest Labs: FLUX Video Upscale
- 利用できる入力と結果は何ですか?
POST /v1/videos·black-forest-labs/flux-video-upscale:text,image,audio,video→video- リクエストはどの項目を使用しますか?
POST /v1/videos·black-forest-labs/flux-video-upscale:model,input_references,upscale_factor,creativity- どの制限が適用されますか?
POST /v1/videos·black-forest-labs/flux-video-upscale:upscale_factor.minimum:1.5;upscale_factor.maximum:3