비디오 렌더링 (RenderVideo)
ffmpeg를 사용하여 오디오, 이미지, 자막 등을 조합해 비디오를 합성하는 노드입니다. JSON 기반의 렌더링 설정을 통해 다양한 미디어 요소를 하나의 비디오로 만들 수 있습니다.
주요 기능
오디오, 이미지, 자막(SRT/텍스트)을 조합한 비디오 렌더링
이미지 슬라이드쇼 트랜지션 효과 지원
인라인 자막 자동 생성 (단어/글자 수 기준 분할)
자막 스타일 커스터마이징 (폰트, 색상, 외곽선, 정렬 등)
Composition(중첩 구조) 지원
설정 항목
항목 | 타입 | 기본값 | 설명 |
|---|---|---|---|
Output Filename | string | 자동 생성 | 출력 비디오 파일 이름 (비워두면 랜덤 이름 자동 생성) |
Binary Property Name | string |
| 바이너리 데이터를 저장할 속성 이름 |
입력 데이터 구조
입력 아이템의 json 데이터가 자동으로 elements 배열로 합쳐집니다. 각 요소는 다음 타입 중 하나입니다.
audio (오디오)
필드 | 타입 | 기본값 | 설명 |
|---|---|---|---|
type | string | - |
|
source | string | - | 오디오 파일 URL (필수) |
track | number |
| 트랙 번호 |
time | number |
| 시작 시간 (초) |
duration | number/null/ |
| 재생 길이 |
loop | boolean |
| 반복 재생 |
volume | string |
| 볼륨 |
image (이미지)
필드 | 타입 | 기본값 | 설명 |
|---|---|---|---|
type | string | - |
|
source | string | - | 이미지 URL (필수) |
track | number |
| 트랙 번호 |
time | number |
| 시작 시간 (초) |
duration | number/ |
| 표시 길이 (초) |
animations | array |
| 트랜지션 애니메이션 |
srt (SRT 자막 파일)
필드 | 타입 | 기본값 | 설명 |
|---|---|---|---|
type | string | - |
|
source | string | - | SRT 파일 URL (필수) |
track | number |
| 트랙 번호 |
subtitle (인라인 자막)
필드 | 타입 | 기본값 | 설명 |
|---|---|---|---|
type | string | - |
|
text | string | - | 자막 텍스트 (필수) |
wordsPerSubtitle | number |
| 자막당 단어 수 |
timingMode | string |
| 타이밍 계산 방식 ( |
fontSize | number |
| 폰트 크기 |
fontName | string |
| 폰트 이름 |
fontColor | string |
| 폰트 색상 (16진수 RGB) |
outlineColor | string |
| 외곽선 색상 |
backgroundColor | string |
| 배경 색상 (16진수 ARGB) |
backgroundType | string |
| 배경 유형 ( |
outline | number |
| 외곽선 두께 |
alignment | number |
| 정렬 (1-9, 기본: 하단 중앙) |
marginV | number |
| 수직 여백 (px) |
composition (중첩 구조)
필드 | 타입 | 설명 |
|---|---|---|
type | string |
|
elements | array | 하위 요소 배열 (audio, image, srt, subtitle) |
track | number | 트랙 번호 |
time | number | 시작 시간 (초) |
duration | number | 재생 길이 (초) |
인증 정보
별도의 외부 API 인증이 필요하지 않습니다. 서버에 ffmpeg가 설치되어 있어야 합니다.
사용 예시
이미지 슬라이드쇼 비디오 만들기
이전 노드에서 여러 이미지 URL을 각각의 아이템으로 출력합니다.
각 아이템의 JSON을
{ "type": "image", "source": "이미지URL", "duration": 5 }형태로 설정합니다.배경 음악을 추가하려면
{ "type": "audio", "source": "오디오URL", "loop": true }아이템도 함께 전달합니다.RenderVideo 노드가 모든 아이템을 합쳐 하나의 비디오를 생성합니다.
자막이 포함된 비디오 생성
오디오/이미지 요소와 함께
subtitle타입 요소를 전달합니다.wordsPerSubtitle로 자막 분할 단위를 조정할 수 있습니다.한국어 콘텐츠의 경우
timingMode를'characters'로 설정하면 글자 수 기준으로 타이밍이 계산됩니다.
참고 사항
입력 아이템의
json데이터가 자동으로 elements 배열로 합쳐지므로, 별도의 JSON 설정 없이 이전 노드에서 각 요소를 개별 아이템으로 전달하면 됩니다.세그먼트 기반 렌더링을 사용하여 대용량 비디오도 안정적으로 처리합니다.
인증 정보 설정에 대한 자세한 내용은 RenderVideo 인증 설정 가이드를 참고하세요.
렌더링 결과는 바이너리 데이터로 출력되며, 후속 노드(AWS S3 등)에서 업로드할 수 있습니다.