> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# FLUX Video Edit: ComfyUI에서 텍스트 프롬프트로 비디오 편집하기

> ComfyUI의 FLUX Video Edit 파트너 노드로 기존 클립을 편집하세요. 텍스트 프롬프트만으로 사물을 바꾸거나, 화면 스타일을 변경하거나, 화면 속 텍스트와 대사를 바꿀 수 있습니다.

FLUX Video Edit는 Black Forest Labs의 텍스트 기반 비디오 편집 엔드포인트로, ComfyUI에서 파트너 노드로 사용할 수 있습니다. 소스 클립과 평이한 언어로 작성된 지시를 입력하면, 해당 지시에 맞게 영상을 다시 작성합니다.

이 편집은 장면에서 벌어지는 일을 바꾸는 것이지, 촬영 방식을 바꾸는 것이 아닙니다. 길이, 프레이밍, 카메라 움직임, 오디오 트랙은 모두 소스 클립에서 그대로 가져오므로, 아무것도 다시 동기화할 필요 없이 결과물을 편집본에 다시 잘라 넣을 수 있습니다. 그래서 객체를 제거하거나 추가 또는 교체하기, 영상 스타일 바꾸기, 배경 변경하기, 화면 텍스트 다시 쓰기, 대사 교체에 유용합니다.

이 노드는 전적으로 Comfy API를 통해 Black Forest Labs의 서버에서 실행됩니다. 모델 다운로드나 로컬 GPU가 필요하지 않으며, 크레딧이 있는 Comfy API 계정이 필요합니다.

## FLUX Video Edit이 잘하는 것

* **지시문만으로**: 마스크, 참조 이미지, 제어 입력 없이 변경 사항을 말로 설명합니다
* **구조 유지**: 길이, 프레이밍, 카메라 움직임, 오디오는 소스 클립에서 가져옵니다
* **객체 수준 편집**: 객체, 캐릭터, 배경 요소를 제거, 추가 또는 교체합니다
* **스타일 변경**: 이미 보유한 영상의 룩, 조명 또는 배경을 변경합니다
* **텍스트 및 대사**: 화면 텍스트를 다시 작성하고 음성 대사를 교체합니다
* **최대 15초**: 0.7초에서 15초 사이의 소스 클립을 지원합니다

## 예시 출력

포즈, 조명, 카메라를 유지하면서 기존 클립의 출연자를 교체하기:

<video controls className="w-full aspect-video" src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/api_flux_video_edit.mp4" />

## 사용하기

<Card title="코드에서 호출하기" icon="code" href="/ko/development/comfy-router/models/black-forest-labs/video-edit-v1/code">
  Comfy Router를 통해 HTTP로 호출하며, 복사해서 붙여넣을 수 있는 Python, TypeScript, cURL 스니펫을 제공합니다
</Card>

이 기능은 아래의 ComfyUI에서 실행하는 것과 동일한 Comfy 계정에서 실행되며, 동일한 크레딧으로 청구됩니다. 모델별 요금은 [파트너 노드 크레딧](/ko/tutorials/partner-nodes/pricing)을, 동시에 처리할 수 있는 요청 수는 [동시성 제한](/ko/tutorials/partner-nodes/concurrency-limits)을 참고하세요.

<Tip>
  파트너 노드를 사용하려면 올바르게 로그인되어 있고 허가된 네트워크 환경을 사용하고 있는지 확인해야 합니다. 파트너 노드를 사용하기 위한 구체적인 요구사항은 문서의 [파트너 노드 개요](/ko/tutorials/partner-nodes/overview) 섹션을 참조해 주세요.
</Tip>

