동영상

동영상 도구로 어시스턴트는 Nodaro에서 동영상을 만들고 변형할 수 있습니다. 텍스트나 이미지로 클립을 생성하고, 연장하거나 스타일을 바꾸고, 조명을 바꾸고, 업스케일하고, 얼굴이 말하게 하거나 움직임을 따라 하게 합니다. 각 도구는 작업을 시작하고 그 ID를 반환하며, 결과는 내 라이브러리에 저장됩니다. 모든 동영상 도구에는 workflows:execute 권한이 필요합니다. 동영상 작업은 보통 2~10분이 걸립니다.

generate_video

텍스트 프롬프트로 동영상을 만듭니다. 동영상 생성 노드와 같은 방식으로 작동합니다.

권한: workflows:execute. 크레딧: 모델의 가격이며, 대부분의 모델은 길이와 해상도로 가격을 정합니다. 비용을 안내하기 전에 list_models에서 모델의 pricing을 확인하세요.

반환값: 작업 ID입니다. MCP Apps를 지원하는 클라이언트에서는 동영상이 준비되면 카드에서 재생됩니다.

Seedance에서는 여러 순간이 있는 동영상을 Shot 1: … Shot 2: … 형식으로 쓰고, 샷마다 카메라 움직임은 하나만 쓰고, 소리는 프롬프트에서 설명하세요. generate-video로 get_node_skill을 호출하면 모델 계열마다의 프롬프트 규칙을 반환합니다.

레퍼런스 동영상은 모델에게 그 클립에서 무언가를 따라 하라고 알려 줍니다. 무엇을 위한 동영상인지 reference_video_captions에 적으세요. 예를 들어 3D 장면의 회색 클레이 렌더링은 룩이 아니라 레이아웃 가이드입니다. 캡션이 없으면 모델이 회색 클레이 룩까지 따라 할 수 있습니다.

모델별 참고 사항

Seedance 2, MiniMax H3, Wan 3.0에서는 레퍼런스와 함께 보낸 시작 프레임이나 종료 프레임이 레퍼런스 이미지 하나로 추가되며, 프롬프트에서 시작 프레임이나 마지막 프레임으로 설명됩니다. Seedance에서는 레퍼런스 동영상이 입력 길이와 출력 길이를 합쳐 청구되므로, 레퍼런스 클립이 길수록 더 많은 크레딧이 예약됩니다.

인물의 얼굴 유지

Gemini Omni나 Gemini Omni Flash에서 실제 인물의 얼굴을 유지하려면 character_references를 넘기세요. { image_url, description } 항목을 최대 3개까지 넣을 수 있으며, 각 항목에 body_image_url, name, voice_preset을 선택적으로 더할 수 있습니다. image_url은 인물 사진이고, description은 그 인물에 대한 설명입니다. 이것은 모델 자체의 정체성 입력이므로 얼굴을 유지합니다. 반면 reference_image_urls는 클립의 방향만 잡아 줍니다.

• 다른 모델은 이 입력 없이 실행하지 않고 오류로 응답합니다.
• 시작 프레임과 함께 쓸 수 없습니다.
• 레퍼런스 이미지(각 1단위), 원본 동영상(2단위)과 함께 모델의 입력 예산 7단위를 나눠 씁니다. 캐릭터 하나는 1단위이며, body_image_url이 있으면 2단위입니다.
• voice_preset은 kore 같은 Gemini 보이스 ID입니다. 여러 클립에 걸쳐 그 캐릭터의 보이스를 똑같이 유지합니다.

캐릭터 레퍼런스는 클립 가격에 크레딧을 더하지 않습니다.

animate_image

정지 이미지를 동영상으로 만듭니다. 종료 프레임도 보내면 첫 번째 그림에서 두 번째 그림으로 움직이는 동영상이 됩니다. 동영상 생성의 이미지로 동영상 만들기 모드와 같은 방식으로 작동합니다.

권한: workflows:execute. 크레딧: 모델의 가격입니다.

도구는 보낸 값에 따라 모드를 고릅니다. 프레임(첫 프레임과 선택 사항인 마지막 프레임) 또는 레퍼런스입니다. 레퍼런스 동영상과 오디오는 종료 프레임과 함께 쓸 수 없습니다. 끊김 없는 루프를 만들려면 첫 프레임과 마지막 프레임에 같은 이미지를 쓰고 소리를 끈 다음, combine_videos로 사본을 잇고 merge_video_audio로 소리를 추가하세요.

반환값: 작업 ID입니다.

extend_video

클립을 시간 순서대로 이어 갑니다. 먼저 모델을 고르세요. 두 모델은 자신이 생성한 동영상을 이어 가고, 한 모델은 어떤 동영상이든 연장합니다.

권한: workflows:execute. 크레딧: 연장 모델의 가격입니다.

반환값: 작업 ID입니다. seedance-2-extend는 다음에 일어나는 일을 오디오와 함께 생성하고, 원본과 이어 클립 하나로 만듭니다.

modify_video

프롬프트로 기존 클립의 스타일을 바꾸거나 편집합니다. 동영상으로 동영상 만들기 노드와 같은 방식으로 작동합니다.

권한: workflows:execute. 크레딧: 모델의 가격입니다.

seedance-2-5에서는 프롬프트가 클립 전체를 편집하는 지시문입니다. 결과는 원본의 길이와 화면 비율을 유지하며, 클립은 4~30초여야 합니다. 레퍼런스 동영상을 쓰는 Seedance 2.5 실행처럼 청구됩니다. 입력 초와 출력 초를 합한 값으로, 가장 긴 클립을 기준으로 예약했다가 실제로 나온 길이로 정산합니다.

