模型

Black Forest Labs: FLUX Video Edit

Markdown · JSON

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 /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
儲存所有已完成的素材
GET · 取得所有已完成的素材
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

black-forest-labs/flux-video-edit

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

更多詳情

將 Ailoot 串接 Claude Code、OpenCode、Hermes 或自己的應用程式。

公司及其專案組合

公司及其專案組合:數百萬客戶,每月銷售額達數十億。

優惠購買 token。

訂閱優惠適合持續工作,折扣碼購買 token 最高可折 50%。

訂閱
為定期請求選擇優惠方案。
最高 50% 折扣碼
購買時輸入代碼,價格依活動重算。
歷史中的費用
每次請求保存模型、token 與金額。

選擇訂閱 · 查看模型價格

將 API 加入 你銷售的產品。

依 Ailoot 正式服務條款與授權合約串接 SaaS、應用程式與機器人;轉售請申請經銷授權。

商用應用程式
在付費功能加入文字、圖片、影片與聲音生成。
經銷授權
提供專案說明與存取方式,要求書面使用和轉售條件。
網站文件
串接前可閱讀正式服務條款、授權合約與資料處理政策。

申請經銷授權 · 正式服務條款與授權合約