Reference Media (레퍼런스 미디어)
이미지 또는 영상을 레퍼런스로 공급하는 소스 노드입니다.
카테고리: 소스플랜: Starter+크레딧: 0
이미지 또는 영상 URL을 입력해 다양한 생성·편집 노드의 레퍼런스 소스로 공급합니다. URL의 확장자를 자동으로 판별하여 타입을 설정합니다.
포트 연결 슬롯
입력 포트
없음
출력 포트
mediaany
이미지 또는 영상 — 연결 노드가 자동 타입 판별
미디어 타입 자동 판별
| URL 확장자 | 자동 분류 |
|---|---|
| mp4, mov, webm, avi | video 타입으로 처리 |
| 그 외 (jpg, png, webp 등) | image 타입으로 처리 |
연결 가능한 하위 노드
| 대상 노드 | 연결 포트 | 역할 |
|---|---|---|
| Overlay Composite | overlay_media | 오버레이 자산 (이미지·영상 모두 가능) |
| Reference Motion | reference_video | 참조 영상 (모션 복제 소스) |
| Video Generate (I2V) | input_image | 시작 프레임 이미지 |
| Start/End Frame | start_image 또는 end_image | 시작·종료 프레임 이미지 |
- 노드 Inspector에서 미디어 URL 필드를 클릭합니다.
- 이미지 또는 영상 URL을 붙여넣습니다.
- URL 확장자에 따라 타입이 자동 설정됩니다.
- 원하는 하위 노드 포트로 연결선을 드래그합니다.
inline 입력 필드
| 필드명 | 우선순위 | 용도 |
|---|---|---|
| media_url | 1순위 (권장) | 이미지 또는 영상 URL |
| image_url | 2순위 | 이미지 전용 |
| video_url | 3순위 | 영상 전용 |
| source_url | 4순위 (fallback) | 레거시 호환 |
에러 코드
| 에러 코드 | 발생 조건 | 해결 방법 |
|---|---|---|
| MISSING_INPUT (port: media_url) | media_url, image_url, video_url, source_url 모두 비어있음 | Inspector에서 미디어 URL을 입력하거나 edge를 연결하세요. |
Note
이 노드는 항상 0 크레딧입니다. 크레딧은 연결된 하위 노드에서 소비됩니다.Warning
Reference Motion 노드의 reference_video 포트에는 반드시 영상 URL을 사용하세요. 이미지 URL을 연결하면 실행 시 오류가 발생합니다.