반환값: 작업 ID입니다.

relight_video

원본 동영상 자체의 픽셀로 클립의 조명을 바꾸거나, 배경을 교체하거나 스타일을 바꾸거나, 새 요소를 합성합니다. Beeble SwitchX로 실행되며, 조명 변경 및 교체 노드와 같은 방식으로 작동합니다.

권한: workflows:execute. 크레딧: 프레임 수와 출력 해상도로 정해집니다.

반환값: 작업 ID입니다. 결과에는 SwitchX 출처 표시가 붙습니다.

video_upscale

클립을 더 높은 해상도로 업스케일합니다. 동영상 업스케일 노드와 같은 방식으로 작동합니다.

권한: workflows:execute. 크레딧: 업스케일 모델의 가격입니다.

seedance-2-5-hd는 Seedance 2.5 초안을 같은 테이크로 1080p에서 다시 렌더링합니다. 가격은 초안의 길이로 정해집니다. 동영상 업스케일을 참고하세요.

반환값: 작업 ID입니다.

video_depth

동영상을 가까운 곳은 밝고 먼 곳은 어두운 깊이 동영상으로 바꿉니다. 동영상 깊이 노드와 같은 방식으로 작동합니다.

권한: workflows:execute. 크레딧: 클립 길이에 따라 정해집니다. 동영상 깊이를 참고하세요.

모델이 받지 않는 설정은 제외됩니다. 2,400프레임이나 300초를 넘는 클립은 크레딧이 예약되기 전에 거부됩니다.

반환값: 작업 ID입니다.

video_mask

일반 텍스트로 설명한 피사체를 동영상 전체에서 추적해, 피사체가 있는 곳이 흰색인 흑백 마스크 동영상을 반환합니다. 동영상 마스크 노드와 같은 방식으로 작동합니다.

권한: workflows:execute. 크레딧: 클립 길이에 따라 정해지며, SAM 3.1에서 55~3,108크레딧입니다. SAM 3은 절반입니다.

읽을 수 없거나 너무 긴 클립은 요금이 청구되기 전에 거부됩니다. 어떤 프레임에서도 맞는 것이 없는 프롬프트는 실패하고 크레딧이 환불됩니다. 작업 ID를 mask_composite에 mask_asset_id로 전달하세요.

반환값: 작업 ID입니다.

lip_sync

얼굴이 오디오 트랙을 말하거나 노래하게 합니다. 인물 사진은 말하는 얼굴 영상이 되고, 기존 클립의 입은 새 오디오를 따라 움직입니다. 립싱크 노드와 같은 방식으로 작동합니다.

권한: workflows:execute. 크레딧: 모델의 가격입니다. 도구의 model 설명에 모델마다의 가격이 나와 있습니다.

lip-sync로 get_node_skill을 호출하면 노래, 더빙, 영화 같은 전신 샷, 가장 저렴한 초안에 각각 어떤 모델이 맞는지 설명합니다.

반환값: 작업 ID입니다. 동영상이 준비되면 카드에서 재생됩니다.

speech_to_video

인물 사진이 오디오 클립을 말하도록 움직입니다. 얼굴은 립싱크되고 머리와 몸도 움직입니다. Wan Speech to Video로 실행되며, 음성으로 동영상 만들기 노드와 같은 방식으로 작동합니다.

권한: workflows:execute. 크레딧: 33~66크레딧.

반환값: 작업 ID입니다.

motion_transfer

구동 동영상의 움직임을 캐릭터 이미지에 복사해, 캐릭터가 같은 동작을 하게 합니다. 모션 전이 노드와 같은 방식으로 작동합니다.

권한: workflows:execute. 크레딧: 모델과 길이에 따른 가격입니다.

반환값: 작업 ID입니다.

face_swap

동영상 속 얼굴을 인물 사진의 얼굴로 교체합니다. 얼굴 교체 노드와 같은 방식으로 작동합니다.

권한: workflows:execute. 크레딧: 143크레딧.

반환값: 작업 ID입니다.

stop_video_pro

실행 중인 동영상 생성 Pro 작업을 멈춥니다. 동영상 생성 Pro는 긴 동영상을 세그먼트 단위로 만드는 엔진으로, 예를 들어 동영상 생성 Pro 노드가 있는 워크플로에서 쓰입니다. 진행 중인 세그먼트는 중단되지만 요금은 청구되고, 남은 세그먼트는 건너뛰며, 완료된 모든 세그먼트가 이어져 작업의 최종 동영상이 됩니다. 예약된 크레딧의 나머지는 환불됩니다. 아직 시작하지 않은 작업은 전액 환불과 함께 취소됩니다.

권한: workflows:execute. 크레딧: 무료이며, 쓰지 않은 예약분은 환불됩니다.

반환값: 확인 응답입니다. get_job으로 작업을 폴링하세요. 작업은 output_data.pro.stopped가 true로 설정되고, 부분 동영상을 결과로 가진 채 완료됩니다.

continue_video_pro

멈추거나 실패하거나 완료된 동영상 생성 Pro 실행을 새 작업으로 이어 갑니다. from_segment 이전의 세그먼트는 재사용되고, 그 세그먼트부터 이후의 모든 세그먼트는 다시 생성됩니다. 실패한 실행에는 전달된 세그먼트가 하나 이상 있어야 합니다.

권한: workflows:execute. 크레딧: 다시 생성하는 세그먼트와 동영상 생성 Pro의 고정 요금만 듭니다.

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