<Tip>
  <Tabs>
    <Tab title="로컬 사용자">
      ComfyUI가 최신 버전으로 업데이트되었는지 확인하세요.

      * [ComfyUI 다운로드](https://www.comfy.org/download)
      * [업데이트 가이드](/ko/installation/update_comfyui)

      이 가이드의 워크플로는 [워크플로 템플릿](/ko/interface/features/template)에서 확인할 수 있습니다.
      템플릿에서 찾을 수 없다면, 귀하의 ComfyUI가 오래된 버전일 수 있습니다.

      워크플로를 로드할 때 노드가 누락되는 경우, 가능한 원인:

      1. 최신 ComfyUI 버전(최신 테스트 버전(nightly))을 사용하고 있지 않음
      2. 일부 노드가 시작 시 가져오기에 실패함
    </Tab>

    <Tab title="클라우드 사용자">
      * [클라우드](https://cloud.comfy.org)는 ComfyUI 안정판 출시 후 업데이트됩니다.

      따라서 이 문서에서 핵심 노드가 누락된 것을 발견했다면, 그 이유는 새로운 핵심 노드가 아직 최신 안정판에 공개되지 않았기 때문일 수 있습니다. 다음 안정판 출시를 기다려 주세요.
    </Tab>
  </Tabs>
</Tip>

## FLUX Video Edit 워크플로

이미 가지고 있는 클립을 편집합니다. 비디오를 불러오고, 프롬프트에 변경할 내용을 설명한 다음 실행하세요. 이 워크플로는 FLUX Video Edit 파트너 노드를 통해 클립을 Black Forest Labs로 전송하고, 편집된 클립을 `SaveVideo`를 통해 다시 기록합니다.

<video controls className="w-full aspect-video" src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/api_flux_video_edit.mp4" />

<CardGroup cols={2}>
  <Card title="Comfy Cloud에서 실행" icon="cloud" href="https://cloud.comfy.org/?template=api_flux_video_edit&utm_source=docs&utm_medium=referral&utm_campaign=flux-video-edit">
    Comfy Cloud에서 열기
  </Card>

  <Card title="워크플로 다운로드" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_flux_video_edit.json">
    JSON을 다운로드하거나 템플릿 라이브러리에서 "Flux Video Edit"를 검색하세요
  </Card>
</CardGroup>

<details className="prose" style={{marginBottom:"1rem"}}>
  <summary>입력 자료</summary>

  이 샘플 입력 비디오를 다운로드하여 워크플로를 사용해 보세요:

  <CardGroup cols={1}>
    <Card title="입력 비디오" icon="video" href="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/subway_musician.mp4">
      샘플 입력 비디오 다운로드
    </Card>
  </CardGroup>
</details>

## 편집 지시문 작성하기

프롬프트는 유일한 창작 제어 수단이므로, 신중하게 작성할 가치가 있습니다.

* 화면에서 바뀌는 것만 설명하세요. 언급하지 않은 부분은 모두 원래대로 유지됩니다.
* 대상과 결과를 하나의 문장에 함께 명시하세요. 예를 들어 "기타 연주자를 같은 포즈의 고릴라로 교체"처럼 작성합니다.
* 지시문은 최대 4096자까지 평이한 언어로 작성하세요. 형태, 재질, 동작에 관한 세부 정보는 모델이 얼마나 크게 바뀌는지와 대략적으로 대응합니다.
* 대체 대사는 원본 발화의 길이에 가깝게 유지하세요. 새 대사가 원본 발화가 차지하는 시간에 맞춰져야 하기 때문입니다. 무음 클립은 무음으로 유지됩니다.
* 시드는 실행을 재현 가능하게 만들어 주지 않습니다. FLUX는 자체적으로 시드를 선택하므로, 같은 클립에 동일한 지시문을 사용해도 결과가 다르게 나올 수 있습니다.

## 노드 옵션 레퍼런스

| 옵션                 | 값             | 기본값   | 비고                                                   |
| ------------------ | ------------- | ----- | ---------------------------------------------------- |
| `video`            | 소스 클립         | 필수    | 0.7\~15초, 최소 160x160 픽셀                              |
| `prompt`           | 텍스트           | 비어 있음 | 무엇을 변경할지 평이한 언어로 작성, 최대 4096자                        |
| `auto_downscale`   | 켜기 / 끄기       | 켜기    | 업로드 이전에 면적이 1280x704보다 큰 소스를 다운스케일하며, 가로세로 비율을 유지합니다 |
| `safety_tolerance` | 0\~4          | 4     | 고급. 검열 허용치이며, `0`이 가장 엄격합니다                          |
| `seed`             | 0\~4294967295 | 42    | FLUX가 자체적으로 시드를 선택하므로, 이 값과 관계없이 결과는 비결정적입니다         |

## 제한 사항

* 소스 클립은 0.7초에서 15초 사이이며 최소 160x160 픽셀이어야 합니다.
* 출력은 24 fps로 렌더링되며 프레임당 약 0.9 메가픽셀(1280x704)로 제한되므로, 더 큰 소스는 더 작게 반환됩니다.
* 청구는 클립 초 단위로 이루어집니다. [파트너 노드 크레딧](/ko/tutorials/partner-nodes/pricing)을 참조하세요.

## 시작하기

1. ComfyUI를 최신 버전으로 업데이트합니다
2. Template Library로 이동하여 `Flux Video Edit`을 검색합니다