# 클립 세트

> 클립 세트 노드는 팟캐스트나 인터뷰를 짧은 클립 묶음으로 한 번에 자릅니다. 가장 좋은 순간을 찾아 각각 SNS용으로 프레이밍하고 자막을 넣습니다.

Source: https://nodaro.ai/ko/docs/nodes/video/clip-pack

**클립 세트** 노드는 팟캐스트나 인터뷰 녹화를 짧은 클립 묶음으로 한 번에 자릅니다. 가장 좋은 순간을 찾아 각각을 별도의 클립으로 렌더링하며, SNS용으로 프레이밍하고 자막을 넣습니다. [여러 카메라](#several-cameras)로 찍은 대화도 편집할 수 있습니다.

내부에서 노드는 직접 연결해 만들 수 있는 것과 같은 단계를 실행합니다. 화자 레이블과 단어 타이밍이 있는 [음성 텍스트 변환](https://nodaro.ai/docs/nodes/audio/transcribe), 그리고 **클립** 모드의 [편집 계획](https://nodaro.ai/docs/nodes/video/edit-plan)입니다. 그다음 클립마다 렌더링(프레이밍이 있으면 [화자 뷰](https://nodaro.ai/docs/nodes/video/speaker-view), 없으면 [EDL 적용](https://nodaro.ai/docs/nodes/video/apply-edl))을 실행하고, 자막이 켜져 있으면 [자막 추가](https://nodaro.ai/docs/nodes/video/add-captions)를 실행합니다. 각 단계는 자체 작업으로 실행되므로, 긴 녹화, 취소, 실패는 직접 만든 워크플로에서와 똑같이 동작합니다.

- **순간은 계획이 고릅니다.** 편집 계획은 **클립 수**에 정한 개수까지, 각각 약 <strong>목표 길이(초)</strong>의 순간을 찾습니다. 각 순간에는 제목과 훅이 붙습니다. 찾은 순간은 요청보다 적을 수 있습니다. 묶음에는 찾은 클립이 들어가며, 그 렌더링만 청구됩니다.
- **모든 클립이 시도됩니다.** 렌더링할 수 없는 클립은 건너뛰고, 묶음에는 다른 클립이 남습니다.
- **각 클립은 자체 녹취로 자막이 들어갑니다.** 그래서 자막이 클립 안의 말과 맞습니다.

클립 세트는 계획 단계를 Nodaro Cloud에서 실행하며, 프레이밍을 선택하면 렌더링도 Nodaro Cloud에서 실행합니다. 셀프 호스팅 설치에서는 **연동 › nodaro.ai**에서 또는 API 키로 [설치를 Nodaro Cloud에 연결](https://nodaro.ai/docs/self-hosting/cloud-connect)하세요. 연결이 없으면 노드가 제공되지 않으며, 실행은 아무것도 시작되기 전에 거부됩니다.

## 사용 시기
- 에피소드 하나로 인스타그램 릴스, 틱톡, 유튜브 쇼츠용 세로 자막 클립을 일주일 분량 만들 때.
- 오디오만 있는 팟캐스트로 미리 듣기용 짧은 오디오 발췌를 만들 때.
- 순간 후보를 받은 뒤 검토에서 좋은 것만 남기고 그것만 렌더링할 때.

단계를 더 세밀하게 제어해야 할 때는 편집 계획, EDL 적용, 화자 뷰 같은 개별 노드를 쓰세요.

## 빠른 시작
### 노드 추가
캔버스에서 Tab을 누르고 **동영상 › 팟캐스트 › 클립 세트**를 선택하세요. 이 노드는 **오디오** 탭에도 나옵니다.

### 녹화 연결
에피소드를 **녹음** 입력에 연결하세요. 예를 들어 [동영상 업로드](https://nodaro.ai/docs/nodes/video/upload-video) 노드에서 연결합니다. 녹화는 최대 3시간까지 가능하며, 소리가 있어야 합니다.

### 클립 정하기
찾을 **클립 수**와 클립의 <strong>목표 길이(초)</strong>를 정하세요. **프레이밍**은 화자를 세로로 배치하는 기본값 `9:16`을 그대로 두거나, 다른 비율을 선택하세요.

### 실행
노드에서 **실행**을 클릭하세요. 노드에 클립마다 썸네일과 제목이 있는 칩이 하나씩 표시됩니다. 칩에 마우스를 올리면 훅이 보입니다.

Workflow: 클립 세트가 녹화한 에피소드의 가장 좋은 순간을 찾아 각각을 자막이 있는 세로 클립으로 렌더링합니다.

- 동영상 업로드 → 클립 세트 (녹음)

템플릿 마켓플레이스에는 바로 쓸 수 있는 워크플로가 두 개 있습니다. **Clip Pack**은 같은 체인을 프레이밍 없이 직접 연결한 것으로, 채워 넣기만 하면 됩니다. **Clip Pack in One Node**는 이 노드를 쓰며, **렌더링 전에 검토**가 켜져 있고, 화자를 세로로 배치한 `9:16` 프레이밍으로 약 60초 클립 8개를 만들고 가라오케 자막을 넣습니다.

## 입력
| 입력 | 받는 것 | 하는 일 |
| --- | --- | --- |
| **녹음** | 동영상 또는 오디오 | 최대 3시간의 에피소드 녹화입니다. 소리가 있어야 합니다. 오디오 녹화는 프레이밍과 자막이 없는 오디오 클립을 만듭니다. [여러 카메라](#several-cameras)에서는 각 카메라의 녹화입니다. 필수입니다. |
| **마스터 오디오** | 오디오 | [여러 카메라](#several-cameras)일 때의 믹서나 녹음기 트랙입니다. 묶음의 소리가 됩니다. 선택 사항입니다. |

3시간보다 긴 녹화나 소리가 없는 녹화는 청구되기 전에 거부됩니다.

녹화가 둘 이상이면 **녹음** 목록 순서에서 첫 번째 녹화가 카메라 1입니다. 설정 패널에 **카메라** 섹션이 표시됩니다. [여러 카메라](#several-cameras)를 참조하세요.

## 출력
| 출력 | 전달하는 것 |
| --- | --- |
| **클립** | 계획이 찾은 순간마다 클립 하나씩이며, 계획의 순서대로 각각 별도의 결과입니다. 기본값인 **개별** 연결에서는 다음 노드가 클립마다 한 번씩 실행됩니다. 오디오 녹화에서는 오디오 클립이 됩니다. |
| **클립 세트(EDL)** | 계획의 클립 세트입니다. 남긴 클립마다 편집 계획이 하나씩 있고, 각각 제목과 훅이 있으며, 내 검토 편집이 반영되어 있습니다. |

자막을 넣지 못한 클립에는 노드에 **자막 없음**이 표시됩니다.

## 설정
| 설정 | 하는 일 |
| --- | --- |
| **클립 수** | 1~50, 기본값 8입니다. 찾을 클립의 수입니다. 계획이 찾는 수는 더 적을 수 있습니다. |
| **목표 길이(초)** | 5~180, 기본값 60입니다. 각 클립의 목표 길이입니다. |
| **프레이밍** | 동영상 녹화 전용입니다. **없음 — 녹화된 비율 그대로**, 또는 화면 비율(`16:9`, `9:16`, `1:1`, `4:5`)과 **레이아웃**, **전환**, **강조**입니다. 기본값은 `9:16`, **세로 배치**, **팬**, **스케일**입니다. [프레이밍](#framing)을 참조하세요. |
| **프레이밍 방식** | 프레이밍을 선택했을 때 표시됩니다. <strong>자동 (얼굴 따라가기)</strong>, **균등 분할**, **얼굴 따라가기** 중 하나입니다. 새 노드는 <strong>자동 (얼굴 따라가기)</strong>을 씁니다. 이 설정이 생기기 전에 저장된 노드는 **균등 분할**을 씁니다. [얼굴 따라가기](#following-faces)를 참조하세요. |
| **자막** | 동영상 녹화 전용입니다. 기본적으로 켜져 있으며 **자막 스타일**을 함께 지정합니다. 기본 스타일은 <strong>가라오케(키네틱)</strong>입니다. |
| **렌더링 전에 검토** | 기본적으로 꺼져 있습니다. 켜면 실행이 검토하고 편집할 수 있는 클립의 빠른 미리 보기에서 멈춥니다. [렌더링 전에 검토](#review-before-render)를 참조하세요. |
| **편집 품질** | **이코노미**, **표준**(기본값) 또는 **프리미엄**입니다. 편집 계획 단계의 등급으로, 계획의 품질과 가격을 정합니다. |
| **지침** | 계획을 위한 짧은 지시로, 최대 4,000자입니다. 예: `the funniest moments`(가장 재미있는 순간). |
| **스타일 가이드** | 계획을 위한 더 긴 편집 지침으로, 최대 4,000자입니다. |

### 프레이밍
**프레이밍**을 화면 비율로 설정하면 노드는 각 클립을 자동 박스를 쓰는 화자 뷰로 렌더링합니다. 모든 클립은 에피소드의 화자를 기준으로 같은 방식으로 박스가 정해집니다. 기준 화자는 녹취에 이름이 있고, 10초 이상 또는 에피소드 발화 시간의 5% 이상 말하는 사람입니다. 프레이밍에는 카메라 한 대에 그런 화자가 2~6명 있어야 합니다. 그렇지 않으면 클립에 카메라가 전체 프레임으로 표시됩니다.

- **레이아웃**에는 선택한 화면 비율에서 화자 뷰가 그릴 수 있는 레이아웃만 나옵니다.
- **전환**은 화자가 바뀔 때마다 어떻게 할지 정합니다.
- **강조**는 말하는 사람을 표시합니다. **스케일**, **테두리**, **어둡게**, 이들의 조합, 또는 없음을 고를 수 있습니다.

**없음 — 녹화된 비율 그대로**를 고르면 노드는 각 클립을 EDL 적용으로 녹화의 비율 그대로 렌더링합니다.

### 얼굴 따라가기
프레이밍을 선택하면 **프레이밍 방식**이 화자 박스를 어디에서 가져올지 정합니다.

- **균등 분할.** 위에서 설명한 자동 박스입니다. 화면의 각 화자가 프레임을 균등하게 나눠 받으며, 모든 클립에서 같은 박스입니다.
- **얼굴 따라가기.** [화자 프레임](https://nodaro.ai/docs/nodes/video/speaker-frames)이 묶음 전체에서 각 얼굴을 한 번 추적하고, 모든 클립의 화자 뷰가 그 얼굴을 따라갑니다. 계획이 잘라 낸 모든 클립을 한 번에 처리하는 실행 하나이며, 클립마다 실행하지 않습니다. 화자 프레임은 샘플링한 프레임 1,000개 블록이 시작될 때마다 청구됩니다. 아직 얼굴을 화자와 짝짓지는 않습니다. 한 사람을 비추는 카메라는 그 사람을 따라가고, 여러 화자가 함께 쓰는 카메라는 균등 분할로 프레이밍됩니다.
- <strong>자동 (얼굴 따라가기).</strong> 화자 프레임을 쓸 수 있으면 얼굴을 따라가고, 그렇지 않으면 거부나 추가 청구 없이 균등 분할을 씁니다. 예상치와 앱이나 템플릿에 표시되는 가격도 같은 규칙을 따릅니다.

셀프 호스팅 설치에서는 화자 뷰와 마찬가지로 화자 프레임에도 Nodaro Cloud 연결이 필요합니다. 화자 프레임을 쓸 수 없는 곳에서는 설정 패널에 프레이밍 방식이 나오지 않으며, <strong>자동 (얼굴 따라가기)</strong>은 균등 분할이 됩니다. 그때 **얼굴 따라가기**로 설정된 노드에는 안내가 표시되고, 그 실행은 아무것도 청구되기 전에 `403 node_not_available`로 거부됩니다.

**렌더링 전에 검토**를 켜면 얼굴은 검토 전에, 계획이 잘라 낸 클립에서 추적됩니다. **최종 렌더링**은 그 추적 결과를 쓰며 화자 프레임을 다시 실행하지 않습니다. [여러 카메라](#several-cameras)에서는 화자 프레임이 전환을 마친 클립의 모든 카메라를 샘플링하며, 마스터 오디오는 샘플링하지 않습니다.

## 여러 카메라
각 카메라의 녹화를 **녹음**에 연결하세요. 믹서나 녹음기 트랙이 있으면 **마스터 오디오**에 연결하세요. 실행은 [오디오 동기화](https://nodaro.ai/docs/nodes/audio/audio-sync)로 녹화를 맞추고, 소리를 녹취하고, [화자 맵](https://nodaro.ai/docs/nodes/audio/speaker-map)으로 각 화자가 어느 카메라에 있는지 알아냅니다. 그다음 모든 녹화에 걸쳐 클립을 계획합니다. 이어서 클립마다 [카메라 전환](https://nodaro.ai/docs/nodes/video/camera-switch)이 각 장면을 말하는 사람에게 맞추고, 클립은 녹화가 하나일 때처럼 렌더링되고 자막이 들어갑니다.

- **녹음.** 대화 하나의 녹화 1~6개를 순서대로 연결합니다. 카메라 1, 카메라 2, 이런 식입니다. 순서를 바꾸려면 설정 패널의 **녹음** 목록에서 끌어 옮기세요. 그중 하나는 소리만 있어도 됩니다. 소리만 있는 녹화는 하나만 되며, 마스터 오디오가 있으면 쓸 수 없습니다.
- **마스터 오디오.** 묶음의 소리이자, 녹화를 맞추는 기준 시계입니다. 녹화는 마스터 오디오를 포함해 모두 6개까지입니다.
- **마스터 오디오가 없을 때.** 와이드 카메라 자체의 소리, 그것도 없으면 카메라 1의 소리가 소리가 되므로, 소리가 카메라 마이크 사이를 오가지 않습니다. 카메라가 두 대 이상이면 소리를 위해 한 자리를 쓰므로, 카메라는 5대까지입니다.
- **카메라 한 대와 마스터 오디오.** 카메라를 마스터 오디오에 맞추고, 그 카메라 한 대로 자릅니다. 카메라 중 하나와 같은 노드에서 연결한 마스터 오디오는 그 카메라 자체의 소리이므로, 노드는 마스터 오디오가 없을 때처럼 실행됩니다.
- **와이드 카메라.** 모든 사람을 보여 주는 카메라입니다. 전용 카메라가 없는 화자는 이 카메라에 나오며, 이 카메라는 어떤 화자의 카메라도 되지 않습니다. 기본값은 없음입니다.
- **녹음이 이미 동기화됨.** 모든 녹화가 이미 같은 시계를 쓰면 켜세요. 그러면 실행이 녹화 맞추기를 건너뛰므로 오디오 동기화 단계가 없습니다.
- **누가 어느 카메라에 있는지.** 기본적으로 화자 맵이 카메라 자체 마이크로 정합니다. 화자의 목소리를 가장 크게 듣는 카메라가 그 사람의 카메라입니다. 어느 카메라도 뚜렷하게 앞서지 않는 화자는 뚜렷한 카메라가 없는 것으로 처리되어 와이드 카메라에, 그것도 없으면 그 사람을 찍은 아무 카메라에 나옵니다. 이때 노드는 결과 아래에 그렇게 알려 줍니다. 자동 배정을 바꾸려면 화자를 카메라나 와이드 샷으로 정하세요. 화자 1은 처음 들린 목소리, 화자 2는 그다음 목소리입니다.
- **모든 클립을 시도합니다.** 카메라 전환은 클립마다 한 번 실행됩니다. 카메라 전환에 실패한 클립은 렌더링에 실패한 클립처럼 건너뛰며 청구되지 않습니다. 묶음은 다른 클립을 유지합니다.
- **멀티캠 단계가 실패하면.** 오디오 동기화와 화자 맵은 모든 클립보다 먼저 실행됩니다. 그중 하나가 실패하면 클립은 하나도 만들어지지 않고 실행이 실패하며, 실행당 수수료는 환불됩니다. **계속**을 누르면 실패한 단계와 그 뒤의 단계가 실행됩니다.
- **렌더링 전에 검토.** 여러 카메라에서는 검토한 묶음의 **최종 렌더링**이 남긴 클립마다 카메라 전환을 다시 실행한 뒤, 그 렌더링과 자막을 실행합니다.

실행 결과에는 누가 어느 카메라에 배정되었는지가 녹화 맞추기와 배정의 메모와 함께 나옵니다. 화자 맵을 쓸 수 없는 곳에서는 편집기나 앱의 실행이 첫 번째 녹화만 읽으며, 설정 패널에 그 사실이 표시됩니다.

다음은 청구되기 전에 거부됩니다.

- 소리만 있는 녹화 두 개, 또는 소리만 있는 녹화 하나와 마스터 오디오.
- 위의 한도보다 많은 녹화.
- 화면이 있는 녹화가 아닌 와이드 카메라.
- 유효하지 않은 **카메라** 설정.
- 오디오로 읽을 수 없는 마스터 오디오.

마스터 오디오 없이 녹화 하나로 실행하면 **카메라** 설정은 무시됩니다.

## 렌더링 전에 검토
**렌더링 전에 검토**를 켜면 실행이 각 클립의 미리 보기에서 멈춥니다. 각 렌더링은 더 낮은 미리 보기 요율의 미리 보기이며, 비공개 720p입니다. 자막은 아직 추가되지 않습니다.

1. 검토를 여세요. 모든 클립이 카드로 표시됩니다. 각 클립을 남기거나 빼고, 훅을 편집하세요.
2. 노드에서 **최종 렌더링**을 클릭하세요. 노드가 남긴 클립만 최고 품질로 렌더링하고, 각각에 자막을 한 번 넣습니다.

- **클립을 하나 이상 남기세요.** 모든 클립을 빼면 노드에 “렌더링하려면 클립을 하나 이상 남겨 두세요.”가 표시되고 **최종 렌더링**이 비활성화됩니다.
- **최종 렌더링은 미리 보기의 설정을 씁니다.** 프레이밍 같은 설정을 바꾸려면 노드를 다시 실행하세요.
- **최종 렌더링은 다시 할 수 있습니다.** **최종 렌더링**이 끝난 뒤 검토를 다시 편집하고 **최종 렌더링**을 클릭하세요. 남긴 클립의 렌더링과 자막이 다시 실행되고 다시 청구되지만, 수수료는 없습니다. 같은 편집을 두 번 렌더링하는 것은 거부되며, **최종 렌더링**은 한 번에 하나만 실행됩니다.
- **게시한 앱에서는** 노드가 앱 페이지에 미리 보기와 **최종 렌더링** 버튼을 표시하며, 이 버튼은 모든 클립을 최고 품질로 렌더링합니다. 앱 페이지에는 검토 화면이 없으므로 클립을 빼지 않습니다. 최종본이 만들어진 뒤에는 같은 실행의 **최종 렌더링**을 다시 하는 것이 거부됩니다. [앱에서 최종 렌더링](https://nodaro.ai/docs/concepts/apps#render-final-in-an-app)을 참조하세요.
- **뒤의 노드는 미리 보기로 실행됩니다.** Nodaro Cloud에서 노드는 미리 보기에서 멈추지만, 뒤에 연결된 노드는 미리 보기로 실행되고 청구됩니다. **최종 렌더링** 때 최종 클립으로 다시 실행됩니다.
- **누군가 검토해야 합니다.** 검토할 사람이 없는 실행은 이 노드를 통과할 수 없습니다. API, SDK, MCP `run_workflow` 도구, 트리거로 시작한 실행과 컴포넌트 안의 실행이 여기에 해당합니다. 클립 세트 앞의 노드는 실행되고 청구됩니다. 그런 다음 노드는 `preview_review_required`로 실패하며, 이 노드에는 아무것도 청구되지 않습니다. 이런 실행에서는 **렌더링 전에 검토**를 끄세요.

MCP `make_clip_pack`과 `continue_use_case` 도구는 이를 호출하는 AI 어시스턴트가 검토하므로 **렌더링 전에 검토**를 쓸 수 있습니다.

## 실행이 실패하면
- **렌더링하지 못한 클립,** 또는 [여러 카메라](#several-cameras)에서 카메라 전환에 실패한 클립. 실행은 렌더링된 클립으로 완료되며 수수료는 그대로 청구됩니다. 노드는 “클립 1개를 렌더링하지 못했습니다.”처럼 렌더링하지 못한 수를 알려 줍니다. 실패한 클립은 청구되지 않습니다. 실행이 완료되었으므로 **계속**은 없습니다. 빠진 클립을 얻는 방법은 두 가지입니다.
  - **같은 클립을 수수료 없이.** **클립 세트(EDL)** 출력으로 직접 렌더링하세요. EDL 적용 노드(프레이밍한 모습을 원하면 화자 뷰 노드)에 연결하고, 연결의 선택을 그 클립으로 정하세요. 자막을 원하면 자막 추가 노드를 더하세요. 각 단계는 각자의 요금으로 청구됩니다.
  - **새 실행.** 노드를 다시 실행하세요. 수수료를 포함한 모든 단계가 다시 청구되며, 새 계획은 다른 순간을 고를 수 있습니다.
- **자막을 넣지 못한 클립.** 클립은 자막 없이 전달되며 **자막 없음**으로 표시됩니다. 실패한 자막은 청구되지 않습니다.
- **렌더링된 클립이 없음.** 실행은 실패하며, 실행당 수수료는 환불됩니다. 메시지에 수와 이유가 나옵니다. 예: “클립 8개 중 어느 것도 렌더링하지 못했습니다: …”.
- **계획이 클립을 찾지 못함.** 실행은 “The plan found no clips in this recording.”(이 녹음에서 클립을 찾지 못했습니다)로 실패합니다. 아무것도 렌더링되지 않으며, 실행당 수수료는 환불됩니다.
- **자막 단계 전에 멈춘 실행.** 실행은 실패하며, 실행당 수수료는 환불됩니다. **계속**을 누르면 이미 렌더링된 클립을 다시 렌더링하지 않고 자막을 넣습니다.
- **그 밖의 실패한 실행.** 완료된 단계는 완료된 상태로 남습니다. 녹취, 계획, 이미 렌더링된 클립 같은 결과는 유지되며 다시 청구되지 않습니다. 노드에서 **계속**을 누르세요. 실패한 단계와 그 뒤의 단계만 다시 실행됩니다.

## 목록 항목마다 실행할 수 없음
클립 세트는 대화 하나의 녹화를 받으며, 그 결과는 이미 목록(클립마다 항목 하나)입니다. 목록에서 입력받는 클립 세트는 어떤 실행도 시작되기 전에 청구 없이 거부됩니다. 메시지는 “Clip Pack takes the recordings of one conversation. Use a separate workflow run for each episode.”(클립 세트는 대화 하나의 녹화를 받습니다. 에피소드마다 별도의 워크플로 실행을 쓰세요)입니다.

## 크레딧
클립 세트는 각 단계를 해당 노드와 같은 각자의 요금으로 청구하고, 실행마다 소액의 수수료가 더해집니다. 노드는 실행 전에 수수료를 포함한 전체 예상치를 보여 줍니다.

| 단계 | 가격 |
| --- | --- |
| 음성 텍스트 변환, ElevenLabs STT | 실행당 25크레딧 |
| 편집 계획, **클립** 모드 | 고정 요금과 녹화의 시작된 분마다의 요율이며, 둘 다 **편집 품질**로 정해집니다. 90분 녹화를 **프리미엄**으로 처리하면 836크레딧입니다. |
| 화자 뷰, 클립마다, 프레이밍이 있을 때 | 클립의 분마다 청구됩니다. 화면의 화자가 두 명 이하이고 줌이 없는 클립(기본값인 두 사람의 세로 배치 프레이밍 등)은 분당 11크레딧입니다. 그 밖의 클립은 분당 14크레딧입니다. 미리 보기는 분당 3 또는 4크레딧입니다. [화자 뷰](https://nodaro.ai/docs/nodes/video/speaker-view#credits)를 참조하세요. |
| EDL 적용, 클립마다, 프레이밍이 없거나 오디오일 때 | 클립의 분당 11크레딧입니다. 미리 보기는 분당 2크레딧입니다. |
| 자막 추가, 클립마다, 켜져 있을 때 | <strong>가라오케(키네틱)</strong>는 55크레딧입니다. 다른 스타일은 자막 스타일에 따라 33~55크레딧입니다. |
| 화자 프레임, 프레이밍이 얼굴을 따라갈 때 | 묶음 전체에 한 번, 샘플링한 프레임 1,000개 블록이 시작될 때마다 청구되며, 실행의 합계를 한 번 올림합니다. 예상치는 에피소드 길이에 양 끝 2초씩을 더해 초당 2프레임으로 셉니다. 실행은 클립 자체의 프레임으로 청구됩니다. [화자 프레임](https://nodaro.ai/docs/nodes/video/speaker-frames#credits)을 참조하세요. |
| [여러 카메라](#several-cameras) | 소리와 각 카메라에 대한 [오디오 동기화](https://nodaro.ai/docs/nodes/audio/audio-sync)로, 맞추는 녹화 수에 따라 가격이 정해집니다. 녹화가 이미 동기화되어 있으면 오디오 동기화는 없습니다. [화자 맵](https://nodaro.ai/docs/nodes/audio/speaker-map)은 묶음 전체에 한 번이며 실행당 고정 가격입니다. 카메라가 두 대 이상이면 클립마다 한 번 [카메라 전환](https://nodaro.ai/docs/nodes/video/camera-switch)도 더해지며, 실행당 고정 가격입니다. 편집 계획은 소리의 길이로 가격이 정해집니다. |

- **실행당 수수료**는 실행마다 한 번 청구됩니다. 검토 후의 **최종 렌더링**에는 수수료가 다시 청구되지 않습니다. 실패한 실행의 수수료는 환불되며, **계속**을 누르면 다시 예약됩니다. 일부 클립만 남은 실행에도 수수료가 청구됩니다.
- **청구는 각 클립 자체의 길이 기준이며,** 예상치 기준이 아닙니다. 각 클립의 렌더링은 그 클립의 분(클립마다 올림)과 그 클립의 요율로 청구됩니다. 렌더링되지 않은 클립은 렌더링 요금이, 자막이 없는 클립은 자막 요금이 청구되지 않습니다.

### 실행 전 예상치
예상치는 각 클립을 <strong>목표 길이(초)</strong>의 두 배로 계산하므로 높게 잡힙니다. 기본값 60초에서는 각 클립의 렌더링이 2분으로 예상됩니다. 프레이밍이 있으면 화자 뷰는 미리 보기와 **최종 렌더링**을 포함해 더 높은 요율로 예상됩니다. 예외는 줌 전환이 없는 **단일** 레이아웃으로, 더 낮은 요율로 예상됩니다. 계획이 찾는 수는 더 적을 수 있지만, 예상치는 요청한 클립 수로 셉니다. 미리 보기 뒤의 **최종 렌더링**은 남긴 클립을 각각의 길이로 예상합니다. 길이를 알 수 없는 녹화는 편집 계획의 상한인 180분으로 예상됩니다. 편집 계획이 분을 세는 방식은 [편집 계획](https://nodaro.ai/docs/nodes/video/edit-plan#credits)에서 설명합니다.

### 클립 세트 뒤의 노드
**클립** 출력에 **개별** 연결로 이어진 노드는 클립마다 한 번씩 실행되고, 클립마다 청구됩니다. 예를 들어 클립 8개 묶음 뒤의 [SNS 포맷](https://nodaro.ai/docs/nodes/video/social-media-format) 노드는 여덟 번 청구됩니다. 예상치는 요청한 클립 수로 세고, 실행은 전달된 클립으로 청구합니다.

## 팁
- **순간을 조정하세요.** **지침**을 쓰세요. 예: `the funniest moments`(가장 재미있는 순간), `only the part about pricing`(가격 이야기 부분만).
- **약한 클립을 먼저 빼세요.** **렌더링 전에 검토**를 켜면 최고 품질로 렌더링하기 전에 약한 클립을 빼고 훅을 다듬을 수 있습니다.
- **각 클립을 한 번씩 게시하세요.** **클립**을 **개별** 연결로 게시 노드에 연결하세요.

## 문제 해결
| 문제 | 해결 방법 |
| --- | --- |
| 실행이 시작 전에 거부됨 | 녹화가 3시간 이하이고 소리가 있는지 확인하세요. 여러 카메라에서는 녹화 수와 **카메라** 설정을 확인하세요. [여러 카메라](#several-cameras)를 참조하세요. |
| 첫 번째 녹화만 쓰였음 | 화자 맵을 쓸 수 없어서 노드가 첫 번째 녹화만 읽습니다. 설정 패널에 그 사실이 표시됩니다. |
| 목록이 노드 실행을 거부함 | 클립 세트는 대화 하나를 받습니다. 에피소드마다 별도의 워크플로 실행을 쓰세요. |
| **최종 렌더링**이 비활성화됨 | 검토에서 모든 클립을 뺐습니다. 클립을 하나 이상 남기세요. |
| 클립에 **자막 없음**이 표시됨 | 그 클립에는 자막을 넣지 못했습니다. 그 클립에 자막 추가 노드를 실행하세요. |
| 클립에 카메라가 전체 프레임으로 표시됨 | 프레이밍에는 충분히 오래 말하는 화자가 카메라 한 대에 2~6명 있어야 합니다. |
| 노드가 `preview_review_required`로 실패함 | 실행에 미리 보기를 검토할 사람이 없었습니다. API, SDK, 트리거, 컴포넌트에서의 실행에서는 **렌더링 전에 검토**를 끄세요. |
| 셀프 호스팅 설치에 노드가 없음 | 설치를 Nodaro Cloud에 연결하세요. [Nodaro Cloud에 연결](https://nodaro.ai/docs/self-hosting/cloud-connect)을 참조하세요. |

## API에서 사용
`POST /v1/clip-pack`은 실행을 시작하고 `jobId`와 `executionId`를 담아 `202`로 응답합니다. 본문에는 `mediaUrls`(녹화 URL 하나, 또는 대화 하나의 녹화를 순서대로 최대 6개)를 넣고, 선택적으로 `masterAudioUrl`, `cameras`, `count`, `targetDurationSec`, `framing`, `framingSource`, `captions`, `captionStyle`, `reviewBeforeRender`, `planTier`, `instructions`, `styleGuide`를 넣습니다. 작업은 `GET /v1/jobs/:id/status`로 폴링하세요.

- `framing`은 `{ aspect, layout, switchType, emphasisStyle }`입니다. 생략하면 기본값(`9:16`, 세로 배치, 팬, 스케일)이 됩니다. `layout`이 없는 프레이밍은 세로 배치가 되며, 그 비율에서 그릴 수 있는 레이아웃(`16:9`에서는 나란히)으로 바뀝니다. `null`은 녹화의 비율로 렌더링합니다. 노드가 그리지 않는 `emphasisStyle`은 `400 validation_error`로 응답합니다.
- `framingSource`는 `"auto"`, `"static"`, `"tracking"` 중 하나입니다. 생략하면 균등 분할인 `"static"`입니다. 화자 프레임을 쓸 수 없는 곳에서는 `"tracking"`이 `403 node_not_available`로 거부됩니다.
- `cameras`는 `{ wide?, synced?, speakerCameras? }`입니다. `wide`는 와이드 카메라의 녹화 번호 또는 `null`입니다. `synced: true`는 녹화 맞추기를 건너뜁니다. `speakerCameras`는 화자 번호를 녹화 번호에 연결하며, `0`은 와이드 샷입니다. [여러 카메라](#several-cameras)를 참조하세요.
- 녹화 여러 개나 `masterAudioUrl`에는 화자 맵이 필요합니다. 화자 맵을 쓸 수 없는 곳에서는 청구되기 전에 `403 node_not_available`로 거부됩니다.
- 작업의 `output_data`에는 클립(`clips`, 계획 순서의 `{ url, title, hook, clipKey, thumbnailUrl, captionsFailed }` 목록)과 그 첫 번째인 `videoUrl`(오디오 클립은 `audioUrl`)이 들어 있습니다. `failedClips`는 렌더링하지 못한 클립 수(카메라 전환에 실패한 클립 포함), `failedCaptions`는 자막이 없는 클립 수이며, 각각 있을 때만 들어갑니다. 클립 세트(`json`), 녹취(`transcript`), `quality`(미리 보기는 `proxy`, 그 밖에는 `final`)도 들어 있습니다. 녹화 여러 개나 마스터 오디오로 실행하면 `cameras`가 더해지며, 각 화자, 그 화자가 받은 카메라의 녹화 번호(와이드 샷은 `null`), 녹화 맞추기와 배정의 메모가 들어 있습니다. 실패한 실행은 완료된 부분을 유지하고, 실패한 단계를 `failedStep`에 표시합니다.
- `Idempotency-Key` 헤더를 붙이면 같은 요청을 재시도했을 때 같은 `jobId`와 `"deduped": true`로 응답하며, 아무것도 시작하지 않습니다.
- `POST /v1/clip-pack/estimate`는 같은 본문을 받아, 아무것도 시작하지 않고 `{ data: { totalCredits, stepsCredits, feeCredits, durationSec } }`로 응답합니다.
- `POST /v1/clip-pack/continue`에 `{ jobId, mode }`를 보내면 실행을 이어 갑니다. `"mode": "from-failed"`는 실패한 실행이 완료하지 못한 부분을 실행합니다. `"mode": "render-final"`은 검토 실행에서 남긴 클립을 렌더링하며, 선택적으로 클립을 남기거나 빼고 훅을 편집한 `editedEdl`을 받습니다. 모든 클립을 뺀 검토는 `409 use_case_nothing_kept`로 응답합니다. 미리 보기가 아니었던 실행의 최종 렌더링은 `render_final_not_preview`로, 이미 렌더링된 편집의 최종 렌더링은 `render_final_already_rendered`로 응답합니다.

SDK(`client.edit.clipPack`, `client.edit.estimateClipPack`, `client.edit.continueUseCase`), CLI(`nodaro edit clip-pack`, 예상치는 `--estimate`, 그리고 `nodaro edit continue-use-case`), MCP `make_clip_pack`, `estimate_use_case`, `continue_use_case` 도구는 같은 라우트를 호출합니다. [단일 노드 실행](https://nodaro.ai/docs/developers/api/nodes), [SDK에서 편집](https://nodaro.ai/docs/developers/sdk/editing), [MCP 분석 및 EDL 도구](https://nodaro.ai/docs/mcp/tools/analysis-and-edl)를 참조하세요.

## 자주 묻는 질문

### 클립 세트 노드는 무엇을 하나요?

클립 세트 노드는 팟캐스트나 인터뷰 녹화 하나를 받아 짧은 클립 묶음을 돌려줍니다. 녹화를 녹취하고, 가장 좋은 순간을 찾고, 각 순간을 별도의 클립으로 렌더링한 뒤 자막을 넣습니다. 기본적으로 각 클립은 세로 9:16 동영상입니다.

### 클립 세트는 클립을 몇 개 만드나요?

클립 세트 노드는 클립 수에 정한 개수까지 찾습니다. 1~50 사이이며 기본값은 8입니다. 계획이 찾는 순간은 그보다 적을 수 있습니다. 묶음에는 찾은 클립이 들어가며, 그 렌더링만 청구됩니다.

### 최종 렌더링 전에 남길 클립을 고를 수 있나요?

네. 클립 세트 노드에서 렌더링 전에 검토를 켜세요. 실행이 빠른 미리 보기에서 멈추고, 검토 화면에서 각 클립이 카드로 표시되어 남기거나 뺄 수 있습니다. 그다음 최종 렌더링이 남긴 클립만 최고 품질로 렌더링합니다.

### 클립 세트는 크레딧이 얼마나 드나요?

클립 세트 노드는 음성 텍스트 변환, 편집 계획, 클립마다의 렌더링과 자막이라는 각 단계를 각자의 요금으로 청구하고, 실행마다 소액의 수수료가 더해집니다. 노드는 실행 전에 전체 예상치를 보여 주며, 예상치는 높게 잡힙니다.

### 클립 세트를 오디오만 있는 팟캐스트에도 쓸 수 있나요?

네. 클립 세트 노드는 오디오 녹화로 오디오 클립을 만듭니다. 프레이밍과 자막은 없습니다.

### 클립 세트로 여러 카메라로 찍은 팟캐스트를 편집할 수 있나요?

네. 대화 하나의 녹화를 최대 6개까지 녹음에 연결하고, 믹서 트랙이 있으면 마스터 오디오에 연결하세요. 클립 세트 노드가 녹화를 맞추고, 각 화자가 어느 카메라에 있는지 알아낸 뒤, 모든 클립의 각 장면을 말하는 사람에게 맞춥니다.

### 클립 하나가 렌더링에 실패하면 어떻게 되나요?

클립 세트 실행은 그 클립을 건너뛰고, 다른 클립을 남긴 채 완료됩니다. 노드는 렌더링하지 못한 클립 수를 알려 주며, 실패한 클립은 청구되지 않습니다.