Video Reframe (비디오 리프레임)
영상 종횡비를 변환합니다. 가로(16:9) → 세로(9:16) 변환 등에 사용합니다.
카테고리: 편집플랜: Studio+크레딧: 1
영상의 종횡비를 재구성합니다. 같은 영상을 인스타그램 릴스(9:16), 유튜브 썸네일(16:9), 정사각형 피드(1:1) 등 다양한 포맷으로 동시에 준비할 때 활용합니다.
포트 연결 슬롯
입력 포트
input_video (필수)video
원본 영상
출력 포트
videovideo
변환된 영상
option_json 파라미터
| 파라미터 | 타입 | 기본값 | 허용 형식 | 설명 |
|---|---|---|---|---|
| target_ratio (필수) | string | 없음 | "W:H" 형식 | 변환 목표 종횡비. 예: "9:16", "1:1", "4:3". 미지정 시 MISSING_INPUT 에러 |
| crop_mode | string | "crop" | "crop" 또는 "pad" | crop: 중앙 기준 잘라냄 / pad: 검정 레터박스로 여백 채움 |
inline 입력 필드
| 포트 | inline 키 | 설명 |
|---|---|---|
| input_video | source_url | 리프레임할 영상 URL |
crop vs pad 차이
| 모드 | 동작 | 내용 손실 | 권장 용도 |
|---|---|---|---|
| crop | 중앙 기준 여백 없이 꽉 채워 잘라냄 | 있음 (가장자리 잘림) | 인스타그램 릴스, 쇼츠처럼 화면 전체를 채워야 할 때 |
| pad | 원본을 그대로 유지하고 상하/좌우를 검정으로 채움 | 없음 | 내용이 잘리면 안 되는 영상, 레터박스 효과 원할 때 |
실사용 예시
- 예시 1 — 릴스 변환: 가로(16:9) 영상 → target_ratio: "9:16", crop_mode: "crop" → 세로 릴스/쇼츠용 영상 출력.
- 예시 2 — 정사각형 피드: 영상 → target_ratio: "1:1", crop_mode: "pad" → 레터박스 여백이 생기는 정사각형 영상 출력.
에러 코드
| 에러 코드 | 발생 조건 | 해결 방법 |
|---|---|---|
| MISSING_INPUT (port: input_video) | 영상 미연결 및 source_url 없음 | 리프레임할 영상을 연결하거나 Inspector에 URL을 입력하세요. |
| MISSING_INPUT (port: target_ratio) | target_ratio 미지정 | 목표 화면 비율(예: "9:16")을 Inspector에 입력하세요. |
| NODE_PLAN_RESTRICTED | Studio 플랜 미만에서 실행 시도 | 이 노드는 Studio 플랜 이상에서만 실행됩니다. 플랜 업그레이드 후 이용하세요. |
Tip
SNS 릴스·쇼츠용이라면 9:16 / crop 조합을 추천합니다. 중요한 피사체가 화면 중앙에 있어야 잘려나가지 않습니다.