Black Forest Labs: FLUX Video Edit
FLUX Video Edit [fast]는 작성된 편집 지시로 기존 클립을 변환합니다. 문서상의 원본 길이, 프레이밍, 오디오 제약 안에서 요소를 추가·제거·교체하고 배경이나 스타일을 바꾸며 기존 대화를 수정할 수 있습니다.
모델 소개
이 설명은 모델의 기능을 다룹니다. Ailoot에서 사용할 수 있는 입력, 출력 및 옵션은 아래에 선택한 메서드별로 표시됩니다.
FLUX Video Edit [fast]는 기존 영상을 바꾸는 Black Forest Labs의 프롬프트 기반 워크플로입니다. 원본 클립 하나와 편집을 설명하는 지시를 받아 편집된 MP4를 반환합니다. 원본이 숏을 설정합니다. 길이, 프레이밍, 카메라 움직임, 타이밍이 시작 구조를 제공합니다. 의도한 변경을 불분명하게 만드는 완전히 새로운 장면 설명보다 무엇이 달라져야 하는지 프롬프트로 식별하세요.
변경과 위치 명시
문서상의 편집에는 물체·캐릭터 제거, 추가, 교체, 배경 재구성, 클립 스타일 변경, 보이는 텍스트 변경, 대화·소리 수정이 포함됩니다. 대상과 작업으로 시작하세요. 예를 들어 앉아 있는 사람과 방을 유지하면서 의자의 가방을 제거하거나 손동작을 바꾸지 않고 무지 머그를 파란 에나멜 머그로 교체할 수 있습니다. 비슷한 물체가 여러 개 보이면 위치, 외형, 역할로 대상을 구분하세요.
추가할 때는 위치, 크기, 관련 행동을 설명하세요. 소파 옆의 키 큰 빨간 램프는 숏 어딘가에 추가 램프를 놓으라는 것보다 구체적입니다. 교체할 때는 무엇을 무엇으로 바꾸며 어떤 움직임이나 접촉이 남아야 하는지 식별하세요. 제조사 프롬프트 안내는 변경을 완전히 명시하는 가장 짧은 지시를 권장하며 편집에 필요한 곳에 세부를 추가합니다. 범위를 평가할 수 없는 일반적인 개선을 요청하지 말고 원본 특징을 의도적으로 보존하세요.
배경, 스타일, 러프 애니메이션
배경 변경은 행동을 유지하면서 보이는 환경을 재구축할 수 있습니다. 제작사는 등반 표면을 다른 구조로 교체하고 새 접촉점을 지정해 캐릭터의 손발이 의미 있는 표면을 갖게 하는 예를 보여 줍니다. 실용적인 장면에서는 바뀐 주변과 기존 움직임이 의존하는 기하 구조를 설명하세요. 원래 행동과의 관계가 명확하면 새 배경을 평가하기 쉽습니다.
안내는 러프 애니메이션을 완성된 시각 표현으로 변환하는 예도 보여 줍니다. 어떤 블록아웃 물체가 의도한 차량이나 소품이 되는지 명시한 뒤 경로, 속도, 카메라 관계를 유지하세요. 스타일 변경에서는 미적 방향뿐 아니라 결과의 재질, 표면, 빛, 반사를 설명하세요. 같은 행동을 따르더라도 점토 같은 장면과 사진 같은 장면에는 다른 시각 단서가 필요합니다.
추가 수정은 첫 편집 결과를 새 원본으로 사용할 수 있습니다. 원본과 선택한 각 단계를 보관하고 다음 처리에 명확한 목적 하나를 부여하세요. 문서상의 예는 러프 미리보기에서 완성 배경으로 진행한 뒤 다른 조명 처리를 적용합니다. 매 처리 후 수정 클립과 직전 원본을 비교하고 유지하려던 특징이 여전히 있는지 확인하세요.
대화는 기존 시간에 맞춰야 함
지시가 대화나 소리 변경을 요청하지 않으면 워크플로는 원본 오디오를 이어받습니다. 무음 원본은 무음 결과를 반환하므로 수정할 기존 발화를 제공하지 않습니다. 대화 편집에서는 의도한 대사를 인용하고 화자를 식별하며 원래 대사가 차지한 시간에 새 단어를 맞추세요. 안내는 긴 대체 대사가 가능한 발화 구간을 넘자 잘린 사례를 보고합니다. 단어를 더 쓴다고 기존 숏 안에 추가 발화 시간이 생기지는 않습니다.
들리는 대사와 보이는 연기를 함께 검토하세요. 빠진 단어, 타이밍이 어긋난 문구, 원치 않는 소리 변경을 식별할 수 있도록 원본 문구와 의도한 대체 사본을 보관하세요. 유용한 결과는 편집 장면 안의 수정된 발화 순간이며 렌더가 완료되었다는 이유만으로 충실한 전사문이라고 가정하는 것이 아닙니다.
원본 한도와 이어받는 출력
정확한 제작사 규격은 영상과 편집 프롬프트를 요구합니다. 지시는 앞뒤 공백을 제거한 뒤 1~4,096자여야 합니다. 클립은 URL 또는 인코딩된 MP4로 제공하며 최대 길이는 15초, 입력 한도는 50 MiB입니다. 각 변은 최소 160픽셀이어야 하고 정규화된 클립은 24 fps에서 최소 17프레임, 약 0.7초를 포함해야 합니다. 너무 긴 원본은 조용히 잘리지 않고 거절되며 너무 작은 원본은 처리 중 실패할 수 있습니다.
문서상의 흐름은 24 fps로 처리하며 원본 길이와 화면비를 따릅니다. 720p 규격을 넘는 입력은 축소됩니다. 제조사는 1920×1088 원본이 1248×704로 반환되는 예를 제공합니다. 이 편집 규격에서 길이, 해상도, 화면비는 독립적인 출력 설정이 아닙니다. 샘플링 방식은 내부에서 처리하며 mode, version, seed, generate_audio 같은 필드는 명시된 요청 계약에서 받지 않습니다.
새로 생성하는 숏의 움직임·스타일 영감으로만 영상을 쓰는 것은 다른 워크플로입니다. 이 편집기는 이미지 참조, 오디오 전용 입력, 마스크, 클립 확장 요청을 받지 않습니다. 편집 지시를 쓰기 전에 실제 바꿀 영상을 준비하고 선택한 길이를 유지하세요. 비동기 처리 뒤 제작사는 약 1시간 동안 유효한 임시 서명 전달 링크로 편집된 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 조정값을 적용하는 경우
비교용 예상 요금
설정별 가격
각 요금을 표시된 조건과 대조하세요. 서로 대체되는 설정 묶음마다 하나의 요금만 적용하세요.
| 설정 | 요금표 | 예측 수량 | 과금 단위 | 과금 조건 | 요금 |
|---|---|---|---|---|---|
| 설정기본 토큰 요금 | 요금표기본 요금 | 예측 수량— | 과금 단위— | 과금 조건— | 요금 입력 · 입력 토큰 · 비교 전용 추정치 — / 1K 토큰 출력 · 출력 토큰 · 비교 전용 추정치 — / 1K 토큰 입력 · 캐시 읽기 · 비교 전용 추정치 — / 1K 토큰 입력 · 캐시 쓰기 · 비교 전용 추정치 — / 1K 토큰 입력 · 캐시 쓰기, 1시간 · 비교 전용 추정치 — / 1K 토큰 |
| 설정동영상 요금 | 요금표— | 예측 수량— | 과금 단위동영상 초당 | 과금 조건이 가격 키에는 추가 조건이 명시되어 있지 않습니다. | 요금 출력 · 동영상 가격 · 비교 전용 추정치 $0.06 동영상 초당 |
| 설정예상 생성 비용 | 요금표— | 예측 수량1회 생성 예상치 | 과금 단위— | 과금 조건— | 요금 출력 · 예상 생성 비용 · 비교 전용 추정치 $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
메서드 경로 별칭
위에 표시된 메서드 경로를 사용하세요.
관련 호출용 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