# 리프레임

> 사람들이 말하는 녹화를, 말하는 사람을 보여 주는 세로 클립으로 바꿉니다. 항목 하나로 음성 텍스트 변환, 화자 프레임, 화자 뷰를 연결해 추가합니다.

Source: https://nodaro.ai/ko/docs/nodes/video/reframe

**리프레임**은 사람들이 말하는 녹화를, 말하는 사람을 보여 주는 세로 클립으로 바꿉니다. 노드 추가 메뉴의 항목 하나로, 노드 세 개를 서로 연결하고 그룹으로 묶어 추가합니다. 화자 분리를 켠 [음성 텍스트 변환](https://nodaro.ai/docs/nodes/audio/transcribe), [화자 프레임](https://nodaro.ai/docs/nodes/video/speaker-frames), [화자 뷰](https://nodaro.ai/docs/nodes/video/speaker-view)입니다. 리프레임 노드는 없습니다. 저장하거나 내보내거나 가져온 워크플로에는 이 세 노드가 들어 있습니다.

리프레임 자체의 가격은 없습니다. 세 노드가 실행될 때 각각 자체 가격을 청구합니다. [크레딧](#credits)을 참고하세요.

화자 프레임과 화자 뷰는 Nodaro Cloud에서 실행됩니다. 셀프 호스팅 설치에서는 [설치를 Nodaro Cloud에 연결](https://nodaro.ai/docs/self-hosting/cloud-connect)하면, 각 노드 페이지에 설명된 대로 작동합니다.

## 사용 시기
- 팟캐스트나 인터뷰 동영상이 있고, 쇼츠, 릴스, TikTok용으로 말하는 사람을 보여 주는 9:16 클립을 만들고 싶을 때.
- 편집 계획과 카메라 전환으로 편집을 만들지 않고 화자를 따라가는 크롭을 원할 때.
- 세 노드를 한 번에 올바르게 연결한 다음, 각 노드를 자체 설정 패널에서 조정하고 싶을 때.

## 빠른 시작
### 동영상 선택
동영상을 출력하는 노드(예: **동영상 업로드** 노드)를 클릭해, 그 노드만 선택된 상태로 만드세요.

### 리프레임 추가
Tab을 누르고 **동영상 › 리프레임 › 리프레임**을 선택하세요. 동영상 출력에서 캔버스로 연결을 끌어 놓고 **리프레임**을 선택할 수도 있습니다. 동영상이 세 노드 모두에 연결됩니다.

### 실행 및 검토
**실행**을 클릭하세요. 화자 뷰는 **미리 보기** 품질로 시작하므로, 첫 실행은 비용이 적게 듭니다. 프레이밍이 맞으면 **최종 렌더링**을 쓰세요.

Workflow: 리프레임은 동영상 하나를 음성 텍스트 변환, 화자 프레임, 화자 뷰에 연결하고, 화자 뷰는 말하는 사람을 따라가는 세로 클립을 렌더링합니다.

- 동영상 업로드 → 음성 텍스트 변환 (오디오)
- 동영상 업로드 → 화자 프레임 (동영상)
- 동영상 업로드 → 화자 뷰 (동영상)
- 음성 텍스트 변환 → 화자 프레임 (녹취록)
- 음성 텍스트 변환 → 화자 뷰 (녹취록)
- 화자 프레임 → 화자 뷰 (얼굴 트랙)

## 입력
그룹 자체에는 입력이 없습니다. 동영상 하나가 입력 세 개에 들어갑니다. 음성 텍스트 변환의 **오디오** 입력, 그리고 화자 프레임과 화자 뷰의 **동영상** 입력입니다.

- **연결에서.** 동영상 출력에서 캔버스로 연결을 끌어 놓고 **리프레임**을 선택하세요. 그 동영상이 세 노드 모두에 연결됩니다.
- **선택한 노드에서.** 동영상 출력이 있는 노드를 정확히 하나 선택한 상태에서 노드 추가 메뉴나 사이드바로 리프레임을 추가하세요. 그 동영상이 세 노드 모두에 연결됩니다. 선택한 노드가 없거나 여러 개이면 아무것도 연결되지 않습니다.
- **나중에.** 그 밖의 경우 그룹에 **영상 연결** 배지가 표시됩니다. 세 입력 중 아무 곳에나 동영상을 연결하면 세 입력 모두에 한꺼번에 연결됩니다. 이 동작은 아직 어느 입력에도 동영상이 없을 때 한 번만 일어납니다. 음성 텍스트 변환에 연결한 오디오 소스는 동영상이 아니므로 배지가 그대로 남습니다.

## 출력
출력은 세 노드의 출력입니다. 클립은 [화자 뷰](https://nodaro.ai/docs/nodes/video/speaker-view#outputs)의 **동영상** 출력입니다. 화자 뷰는 그려진 그대로의 편집과, 그 편집에 맞춰 다시 맞춘 녹취록도 출력하며, 이 녹취록은 바로 [자막 추가](https://nodaro.ai/docs/nodes/video/add-captions)에 쓸 수 있습니다.

## 설정
리프레임 자체에는 설정이 없습니다. 각 노드는 자체 설정 패널을 유지하므로, 각 노드 페이지에서처럼 설정을 바꾸면 됩니다. 리프레임은 다음 설정으로 노드를 추가합니다.

| 노드 | 연결 원본 | 설정값 |
| --- | --- | --- |
| [음성 텍스트 변환](https://nodaro.ai/docs/nodes/audio/transcribe) | 동영상을 **오디오**에 | 화자 분리 켜짐 |
| [화자 프레임](https://nodaro.ai/docs/nodes/video/speaker-frames) | 동영상을 **동영상**에. 음성 텍스트 변환의 녹취록을 **녹취록**에 | 노드의 기본값 |
| [화자 뷰](https://nodaro.ai/docs/nodes/video/speaker-view) | 동영상을 **동영상**에. 음성 텍스트 변환의 녹취록을 **녹취록**에. 화자 프레임의 **얼굴 트랙**을 **얼굴 트랙**에 | **9:16**, **컷**, **따라가기**, **미리 보기** 품질 |

세 노드는 한 번에 추가되므로, 실행 취소 한 번으로 그룹 전체가 제거됩니다. 그룹은 감싸는 컨테이너가 아니라 프레임입니다. 다른 그룹처럼 옮기고, 이름을 바꾸고, 색을 바꾸고, 그룹을 해제할 수 있습니다. 노드 하나를 삭제하면 나머지는 일반 노드로 남습니다.

그룹은 중첩되지 않습니다. 기존 그룹 안에 리프레임을 추가하면 새 그룹은 그 옆에 놓입니다. 실행이 진행 중이거나 보기만 할 수 있는 워크플로에서는 리프레임을 추가할 수 없습니다.

## 크레딧
리프레임 자체의 가격은 없습니다. 세 노드가 실행될 때 각각 자체 가격을 청구합니다.

- **음성 텍스트 변환**은 자체 가격으로 청구됩니다. [음성 텍스트 변환](https://nodaro.ai/docs/nodes/audio/transcribe)을 참고하세요.
- **화자 프레임**은 샘플링한 프레임 1,000개 단위 블록마다 청구되며, 시작된 블록도 하나로 계산합니다. 클립 전체를 초당 2프레임으로 샘플링하므로, 14초짜리 클립은 28프레임, 즉 한 블록입니다. [화자 프레임](https://nodaro.ai/docs/nodes/video/speaker-frames#credits)을 참고하세요.
- **화자 뷰**는 클립 1분 단위로, **품질**과 등급에 따른 요율로 청구됩니다. [화자 뷰](https://nodaro.ai/docs/nodes/video/speaker-view#credits)를 참고하세요.

에디터는 그룹에 대해 합산한 예상치 하나를 보여 줍니다. 그룹 자체의 칩에, 그리고 모든 실행 확인에서 **리프레임** 행으로 표시됩니다. 이 수치는 세 노드 각자의 예상치를 더한 값이므로, 실행 시 확인하는 금액과 달라질 수 없습니다. 실행 전에 화자 프레임과 화자 뷰는 클립의 기록된 길이를 읽습니다. 실행 전에 클립의 길이를 알 수 없으면 상한으로 견적을 냅니다. 그런 다음 실행은 각 노드가 실제로 사용한 만큼 청구합니다.

## 팁
- **미리 보기로 시작하세요.** 화자 뷰는 **미리 보기** 품질로 시작합니다. 프레이밍을 확인한 다음 **최종 렌더링**을 쓰세요.
- **프레이밍 편집…에서 얼굴을 수정하세요.** 얼굴이 다른 화자에 맞춰지면 화자 뷰에서 **프레이밍 편집…**을 열고 그 얼굴이 누구인지 고르세요. [얼굴 추적](https://nodaro.ai/docs/nodes/video/speaker-view#face-tracking)을 참고하세요.
- **가로로 넓은 동영상을 쓰세요.** 화자 뷰가 화자를 따라가려면 여분의 폭이 필요합니다. 이미 9:16이거나 더 좁은 동영상은 실행되기 전에 거부됩니다.
- **실패한 노드는 청구된 금액을 유지합니다.** 각 노드는 별도의 실행입니다. 화자 프레임이 실패하면 음성 텍스트 변환은 이미 청구되었고, 이후 노드는 청구되지 않습니다.

## 문제 해결
| 메시지 또는 문제 | 원인과 해결 |
| --- | --- |
| 그룹에 **영상 연결**이 표시됩니다. | 동영상이 연결되지 않았습니다. 세 입력 중 아무 곳에나 동영상을 연결하세요. |
| 노드 추가 메뉴에 리프레임이 없습니다. | 세 노드 중 하나를 이 설치에서 쓸 수 없거나 가격이 없습니다. 리프레임은 음성 텍스트 변환, 화자 프레임, 화자 뷰를 모두 쓸 수 있는 곳에서만 제공됩니다. |
| 동영상이 이미 9:16만큼 좁다는 이유로 거부됩니다. | 동영상에 화자를 따라 움직일 여분의 폭이 없습니다. 더 넓은 동영상을 쓰거나, 화자 뷰에서 더 넓은 화면 비율을 고르세요. |
| 화자를 따라가지 않습니다. | 화자 프레임이 어느 얼굴이 그 화자인지 구분하지 못했습니다. 화자 뷰나 화자 프레임에서 **…은(는) 어느 얼굴인가요?**를 클릭하고 얼굴을 고르세요. |

## API에서 사용
리프레임은 노드 유형이 아니므로, API와 MCP에는 리프레임 호출이 없습니다. 같은 구성을 만들려면 워크플로에 세 노드를 만들고 [설정](#settings)에서처럼 연결하세요. 경로를 차례로 호출할 수도 있습니다. 화자 레이블과 함께 동영상을 받아쓰기한 다음, `videoUrl`과 `transcript`로 `POST /v1/speaker-frames`를, 그다음 `videoUrl`, `transcript`, `tracks`로 `POST /v1/speaker-view`를 호출하세요. [화자 프레임](https://nodaro.ai/docs/nodes/video/speaker-frames#api)과 [화자 뷰](https://nodaro.ai/docs/nodes/video/speaker-view#api)를 참고하세요.

## 자주 묻는 질문

### 리프레임은 무엇을 하나요?

리프레임은 사람들이 말하는 동영상을, 말하는 사람을 보여 주는 세로 클립으로 바꿉니다. 캔버스에 노드 세 개를 그룹 하나로 묶고 서로 연결해 추가합니다. 음성 텍스트 변환은 누가 언제 말하는지 찾고, 화자 프레임은 각 얼굴을 찾고, 화자 뷰는 9:16 클립을 렌더링합니다.

### 리프레임은 노드인가요?

아니요. 리프레임은 노드 추가 메뉴의 항목으로, 일반 노드인 음성 텍스트 변환, 화자 프레임, 화자 뷰 세 개를 그룹 안에 추가합니다. 저장된 워크플로에는 이 세 노드가 들어 있으며, 리프레임이라는 노드는 없습니다.

### 리프레임의 가격은 얼마인가요?

리프레임 자체의 가격은 없습니다. 음성 텍스트 변환, 화자 프레임, 화자 뷰가 실행될 때 각각 자체 가격을 청구합니다. 그룹은 실행 전에 합산한 예상치 하나를 보여 줍니다.

### 리프레임에 편집이나 카메라 전환이 필요한가요?

아니요. 화자 뷰가 일반 동영상을 받아 화자의 발화마다 자르므로, 리프레임에는 편집 계획도 카메라 전환도 필요 없습니다.

### 얼굴이 다른 화자에 맞춰지면 어떻게 하나요?

화자 뷰 노드에서 프레이밍 편집…을 열고 각 얼굴이 누구인지 고르세요. 프레이밍 저장은 수정 내용을 화자 프레임 노드에 저장하고, 미리 보기 업데이트는 화자 프레임을 다시 실행하지 않고 클립을 다시 렌더링합니다.