# 샷 시퀀스와 동영상 디렉터

> 호출 한 번으로 내레이션이 있는 모션 그래픽 동영상을 만드는 동영상 디렉터 도구와, 보이스오버에 맞춰 요소를 등장시키는 샷 시퀀스 도구의 매개변수입니다.

Source: https://nodaro.ai/ko/docs/mcp/tools/shot-sequence-and-video-director

**동영상 디렉터와 샷 시퀀스 도구**는 내레이션이 있는 모션 그래픽 동영상을 만듭니다. 키네틱 타이포그래피, 도형, 이미지가 보이스오버가 해당 문구를 말하는 순간에 나타납니다. 동영상 디렉터 도구는 이를 호출 한 번으로 하고, 샷 시퀀스 도구는 각 단계를 직접 다룰 수 있게 합니다. 이 페이지에는 매개변수가 나와 있습니다. 사용 방법은 [동영상 디렉터](https://nodaro.ai/docs/mcp/video-director)와 [샷 시퀀스](https://nodaro.ai/docs/mcp/shot-sequence)에서 설명합니다.

| 도구 | 권한 | 크레딧 |
| --- | --- | --- |
| `start_video_director` | 없음 | 무료 |
| `create_explainer` | `workflows:execute` | 작성 실행, 보이스오버, 렌더링. 보이스오버에 단어 타이밍이 없으면 강제 정렬이 추가됩니다. Nodaro Cloud 전용. |
| `create_launch_video` | `workflows:execute` | `create_explainer`와 같음. Nodaro Cloud 전용. |
| `list_shot_shapes` | 없음 | 무료 |
| `get_shot_shape` | 없음 | 무료 |
| `list_brand_presets` | 없음 | 무료 |
| `forced_alignment` | `workflows:execute` | 33크레딧 |
| `resolve_shot_sequence` | `workflows:execute` | 무료, 작업 없음 |
| `render_shot_sequence` | `workflows:execute` | 55크레딧 |

## `start_video_director`
어시스턴트가 내레이션 동영상을 직접 작성할 때 따르는 모션 디렉터 가이드를 반환합니다. 장르와 스토리 구조를 고르는 법, 보이스오버를 큐 문구로 쓰는 법, 샷 시퀀스 브리프를 만드는 법, 파이프라인을 실행하는 법을 다룹니다. 아무것도 바꾸지 않으며 몇 번이든 호출할 수 있습니다.

이 도구에는 매개변수가 없습니다.

## `create_explainer`
주제에 대한 내레이션과 타임코드가 있는 설명 동영상을 호출 한 번으로 쓰고 렌더링합니다. 디렉터가 보이스오버 스크립트와 샷 시퀀스 브리프를 쓰고, 보이스오버를 생성해 단어 단위로 정렬한 다음 MP4를 렌더링합니다.

**권한:** `workflows:execute`. **크레딧:** 작성 실행에 보이스오버와 렌더링을 더한 비용입니다. 보이스오버에 단어 타이밍이 없으면 강제 정렬 비용이 추가됩니다. `list_models`는 이 가격을 `video-director` 아래에 나열합니다. **Nodaro Cloud 전용.**

| 매개변수 | 타입 | 설명 |
| --- | --- | --- |
| `topic` | string | **필수.** 설명 동영상이 가르칠 내용으로, 1~8,000자입니다. |
| `brand` | string 또는 object | `cobalt-corporate` 같은 브랜드 프리셋 ID 또는 내 브랜드 토큰입니다. 아래를 참조하세요. |

**반환값:** 작업 ID입니다. 카드에 진행 상황이 표시되고 동영상이 재생됩니다. 카드가 없으면 `get_job`을 폴링하세요. MP4는 `output_data.videoUrl`에 있습니다.

## `create_launch_video`
제품 설명으로 내레이션이 있는 제품 출시 동영상을 호출 한 번으로 쓰고 렌더링합니다.

**권한:** `workflows:execute`. **크레딧:** `create_explainer`와 같습니다. **Nodaro Cloud 전용.**

| 매개변수 | 타입 | 설명 |
| --- | --- | --- |
| `brief` | string | 제품에 대한 설명으로, 무엇인지, 누구를 위한 것인지, 주요 기능, 톤을 담습니다. 1~8,000자입니다. |
| `brand` | string 또는 object | `create_explainer`와 같습니다. |
| `url` | string | 캡처할 제품 URL입니다. 지원되지 않습니다. `brief`가 없으면 도구가 브리프가 필요하다고 응답하고, 브리프가 있으면 URL은 무시됩니다. |

**반환값:** 작업 ID입니다.

### `brand` 객체
| 필드 | 참고 |
| --- | --- |
| `palette` | **필수.** 16진수 색상입니다. `bg`, `text`, `accent`는 필수이고, `accent2`, `bgAlt`, `line`, `textMuted`는 선택입니다. |
| `fonts` | **필수.** `heading`과 `body`로, 각각 지원되는 24개 글꼴 패밀리 중 하나입니다. 예를 들어 Inter, Montserrat, Playfair Display, Bebas Neue가 있습니다. Rubik, Heebo, Cairo, Tajawal은 히브리어와 아랍어를 지원합니다. 선택 항목인 `headingType`과 `bodyType`은 `weight`(100~900), `casing`(`uppercase`, `lowercase`, `none`), `tracking`(-0.2~0.5em)을 설정합니다. |
| `logo` | 선택입니다. 워드마크 텍스트인 `name`은 필수입니다. `tagline`은 그 아래의 한 줄입니다. `image`는 Nodaro에 업로드한 PNG, WebP, JPEG의 `https` URL입니다. `imageBackdrop`은 이미지 뒤 패널의 16진수 색상입니다. |

## `list_shot_shapes`
샷 시퀀스 블루프린트 15개의 카탈로그를 반환합니다. `kinetic-type-beats`나 `titlecard-reveal` 같은 미리 만들어진 애니메이션 비트로, 각각의 역할, 설명, 프레임 단위 기본 길이가 담깁니다. 비트마다 블루프린트를 고를 수 있도록 브리프를 쓰기 전에 호출하세요.

이 도구에는 매개변수가 없습니다.

## `get_shot_shape`
블루프린트 하나를 자세히 반환합니다. 역할, 설명, 기본 길이, `params`의 JSON 스키마, 그리고 브리프에 붙여 넣을 수 있는 채워진 예시가 담깁니다.

| 매개변수 | 타입 | 설명 |
| --- | --- | --- |
| `id` | string | **필수.** `titlecard-reveal` 같은 블루프린트 ID입니다. 알 수 없는 ID이면 알려진 ID 목록과 함께 오류를 반환합니다. |

## `list_brand_presets`
`midnight-violet`, `editorial-cream` 같은 브랜드 프리셋 8개를 반환합니다. 이름이 붙은 팔레트와 글꼴 조합으로, 라벨, 분위기, 설명, 팔레트, 글꼴이 담깁니다. 프리셋 ID를 `brand`로 넘기면 모든 장면이 일관되게 유지됩니다.

이 도구에는 매개변수가 없습니다.

## `forced_alignment`
알고 있는 녹취록을 오디오나 동영상 클립에 정렬하고, 모든 단어의 시작 시간과 끝 시간을 반환합니다. 동영상은 먼저 음성 트랙을 추출하므로, 말하는 사람이 나오는 클립도 바로 정렬할 수 있습니다. [**강제 정렬**](https://nodaro.ai/docs/nodes/audio/forced-alignment) 노드처럼 동작합니다.

**권한:** `workflows:execute`. **크레딧:** 33크레딧.

| 매개변수 | 타입 | 설명 |
| --- | --- | --- |
| `transcript` | string | **필수.** 실제로 말한 단어 그대로이며, 최대 50,000자입니다. 샷 시퀀스라면 보이스오버 스크립트 그대로입니다. |
| `audio_url` 또는 `audio_asset_id` | string | 오디오나 동영상으로, URL 또는 Nodaro 작업 ID입니다. |

**반환값:** 작업 ID입니다. 정렬 결과는 `output_data.alignment`에 있으며, 초 단위 `{ word, start, end }`의 목록입니다.

## `resolve_shot_sequence`
샷 시퀀스 브리프와 단어 타이밍을 렌더링할 수 있는 계획으로 만듭니다. 각 큐를 해당 단어와 맞추고, 큐에 기반한 모든 등장을 정확한 프레임으로 바꿉니다. 즉시 실행되어 작업 없이 계획을 반환합니다.

**권한:** `workflows:execute`. **크레딧:** 무료.

| 매개변수 | 타입 | 설명 |
| --- | --- | --- |
| `brief` | object | **필수.** 샷 시퀀스 브리프로, 내레이션, 장면, 샷, 등장 요소가 담깁니다. |
| `audio_url` | string | **필수.** 내레이션 오디오입니다. |
| `alignment` | array | **필수.** `forced_alignment`의 `output_data.alignment`입니다. |

**반환값:** `plan`과 `warnings`입니다. 경고의 예로는 찾지 못해 비례 타이밍으로 대체된 큐가 있습니다. 장면이 시간상으로 겹치면 도구가 `422 scene_overlap`을 반환합니다. 브랜드 로고 이미지는 여기서 자동으로 추가되지 않습니다. 로고를 보여 주려면 `logo-assemble-lockup` 등장 요소를 직접 넣으세요.

## `render_shot_sequence`
확정된 계획을 MP4로 렌더링합니다. 동영상은 내 라이브러리에도 저장됩니다.

**권한:** `workflows:execute`. **크레딧:** [**동영상 렌더링**](https://nodaro.ai/docs/nodes/video/render-video) 노드와 같이, 프레임 크기와 관계없이 55크레딧.

| 매개변수 | 타입 | 설명 |
| --- | --- | --- |
| `plan` | object | **필수.** `resolve_shot_sequence`에서 받은 계획입니다. |

**반환값:** 작업 ID입니다. 카드에 진행 상황이 표시되고 동영상이 재생됩니다.

## 자주 묻는 질문

### create_explainer와 샷 시퀀스 도구는 어떻게 다른가요?

create_explainer는 호출 한 번으로 스크립트와 브리프를 쓰고, 보이스오버를 생성해 정렬하고, 동영상을 렌더링합니다. 샷 시퀀스 도구를 쓰면 각 단계를 직접 진행하고 렌더링 전에 브리프를 검토할 수 있습니다.

### 동영상 디렉터가 내 브랜드 색상과 로고를 사용할 수 있나요?

네. brand에 list_brand_presets의 프리셋 ID를 넘기거나, 내 팔레트, 글꼴, 로고를 넘기세요. 로고 이미지는 Nodaro에 업로드한 PNG, WebP, JPEG 이미지여야 합니다.

### 이 도구 모음에서 무료인 도구는 무엇인가요?

start_video_director, list_shot_shapes, get_shot_shape, list_brand_presets, resolve_shot_sequence는 비용이 들지 않습니다. forced_alignment와 render_shot_sequence는 크레딧을 사용하며, 호출 한 번으로 끝나는 두 도구도 마찬가지입니다.