Overlay Composite (오버레이 합성)

베이스 영상 위에 이미지나 영상을 오버레이 합성합니다.

카테고리: 편집플랜: Studio+크레딧: 1

베이스 영상 위에 이미지나 다른 영상을 합성합니다. 워터마크, 로고 삽입, PIP(Picture-in-Picture), 자막 배경 등 다양한 합성 작업에 활용합니다.

포트 연결 슬롯

입력 포트

base_video (필수)video

배경이 되는 원본 영상

overlay_media (필수)any

오버레이할 이미지 또는 영상

출력 포트

videovideo

합성된 최종 영상

option_json 파라미터

파라미터	타입	기본값	허용 범위	설명
opacity	float	1.0	0.0 ~ 1.0	오버레이 불투명도. 0=완전 투명, 1=완전 불투명
x	int 또는 string	"center"	정수(px) 또는 "center"	오버레이 X 위치 (좌측 기준). "center" 입력 시 수평 중앙 정렬
y	int 또는 string	"center"	정수(px) 또는 "center"	오버레이 Y 위치 (상단 기준). "center" 입력 시 수직 중앙 정렬
scale	float	1.0	0.0 초과	오버레이 크기 배율. 1.0=원본 크기, 0.5=절반, 2.0=두 배

포트	inline 키	설명
base_video	base_url, source_url	배경 영상 URL
overlay_media	overlay_url	오버레이할 이미지 또는 영상 URL

예시 1 — 로고 워터마크: Reference Media 노드에 로고 PNG URL 입력 → overlay_media 연결 / opacity: 0.7, x: 20, y: 20, scale: 0.3 → 좌상단 로고 표시.
예시 2 — PIP(Picture-in-Picture): Input Video 노드 두 개 → 하나는 base_video, 다른 하나는 overlay_media 연결 / x: "center", y: "center", scale: 0.4 → 영상 중앙에 작은 영상 표시.

에러 코드	발생 조건	해결 방법
MISSING_INPUT (port: base_video)	base_video 미연결 및 base_url/source_url 없음	배경 영상(base_video)을 연결하거나 Inspector에 URL을 입력하세요.
MISSING_INPUT (port: overlay_media)	overlay_media 미연결 및 overlay_url 없음	오버레이할 이미지 또는 영상을 연결하거나 Inspector에 URL을 입력하세요.
NODE_PLAN_RESTRICTED	Studio 플랜 미만에서 실행 시도	이 노드는 Studio 플랜 이상에서만 실행됩니다. 플랜 업그레이드 후 이용하세요.

Note

overlay_media 포트는 이미지와 영상 모두 연결할 수 있습니다. Reference Media 노드를 사용하면 URL 확장자에 따라 자동으로 타입이 판별됩니다.