마스크 합성

마스크 합성 노드는 마스크 동영상을 통해 전경 동영상을 배경 동영상 위에 겹칩니다. 마스크가 흰색인 곳에는 전경이, 검은색인 곳에는 배경이 보이고, 회색인 곳에서는 둘이 섞입니다. 마스크 합성은 AI 모델을 실행하지 않으므로 같은 입력에서는 항상 같은 결과가 나옵니다.

주로 함께 쓰는 노드는 동영상 마스크입니다. 동영상 마스크로 원본 영상에서 대상을 마스크한 다음, 그 영상을 전경으로, 다른 동영상을 배경으로 쓰세요. 그러면 대상이 새 장면에 나타납니다.

마스크 합성은 공급자 키가 필요 없으므로 키가 전혀 없는 Community Edition 설치를 포함해 모든 에디션에서 실행됩니다.

사용 시기

• 대상을 새 장면으로 옮길 때. 예를 들어 댄서를 해변으로 옮깁니다.
• 제품이나 진행자 뒤의 배경을 바꿀 때.
• 마스크 반전으로 대상을 뺀 나머지를 모두 남기고, 그 자리에 새 대상을 넣을 때.
• 다른 도구로 만든 흑백 매트를 통해 두 클립을 합칠 때.

빠른 시작

입력

배경은 배경 맞춤 설정에 따라 전경의 프레임에 맞춰지고, 전경보다 짧으면 반복됩니다. 마스크는 전경의 프레임에 맞게 늘어나고, 더 짧으면 마지막 프레임에서 멈춥니다. 거의 검은색은 완전한 배경으로, 거의 흰색은 완전한 전경으로 처리되므로 압축 노이즈 때문에 희미한 잔상이 남지 않습니다.

출력

결과에는 워터마크가 들어가지 않습니다.

설정

제한

• 길이: 전경은 최대 300초입니다.

Nodaro가 읽을 수 없는 전경이나 300초보다 긴 전경은 요금이 청구되기 전에 거부됩니다.

크레딧

마스크 합성은 결과가 시작된 5초마다 11크레딧입니다. 결과의 길이는 전경과 같습니다. 실행 한 번은 최소 5초 단위 하나로 계산됩니다. 3초 결과는 1단위, 10초 결과는 2단위, 61초 결과는 13단위입니다.

실행 전에 노드는 워크플로가 전경 길이를 알려 줄 때만 그 길이를 압니다. 그렇지 않으면 노드는 5초 단위 하나의 요금부터 300초 결과의 요금까지 범위를 보여 줍니다. 실제 실행에서는 요금이 청구되기 전에 전경을 측정하고, 실제 길이만큼 지불합니다.

팁

• 먼저 전경을 자르세요. 결과는 전경과 길이가 같으므로 동영상 자르기로 필요한 순간만 남기세요.
• 배경은 전경 이상의 길이로 쓰세요. 더 짧은 배경은 반복되므로 이어지는 부분이 눈에 띌 수 있습니다.
• 음수 값으로 테두리를 다듬으세요. 대상 주변에 원래 배경이 가는 선으로 보이면 확장/축소를 작은 음수 값으로 설정하세요.
• 가장자리 부드럽게를 조금 남기세요. 가장자리 부드럽게를 몇 픽셀로 두면 추적한 마스크의 가장자리에 생기는 계단 모양이 가려집니다.
• 어떤 매트든 쓸 수 있습니다. 렌더링한 도형 애니메이션처럼 다른 도구로 만든 흑백 또는 그레이스케일 동영상도 마스크로 쓸 수 있습니다.

문제 해결

대상 주변에 원래 배경의 가는 윤곽이 남습니다. 확장/축소를 작은 음수 값으로 설정하고 가장자리 부드럽게를 조금 남기세요.

대상이 있어야 할 곳에 배경이 보입니다. 마스크의 흑백이 반대입니다. 마스크 반전을 켜세요.

결과에 소리가 없습니다. 오디오에서 선택한 트랙이 그 동영상에 없습니다. 다른 동영상의 오디오나 둘 다 믹스를 선택하세요.

배경에 검은 띠가 생기거나 잘립니다. 배경 맞춤을 바꾸세요. 채우기(잘라서 채움)는 잘라 내고, 맞추기(레터박스)는 검은 띠를 더하며, 늘이기는 둘 다 없이 프레임을 채웁니다.

API에서 사용

POST /v1/mask-composite는 foregroundUrl, backgroundUrl, maskUrl과 선택 사항인 invertMask, feather(020), grow(-1010), backgroundFit(cover, contain, stretch 중 하나), audioSource(foreground, background, mix, none 중 하나)를 받습니다. 작업을 반환합니다. 완료된 작업의 출력에는 videoUrl, thumbnailUrl, width, height, durationSec가 담깁니다. 300초보다 긴 전경은 요금이 청구되기 전에 400 오류로 거부됩니다.

• SDK: maskComposite({ foregroundUrl, backgroundUrl, maskUrl, invertMask, feather, grow, backgroundFit, audioSource }). 미디어 및 업로드를 참고하세요.
• MCP: mask_composite 도구는 세 동영상을 각각 <name>_url 또는 <name>_asset_id(foreground, background, mask)로 받습니다. 그래서 video_mask 작업 ID를 mask_asset_id로 쓸 수 있습니다. 설정은 invert_mask, feather, grow, background_fit, audio_source입니다. MCP 도구 레퍼런스를 참고하세요.
• CLI: nodaro media mask-composite <foregroundUrl> <backgroundUrl> <maskUrl> [--invert] [--feather <px>] [--grow <px>] [--background-fit cover|contain|stretch] [--audio foreground|background|mix|none]. 미디어 및 보이스 명령을 참고하세요.

단일 노드 실행과 작업을 참고하세요.