샷 컷

샷 컷 노드는 동영상의 모든 샷이 어디서 시작하고 끝나는지 찾습니다. 각 샷을 시작, 끝, 길이와 함께 목록으로 만듭니다. 첫 프레임과 마지막 프레임 저장을 켜면 각 샷의 첫 프레임과 마지막 프레임도 이미지로 받습니다.

노드는 파일 자체를 측정합니다. 디코딩한 모든 프레임을 바로 앞 프레임과 비교하며, 잔잔한 배경에서 크게 바뀐 프레임이 새 샷을 시작합니다. 이는 동영상 마스크가 동영상을 샷 단위로 마스킹할 때 쓰는 것과 같은 규칙입니다.

노드는 AI 모델이나 공급자 키 없이 로컬에서 실행되므로 모든 에디션에서 동작합니다.

사용 시기

• 광고, 예고편, 뮤직비디오 같은 편집의 샷 리스트를 얻어 샷 단위로 다시 만들거나 스타일을 바꿀 때.
• 모든 샷의 정지 이미지를 저장해 이미지 모델이나 동영상 모델의 레퍼런스 이미지로 쓸 때.
• 모든 샷의 길이를 한눈에 보며 편집의 템포를 잴 때.
• 구간 분할 전에 컷 지점을 찾을 때. 그 노드의 샷 모드는 같은 지점에서 동영상을 자릅니다.

빠른 시작

입력

출력

샷 출력은 다음과 같습니다.

{
  "shotCount": 3,
  "cutsSec": [2.5, 6.042],
  "durationSec": 9,
  "shots": [
    { "index": 0, "startSec": 0, "endSec": 2.5, "durationSec": 2.5, "firstFrameUrl": "https://…", "lastFrameUrl": "https://…" },
    { "index": 1, "startSec": 2.5, "endSec": 6.042, "durationSec": 3.542, "firstFrameUrl": "https://…", "lastFrameUrl": "https://…" },
    { "index": 2, "startSec": 6.042, "endSec": 9, "durationSec": 2.958, "firstFrameUrl": "https://…", "lastFrameUrl": "https://…" }
  ]
}

설정

컷으로 세는 것

• 하드 컷은 새 샷을 시작합니다. 한 프레임이 앞뒤 프레임과 크게 다를 때입니다.
• 점진적 전환은 컷이 아닙니다. 디졸브나 검은 화면으로의 페이드는 변화를 여러 프레임에 나누므로 앞뒤의 샷이 하나로 세어집니다.
• 플래시. 두세 프레임 동안 이어진 뒤 같은 화면으로 돌아오는 플래시는 컷이 아닙니다. 한 프레임짜리 플래시는 컷입니다.
• 컷을 놓칠 수 있습니다. 휩 팬처럼 컷 직후 세 프레임 안에 두 번째 큰 변화가 이어질 때입니다.

크레딧

샷 컷은 프레임 저장 여부나 동영상 길이와 관계없이 실행당 고정 가격 하나입니다. 노드의 실행 버튼에 가격이 표시됩니다. 셀프 호스팅 Community Edition과 Business 에디션은 크레딧을 쓰지 않습니다.

다음 실행은 실패하며 크레딧이 환불됩니다.

• 읽을 수 있는 동영상이 아닌 파일.
• 약 10.7 GiB를 넘는 파일. 다운로드가 그 지점에서 멈춥니다.
• 30분보다 긴 동영상. 먼저 잘라 내세요.
• 프레임 저장을 켰을 때, 샷이 1,000개를 넘는 동영상. 시간만 얻으려면 프레임 저장을 끄거나 동영상을 잘라 내세요.

팁

• 샷 하나의 시간을 읽으세요. 샷 출력을 필드를 shots로, 출력 유형을 목록으로 설정한 필드 추출이나 목록 노드에 연결하세요. 목록과 일괄 처리를 참고하세요.
• 동영상을 샷 단위로 다시 만드세요. 프레임 저장을 켜고, 각 샷의 첫 프레임을 새 클립의 시작 프레임으로 쓰세요.
• 샷마다 클립 하나로 자르세요. 샷 모드의 구간 분할을 쓰세요.
• 프레임은 정확합니다. 디코딩한 프레임 그대로 손실 없이 저장되며, 크기는 동영상 화면과 같습니다.

문제 해결

API에서 사용

POST /v1/shot-cuts에 { videoUrl, frames? }를 보내면 작업이 대기열에 들어가고 그 jobId로 응답합니다. 형식이 잘못된 요청은 크레딧이 예약되기 전에 400 validation_error로 응답합니다. 완료된 작업의 output_data.json은 위의 샷 결과입니다. 프레임 저장을 켜면 output_data.firstFrames와 output_data.lastFrames가 프레임 이미지를 샷 순서대로 나열합니다.

SDK 메서드는 client.media.shotCuts이고, MCP 도구는 shot_cuts입니다. 단일 노드 실행, SDK의 미디어 및 업로드, MCP 도구 레퍼런스를 참조하세요.