Nodaro 문서파이프라인
MCP 도구로 프롬프트 하나에서 스토리 → 동영상 파이프라인을 시작하고, 단계를 지켜보고, 채팅으로 승인하거나 다듬고, 완료된 파이프라인을 어느 단계에서든 브랜치하세요.
Nodaro Cloud에서 사용할 수 있습니다
파이프라인 도구는 AI 어시스턴트에서 스토리 → 동영상 파이프라인을 조종합니다. 프롬프트 하나로 파이프라인이 시작되어 스크립트를 쓰고, 출연진과 장소를 만들고, 샷을 계획해 렌더링하고, 완성된 영화를 합칩니다. 어시스턴트는 단계를 지켜보고, 승인하고, 채팅으로 다듬고, 완료된 파이프라인을 어느 단계에서든 브랜치할 수 있습니다. 같은 엔진의 캔버스 버전은 스토리 → 동영상 노드입니다.
파이프라인 도구는 Nodaro Cloud에만 있습니다. pipelines:read, pipelines:execute, pipelines:approve 권한을 허용했을 때만 나타납니다.
단계
파이프라인은 script, characters, objects, locations, shot_list, scene_images, animate_audio_edit, post_merge 단계를 순서대로 실행합니다. auto 모드에서는 모든 단계를 스스로 실행하며, 두 샷 사이에 계획한 매치 컷이 맞지 않을 때만 멈춥니다. 그러면 실행은 모든 불일치가 REST API로 수락될 때까지 기다립니다. 불일치를 수락하는 MCP 도구는 없습니다. manual과 guided 모드에서는 승인 게이트에서 멈추며, 그 단계는 awaiting_approval 상태로 기다립니다.
start_pipeline
스토리 프롬프트로 새 스토리 → 동영상 파이프라인을 시작합니다.
권한: pipelines:execute. 크레딧: 파이프라인이 실행하는 모든 생성의 크레딧. get_pipeline_status에서 진행되는 동안 크레딧을 볼 수 있습니다.
| 매개변수 | 타입 | 설명 |
|---|---|---|
story_prompt | string | 필수. 영화의 내용으로, 최대 4,000자입니다. |
format | string | trailer, short_film, music_video, reel, commercial 중 하나입니다. 기본값은 reel입니다. |
target_duration_seconds | integer | 영화의 길이로, 5~600초입니다. 기본값은 15입니다. |
mode | string | auto(기본값)는 매치 컷 불일치가 있을 때를 빼고 사람의 개입 없이 끝까지 실행합니다. manual과 guided는 승인 게이트에서 멈춥니다. |
output_resolution | string | 480p, 720p, 1080p, 4K 중 하나입니다. 기본값은 720p입니다. |
music_enabled | boolean | 음악을 추가합니다. 기본값은 true입니다. |
narration_enabled | boolean | 내레이션을 추가합니다. 기본값은 false입니다. |
lipsync_enabled | boolean | 캐릭터의 입 모양을 대사에 맞춥니다. 기본값은 false입니다. |
반환값: 새 파이프라인 ID입니다. get_pipeline_status를 폴링하고, 단계가 기다리는 동안에는 pipeline_pending_approvals도 폴링하세요.
어시스턴트가 파이프라인을 시작하면 내레이션과 립싱크는 기본적으로 꺼져 있습니다. 그래서 사람이 지켜보지 않는 실행은 요청하지 않는 한 여기에 크레딧을 쓰지 않습니다.
get_pipeline_status
파이프라인의 상태를 반환합니다. 상태(pending, running, awaiting_approval, completed, failed), 현재 단계, 크레딧 카운터, 모드, 그리고 실패했을 때의 failure_reason이 담깁니다.
권한: pipelines:read. 크레딧: 무료.
| 매개변수 | 타입 | 설명 |
|---|---|---|
pipeline_id | string | 필수. 파이프라인 ID입니다. |
pipeline_pending_approvals
승인을 기다리는 단계를 각 단계의 출력 스냅샷과 함께 나열합니다. 목록이 비어 있으면 기다리는 단계가 없다는 뜻입니다. 매치 컷 불일치가 없는 auto 모드로 실행 중이거나, 아직 생성 중인 경우입니다.
권한: pipelines:read. 크레딧: 무료.
| 매개변수 | 타입 | 설명 |
|---|---|---|
pipeline_id | string | 필수. 파이프라인 ID입니다. |
chat_pipeline_stage
승인을 기다리는 단계에 대해 다듬기 감독에게 “결말을 더 어둡게 해 줘” 같은 메시지를 보냅니다. 파이프라인은 guided 모드여야 합니다.
권한: pipelines:approve.
| 매개변수 | 타입 | 설명 |
|---|---|---|
pipeline_id | string | 필수. 파이프라인 ID입니다. |
stage | string | 필수. 기다리는 단계로, script 또는 post_merge입니다. |
message | string | 필수. 내 메시지로, 최대 8,000자입니다. |
반환값: 감독의 답변과, 수정을 제안했을 때의 proposed_change입니다. 변경은 apply_chat_proposal로 적용하세요.
apply_chat_proposal
감독의 답변이 제안한 변경을 수락하고, 그 변경을 반영해 단계를 승인합니다.
권한: pipelines:approve. 크레딧: 무료.
| 매개변수 | 타입 | 설명 |
|---|---|---|
pipeline_id | string | 필수. 파이프라인 ID입니다. |
stage | string | 필수. 채팅이 열린 단계입니다. |
turn_id | string | 필수. 수락할 변경을 담은 감독 답변의 ID입니다. |
get_pipeline_stage_chat
단계 채팅의 메시지를 오래된 순서로 나열합니다. 아직 아무도 쓰지 않았으면 목록은 비어 있습니다.
권한: pipelines:read. 크레딧: 무료.
| 매개변수 | 타입 | 설명 |
|---|---|---|
pipeline_id | string | 필수. 파이프라인 ID입니다. |
stage | string | 필수. 채팅이 열린 단계입니다. |
branch_pipeline
완료된 파이프라인을 한 단계부터 다시 실행하는 새 파이프라인을 만듭니다. 그 앞의 단계와 그 단계의 캐릭터, 오브젝트, 장소는 승인된 상태로 복사됩니다. 선택한 단계와 이후의 모든 단계는 다시 실행됩니다.
권한: pipelines:execute. 크레딧: 다시 실행되는 단계의 크레딧.
| 매개변수 | 타입 | 설명 |
|---|---|---|
pipeline_id | string | 필수. 상태가 completed인 파이프라인입니다. |
from_stage | string | 필수. script, characters, objects, locations, shot_list, scene_images, animate_audio_edit, post_merge 중 하나입니다. |
반환값: 새 파이프라인 ID입니다.
자주 묻는 질문
스토리 → 동영상 파이프라인은 무엇을 만드나요?
스토리 프롬프트 하나로 완성된 영화를 만듭니다. 파이프라인은 스크립트를 쓰고, 캐릭터, 오브젝트, 장소를 만들고, 샷을 계획하고, 장면 이미지를 생성하고, 오디오와 함께 애니메이션을 만들고, 최종 편집본을 합칩니다.
auto, manual, guided 모드는 어떻게 다른가요?
auto는 프롬프트부터 완성된 영화까지 스스로 실행합니다. 두 샷 사이에 계획한 매치 컷이 맞지 않을 때만 멈추며, 모든 불일치가 REST API로 수락될 때까지 기다립니다. 불일치를 수락하는 MCP 도구는 없습니다. manual과 guided는 승인 게이트에서 멈춥니다. guided에서는 승인하기 전에 채팅으로 스크립트와 최종 편집본을 다듬을 수도 있습니다.
파이프라인을 중간부터 다시 실행할 수 있나요?
네, 완료된 뒤라면 가능합니다. branch_pipeline은 선택한 단계 앞의 단계를 승인된 상태로 복사하고, 그 단계와 이후의 모든 단계를 새 파이프라인으로 다시 실행합니다.
내 어시스턴트에 파이프라인 도구가 보이지 않는 이유는 무엇인가요?
파이프라인 도구에는 파이프라인 권한이 필요하며, Nodaro Cloud에만 있습니다. 다시 연결하고 동의 화면에서 파이프라인 권한을 허용하세요.
관련 문서
스토리 → 동영상
MCP 도구 레퍼런스
파이프라인
영화 디렉터
최종 업데이트