Nodaro 문서샷 시퀀스와 동영상 디렉터
호출 한 번으로 내레이션이 있는 모션 그래픽 동영상을 만드는 동영상 디렉터 도구와, 보이스오버에 맞춰 요소를 등장시키는 샷 시퀀스 도구의 매개변수입니다.
동영상 디렉터와 샷 시퀀스 도구는 내레이션이 있는 모션 그래픽 동영상을 만듭니다. 키네틱 타이포그래피, 도형, 이미지가 보이스오버가 해당 문구를 말하는 순간에 나타납니다. 동영상 디렉터 도구는 이를 호출 한 번으로 하고, 샷 시퀀스 도구는 각 단계를 직접 다룰 수 있게 합니다. 이 페이지에는 매개변수가 나와 있습니다. 사용 방법은 동영상 디렉터와 샷 시퀀스에서 설명합니다.
| 도구 | 권한 | 크레딧 |
|---|---|---|
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(100casing(uppercase, lowercase, none), tracking(-0.2 |
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
알고 있는 녹취록을 오디오나 동영상 클립에 정렬하고, 모든 단어의 시작 시간과 끝 시간을 반환합니다. 동영상은 먼저 음성 트랙을 추출하므로, 말하는 사람이 나오는 클립도 바로 정렬할 수 있습니다. 강제 정렬 노드처럼 동작합니다.
권한: 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. 크레딧: 동영상 렌더링 노드와 같이, 프레임 크기와 관계없이 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는 크레딧을 사용하며, 호출 한 번으로 끝나는 두 도구도 마찬가지입니다.
관련 문서
동영상 디렉터
샷 시퀀스
오디오
강제 정렬
최종 업데이트