Black Forest Labs: FLUX Video Edit
FLUX Video Edit [fast] 透過書面編輯指示轉換既有片段。可在文件所述來源長度、取景及音訊限制內,新增、移除或替換元素、變更場景或風格,並修訂現有對話。
關於模型
此說明介紹模型的能力。Ailoot 可用的輸入、輸出與選項,依所選方法列於下方。
FLUX Video Edit [fast] 是 Black Forest Labs 用於變更既有影片的提示引導工作流程。它接收一段來源影片及描述編輯的指示,再傳回編輯後 MP4。來源建立鏡頭:時長、取景、鏡頭運動及時序提供起始結構。提示應指出哪裡應改變,而非撰寫完全新場景,使預定變更變得不清楚。
指出變更及其位置
文件記載的編輯包括移除、新增或替換物體與角色、重建場景、改變片段風格、變更可見文字,以及修訂對話或聲音。請從目標與操作開始。例如移除椅子上的包包,同時保留坐著的人與房間;或在不改變手部動作的情況下,將素面馬克杯換成藍色琺瑯杯。若畫面有數個相似物體,請依位置、外觀或角色區分目標。
新增時應描述位置、尺度及相關動作。沙發旁一盞高紅燈,比鏡頭中某處多一盞未指定的燈更具體。替換時應識別什麼變成什麼,以及應保留的動作或接觸。製造商提示指南建議採完整指出變更的最短指示,只在編輯需要時增加細節。請有意識地保留來源特徵,而非要求無法評估範圍的一般改善。
場景、風格與粗略動畫
場景變更可在保留動作時重建可見環境。製作者示範將攀爬表面替換為不同結構,並指定新接觸點,讓角色手腳仍有具意義的接觸面。實際場景應描述變更後周圍,以及既有動作依賴的幾何形狀。若原動作與新背景有明確關係,會更容易評估。
指南也展示將粗略動畫轉成完成的視覺處理。請指出哪些粗模物體要成為預定車輛或道具,再保留其路徑、速度及與鏡頭的關係。改變風格時,除了美學,也描述結果的材質、表面、光線及反射。即使遵循相同動作,黏土感場景與攝影感場景也需要不同可見線索。
後續修訂可將第一次編輯結果作為新來源。請保留原始內容與每個選定階段,並為下一次處理設定一個清楚目的。文件範例從粗略預覽進展至完成場景,再套用另一種照明處理。每次處理後,請將修訂片段與上一份來源比較,確認原本要保留的特徵仍存在。
台詞必須符合既有時間
除非指示要求更改對話或聲音,工作流程會保留來源音訊。無聲來源傳回無聲結果,因此沒有可修訂的既有語音。對話編輯應引述預定台詞、識別說話者,並將新詞句安排在原台詞占用的時間內。指南報告較長替換台詞超出可用發話區間時會遭截斷。增加文字不會在既有鏡頭中產生額外說話時間。
請將可聽台詞與可見表演一併檢查。保留來源措辭及預定替換副本,以識別漏字、時序錯誤片語或不需要的聲音變更。實用結果是編輯場景內修訂後的口語片刻,不能僅因渲染完成就假設是忠實轉錄稿。
來源上限與繼承的輸出
確切製作者規格要求影片與編輯提示。指示在去除前後空白後,長度為 1 至 4,096 個字元。片段透過 URL 或編碼後 MP4 提供,最長十五秒,輸入上限五十 MiB。每邊至少 160 像素,正規化後片段須在每秒 24 幀下包含至少十七幀,約 0.7 秒。超長來源會遭拒絕,而非靜默裁切;尺寸不足的來源可能在處理期間失敗。
文件所述流程採每秒 24 幀處理,依循來源長度與長寬比。超過 720p 規格的輸入會縮小;製造商舉例 1920×1088 來源傳回 1248×704。此編輯規格的時長、解析度及長寬比,並非獨立輸出設定。取樣配方由內部處理,mode、version、seed 或 generate_audio 等欄位不被所述請求契約接受。
將影片只當成新生成鏡頭的動作或風格靈感,是另一種工作流程。此編輯器不接受圖片參考、僅有音訊的輸入、遮罩,或延長片段的請求。撰寫編輯指示前,請準備真正要變更的影片並保留選定時長。非同步處理後,製作者透過約一小時有效的暫時簽署交付連結傳回編輯後 MP4。將片段用於較長剪輯前,請儲存結果,並將變更物體、周圍畫面、時序及音訊與來源比較。
Ailoot Ultra · 影片 POST /v1/videos black-forest-labs/flux-video-edit
black-forest-labs/flux-video-edit
black-forest-labs/flux-video-edit入門
FLUX Video Edit [fast] 透過書面編輯指示轉換既有片段。可在文件所述來源長度、取景及音訊限制內,新增、移除或替換元素、變更場景或風格,並修訂現有對話。
- 接受的輸入
- 文字 · 圖片 · 音訊 · 影片
- 結果
- 影片
Ailoot 可用 · 輸入與方法
Ailoot Ultra · 影片 POST /v1/videos
- 輸入
text,image,audio,video- 輸出
video
| 欄位 | 類型 | 要求 | 值與限制 | 預設值 |
|---|---|---|---|---|
欄位model | 類型string | 要求必填 | 值與限制 black-forest-labs/flux-video-edit | 預設值— |
欄位input_references | 類型array | 要求必填 | 值與限制 項目數下限: 1 項目數上限: 1 | 預設值— |
欄位prompt | 類型string | 要求必填 | 值與限制 長度下限: 1 | 預設值— |
方法參數與生命週期
| 參數 | 規格 |
|---|---|
參數content_type | 規格application/json |
參數required | 規格model, input_references, prompt |
參數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 調整值時
供比較的預估費率
各設定的價格
請逐一核對各項費用與所列條件。每組互為替代選項的設定只套用一種費率。
| 設定 | 費率表 | 預估數量 | 計費單位 | 計費條件 | 費用 |
|---|---|---|---|---|---|
| 設定基礎 token 費率 | 費率表基本費率 | 預估數量— | 計費單位— | 計費條件— | 費用 輸入 · 輸入 Token · 僅供比較的估算 — / 1K Token 輸出 · 輸出 Token · 僅供比較的估算 — / 1K Token 輸入 · 讀取快取 · 僅供比較的估算 — / 1K Token 輸入 · 寫入快取 · 僅供比較的估算 — / 1K Token 輸入 · 寫入快取,1 小時 · 僅供比較的估算 — / 1K Token |
| 設定影片價格 | 費率表— | 預估數量— | 計費單位每秒影片 | 計費條件此定價鍵未宣告額外條件。 | 費用 輸出 · 影片價格 · 僅供比較的估算 $0.06 每秒影片 |
| 設定預估生成費用 | 費率表— | 預估數量單次生成估算值 | 計費單位— | 計費條件— | 費用 輸出 · 預估生成費用 · 僅供比較的估算 $0.06 生成前估算 此估算並非額外費用,也不是本次生成完成後的固定費率。 |
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_PROMPT:?Set the actual documented input value}"
export AILOOT_PROMPT
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
request={'model': 'black-forest-labs/flux-video-edit', 'input_references': '${ACTUAL_OWNED_INPUT_REFERENCES}', 'prompt': '${ACTUAL_EDIT_PROMPT}'}
request['input_references']=json.loads(os.environ['AILOOT_INPUT_REFERENCES_JSON'])
request['prompt']=os.environ['AILOOT_PROMPT']
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-edit
方法路徑別名
請使用上方列出的 API 方法路徑。
相關呼叫用 ID
FAQ · Black Forest Labs: FLUX Video Edit
- 可以使用哪些輸入與結果?
POST /v1/videos·black-forest-labs/flux-video-edit:text,image,audio,video→video- 請求使用哪些欄位?
POST /v1/videos·black-forest-labs/flux-video-edit:model,input_references,prompt