Reference Motion (레퍼런스 모션)

참조 영상의 모션 패턴으로 새 영상을 생성합니다. 시작 이미지·영상과 프롬프트는 모두 선택 입력입니다.

카테고리: 생성플랜: Growth+

참조 영상(reference_video)의 움직임 패턴으로 새로운 영상을 생성합니다. 시작 이미지(source_image)·소스 영상(source_video)·프롬프트는 모두 선택 입력입니다. 안무·동작·카메라 무브먼트를 재적용할 때 활용합니다.

포트 연결 슬롯

입력 포트

reference_video (필수)video

복제할 모션의 참조 영상 (필수)

prompt (선택)prompt_text

생성 방향·분위기 텍스트 (선택)

source_image (선택)image

모션 적용 시작 이미지 (선택)

출력 포트

videovideo

모션이 적용된 결과 영상

지원 파라미터

파라미터	타입	기본값	허용 범위	설명
duration	int	자동	5 또는 10	출력 영상 길이(초). 8초 기준으로 미만→5초, 이상→10초로 처리

Note

fps, seed, steps, cfg, intensity, aspect_ratio, resolution, motion_strength 파라미터는 fal API에 전달되지 않습니다. Inspector에 입력해도 무시되며 결과에 영향을 주지 않습니다.

파라미터	설명
video_upscale	생성 완료 후 NEXAGEN이 영상 화질을 업스케일 처리합니다 (선택)
auto_sound	생성 완료 후 NEXAGEN이 배경음을 자동 합성합니다 (선택)

포트	inline 키	설명
source_image	source_image_url, source_url	시작 이미지 URL (선택)
source_video	source_video_url, source_url	소스 영상 URL (선택, Inspector에서 별도 지원 시)
reference_video	reference_video_url	모션 스타일 참조 영상 URL

Note

– 표시 모델의 크레딧은 모델별로 상이합니다. Inspector 모델 선택 후 크레딧 예측으로 확인하세요.

예시 1 — 참조 모션만 사용: Reference Motion 노드에 reference_video 연결만으로 실행. 프롬프트·이미지 없이도 생성 가능합니다.
예시 2 — 시작 이미지 지정: Input Image 노드(시작 이미지) → rm_source_in 연결 / Input Video(참조 영상) → rm_ref_in 연결 → 실행.
예시 3 — 후처리 체인: Reference Motion → Auto Sound (배경음 합성) 순서로 연결.

에러 코드	발생 조건	해결 방법
MISSING_INPUT (port: reference_video)	reference_video 미연결 및 inline URL 없음	모션 스타일 참조 영상을 연결하세요. 반드시 영상 URL이어야 합니다.
MODEL_NOT_SUPPORTED	Reference Motion을 지원하지 않는 모델 선택	참조 모션을 지원하는 모델을 선택하세요. (위 모델 표 참고)
MODEL_NOT_REGISTERED	존재하지 않는 모델	다른 모델을 선택하세요.
INVALID_DURATION	모델 미지원 duration	모델이 지원하는 영상 길이를 선택하세요.
NODE_PLAN_RESTRICTED	Growth 플랜 미만에서 실행 시도	이 노드는 Growth 플랜 이상에서만 사용 가능합니다. 플랜 업그레이드 후 이용하세요.