# 동영상 URL

> YouTube, TikTok, Instagram, Facebook, X 링크를 붙여넣어 자르기, 자막, 분석, 리믹스에 쓸 동영상 파일로 만드세요. 긴 동영상은 일부만 고를 수 있습니다.

Source: https://nodaro.ai/ko/docs/nodes/automate/video-url

**동영상 URL** 노드는 소셜 동영상 링크를 워크플로에서 쓸 수 있는 동영상 파일로 바꿉니다. YouTube, TikTok, Instagram, Facebook 또는 X의 링크를 붙여넣으면 노드가 동영상을 내 라이브러리에 다운로드합니다. 연결한 모든 노드는 웹 페이지가 아니라 동영상 파일을 받으며, 다운로드에는 크레딧이 들지 않습니다.

- Found in: Automate › Get Content
- Output: video
- API type: `youtube-video`

## 사용 시기
- YouTube 동영상 전체나 일부를 다시 편집하거나, 자막을 넣거나, 분석합니다.
- TikTok 동영상이나 Instagram 릴스를 리믹스합니다.
- 소셜 동영상을 [모션 전이](https://nodaro.ai/docs/nodes/video/motion-transfer)의 모션 레퍼런스로 사용합니다.
- [프레임 추출](https://nodaro.ai/docs/nodes/image/extract-frame)로 동영상에서 프레임을 가져옵니다.
- [음성 텍스트 변환](https://nodaro.ai/docs/nodes/audio/transcribe)이나 [더빙](https://nodaro.ai/docs/nodes/audio/dubbing)으로 동영상의 소리를 텍스트로 옮기거나 더빙합니다.

## 빠른 시작
### 노드 추가
캔버스에서 Tab을 누르고 **자동화 › 콘텐츠 가져오기 › 동영상 URL**을 선택하세요. 이 노드는 **자주 사용** 탭과 **동영상** 탭에도 업로드 노드 옆에 있습니다.

### 링크 붙여넣기
링크를 노드에 붙여넣거나, 설정 패널의 **동영상 URL**에 붙여넣으세요. 다운로드가 자동으로 시작되고, 노드에 진행 상황이 표시됩니다.

### 긴 YouTube 동영상의 일부 선택
4분 이상인 YouTube 동영상이면 노드가 동영상의 길이를 보여 주고 어느 부분을 다운로드할지 묻습니다. **시작**과 **끝**을 설정하고 **이 부분 다운로드**를 클릭하거나, **동영상 전체 다운로드**를 클릭하세요. 노드가 [동영상 분석](https://nodaro.ai/docs/nodes/video/video-analysis)이나 [AI 검수](https://nodaro.ai/docs/nodes/video/ai-audit)로 이어지면, 구간을 얼마나 길게 잡을 수 있는지도 함께 보여 줍니다.

### 동영상 연결
**동영상** 출력을 [동영상 자르기](https://nodaro.ai/docs/nodes/video/trim-video)나 [자막 추가](https://nodaro.ai/docs/nodes/video/add-captions) 같은 다음 노드에 연결하세요.

Workflow: YouTube 동영상의 일부를 다운로드하고, 동영상 자르기로 정확하게 자른 다음 자막을 넣습니다.

- 동영상 URL → 동영상 자르기
- 동영상 자르기 → 자막 추가

## 링크를 가져오는 방식
| 링크 | 동작 |
| --- | --- |
| TikTok, Instagram, Facebook 또는 X | 링크를 붙여넣는 즉시 동영상 전체가 다운로드됩니다. |
| YouTube, 4분 미만 | 링크를 붙여넣는 즉시 동영상 전체가 최대 1080p로 다운로드됩니다. |
| YouTube, 4분 이상이거나 길이를 알 수 없음 | 노드가 길이를 보여 주고 **이 부분 다운로드**와 **동영상 전체 다운로드** 중 하나를 고르게 합니다. 고르기 전에는 아무것도 다운로드되지 않습니다. |
| YouTube 라이브 스트림 | 다운로드할 수 없습니다. 스트림이 끝난 뒤 다시 시도하세요. |
| 동영상 파일 직접 링크(`.mp4`, `.webm`, `.mov`, `.avi`) | 링크가 그대로 전달됩니다. 아무것도 다운로드되지 않습니다. |

## 긴 YouTube 동영상의 일부 다운로드
**시작**과 **끝**에는 `1:30`, `1:02:03` 같은 시간이나 초 단위 숫자를 입력할 수 있습니다. 기본 구간은 `0:00`부터 `1:00`까지입니다.

받은 클립에는 앞뒤로 몇 초가 더 들어갈 수 있습니다. 컷이 동영상의 키프레임을 따르기 때문입니다. 정확하게 잘라야 하면 그 뒤에 [동영상 자르기](https://nodaro.ai/docs/nodes/video/trim-video) 노드를 추가하세요.

다운로드가 끝난 뒤에는 설정 패널의 **다른 부분 다운로드**로 같은 링크의 다른 부분을 가져올 수 있습니다.

### 동영상 분석과 AI 검수에 쓸 구간
[동영상 분석](https://nodaro.ai/docs/nodes/video/video-analysis)과 [AI 검수](https://nodaro.ai/docs/nodes/video/ai-audit)는 동영상을 최대 10분까지 읽습니다. 동영상 URL 노드가 둘 중 하나에 바로 연결되어 있으면, 구간 선택 화면에 이 제한과 함께 1:00 이하 구간이 가장 저렴하다는 안내가 표시됩니다.

- **이 부분 다운로드**는 10:00보다 긴 구간을 받지 않습니다. 더 짧은 구간을 선택하세요.
- 10:00보다 긴 동영상이나 길이를 읽을 수 없는 동영상에는 **동영상 전체 다운로드**가 표시되지 않습니다.

## 워크플로를 실행할 때 일어나는 일
실행은 아직 다운로드되지 않은 링크를 쓰지 않습니다. 연결된 동영상 URL 노드에 파일이 없으면, 실행은 먼저 파일을 다운로드한 다음 시작합니다. 노드에 자체 진행 상황이 표시되며, 메시지의 **취소**는 기다리는 것만 멈추고 다운로드 자체는 계속됩니다.

다음 두 경우에는 실행이 노드 이름을 알려 주는 메시지와 함께 멈춥니다.

- 구간을 고르지 않은 긴 YouTube 동영상. 구간이나 동영상 전체를 고른 다음 다시 실행하세요.
- 실패한 다운로드. 메시지에 이유가 나옵니다.

구간을 골라야 할 때, 동영상의 길이를 알고 있으면 메시지에 그 길이가 표시됩니다. 노드가 동영상 분석이나 AI 검수로 이어지면, 1:00 이하 구간이 가장 저렴하다는 안내도 메시지에 나옵니다. 10:00보다 긴 동영상이면 “동영상 분석은 최대 10:00까지 읽습니다”처럼 제한을 알려 줍니다. 메시지에서 **표시**를 클릭하면 동영상 URL 노드가 선택되고 설정 패널이 열리며, 여기에서 구간을 고를 수 있습니다. 메시지는 20초 동안 화면에 남아 있습니다.

실행은 필요한 것만 가져옵니다.

- 실행에서 아무 노드에도 연결되지 않은 동영상 URL 노드는 그대로 둡니다.
- [음성 텍스트 변환](https://nodaro.ai/docs/nodes/audio/transcribe), [Suno 커버](https://nodaro.ai/docs/nodes/audio/suno-cover), [더빙](https://nodaro.ai/docs/nodes/audio/dubbing)은 링크의 소리만 사용합니다. 이 노드들만 링크를 읽으면 실행은 동영상 다운로드를 기다리지 않습니다.

워크플로를 열어도 다운로드는 시작되지 않습니다. 페이지를 닫을 때 다운로드 중이던 노드는, 그 다운로드가 아직 진행 중이면 같은 다운로드를 이어서 받습니다. 그렇지 않으면 노드에 다시 **동영상 다운로드**가 표시됩니다.

## 출력
출력 **동영상**은 다운로드한 파일이거나, 붙여넣은 직접 파일 링크입니다. 노드는 백그라운드에서 링크의 소리도 가져오며, [Suno 커버](https://nodaro.ai/docs/nodes/audio/suno-cover)와 [음성 텍스트 변환](https://nodaro.ai/docs/nodes/audio/transcribe)이 연결되어 있으면 그 소리를 사용합니다.

## 다운로드 실패 시
노드는 다음 메시지 중 하나를 표시합니다. 메시지에 마우스를 올리면 사이트가 보낸 원래 문구를 볼 수 있습니다.

| 메시지 | 의미 |
| --- | --- |
| 동영상을 소리 없이 받았습니다 | 사이트가 소리 없는 사본을 보냈습니다. 잠시 후 다시 시도하세요. 동영상에 정말 소리가 없다면 **소리 없이 다운로드**를 선택하세요. |
| 비공개 동영상입니다 | 소유자에게 공개로 전환해 달라고 요청하세요. |
| 연령 제한이 있는 동영상이라 다운로드할 수 없습니다 | 이 동영상은 받을 수 없습니다. |
| 다운로드하는 서버의 지역에서는 이 동영상을 이용할 수 없습니다 | 사이트가 위치에 따라 동영상을 차단합니다. |
| 다운로드 중에 연결이 끊어졌습니다 | 다시 시도하세요. 다운로드가 이미 끝났을 수 있으며, 다시 시도하면 그 결과를 가져옵니다. |
| 동시에 진행 중인 다운로드가 너무 많습니다 | 한 계정에서 동시에 4개까지 다운로드할 수 있습니다. 하나가 끝날 때까지 기다린 뒤 다시 시도하세요. |
| 이 동영상을 가져오지 못했습니다 | 링크가 브라우저의 시크릿 창에서 열리는지 확인하세요. |

원인을 해결한 뒤 **다운로드 다시 시도**를 클릭하세요.

## 크레딧과 저장 공간
동영상 URL 노드는 크레딧이 들지 않습니다. 다운로드한 파일은 내 저장 공간 사용량에 포함되므로, 더 이상 필요 없으면 라이브러리에서 삭제하세요.

## 앱 입력으로 사용
동영상 URL 노드를 게시한 [앱](https://nodaro.ai/docs/concepts/apps)의 입력으로 고를 수 있습니다. 그러면 앱 사용자는 파일을 업로드하는 대신 자기 동영상의 링크를 붙여 넣습니다.

앱 페이지에서 게시물 링크는 **실행** 전에 필드 안에서 다운로드되며, 규칙은 캔버스와 같습니다. 4분 이상이거나 길이를 알 수 없는 YouTube 동영상은 구간을 묻습니다. 그 밖의 웹 링크는 그대로 사용됩니다. 링크를 읽는 노드가 **음성 텍스트 변환**, **Suno 커버**, **더빙**, **콘텐츠 레시피**뿐이면 필드에서는 아무것도 다운로드되지 않습니다.

MCP, SDK, API에서도 앱 입력은 링크입니다. 서버는 첫 노드가 실행되기 전에 같은 규칙으로 게시물 링크를 다운로드합니다. 4분 이상인 YouTube 동영상은 지정한 구간만 다운로드되며, 자세한 내용은 다음 섹션에서 설명합니다.

## 팁
- **소리만 쓰세요.** YouTube 동영상의 소리만 필요하면 대신 [레퍼런스 오디오](https://nodaro.ai/docs/nodes/audio/reference-audio) 노드를 사용하세요.
- **짧은 구간을 고르세요.** 짧은 구간은 더 빨리 다운로드되고, 그 뒤의 모든 노드가 처리할 동영상도 줄어듭니다.
- **써도 되는 동영상만 쓰세요.** 사용할 권리가 있는 동영상만 다운로드하세요.

## API에서 사용
API나 AI 어시스턴트로 작성한 워크플로에는 링크만 들어 있습니다. API, MCP 또는 SDK에서 시작한 실행은 뒤의 노드에 파일이 필요하면 첫 노드가 실행되기 전에 게시물 링크를 다운로드합니다. 링크는 워크플로에 저장해 두거나 실행의 `inputOverrides`에서 지정할 수 있습니다. 규칙은 편집기와 같습니다.

- 4분 이상이거나 길이를 알 수 없는 YouTube 동영상은 구간만 다운로드됩니다. 구간은 노드나 `inputOverrides`의 `sectionStartSec`와 `sectionEndSec`에 초 단위로 지정하세요.
- 구간이 없으면 실행은 어떤 노드도 실행되기 전에, 아무것도 청구되기 전에 거부됩니다.

다운로드한 파일은 그 실행에 보관됩니다. 실행 뒤의 최종 렌더링은 같은 파일을 쓰며 다시 다운로드하지 않습니다. 실행을 반복하면 동영상을 다시 다운로드하며, 파일은 노드에 저장되지 않습니다.

동영상을 먼저 직접 다운로드하려면 `POST /v1/download-video`로 가져오세요. 그런 다음 반환된 파일 URL을 [동영상 업로드](https://nodaro.ai/docs/nodes/video/upload-video) 노드나 이 노드의 **동영상 URL** 필드에 넣으세요. 직접 파일 링크는 다운로드 없이 그 필드를 그대로 통과합니다. [보이스 및 미디어](https://nodaro.ai/docs/developers/api/voice-and-media)를 참고하세요.

## 자주 묻는 질문

### 동영상 URL 노드는 어떤 사이트를 지원하나요?

YouTube, TikTok, Instagram, Facebook, X를 지원합니다. .mp4, .webm, .mov, .avi로 끝나는 동영상 파일 직접 링크도 쓸 수 있으며, 이 링크는 다운로드 없이 그대로 전달됩니다.

### 동영상 URL 노드는 크레딧이 드나요?

아니요. 동영상 다운로드는 무료입니다. 다운로드한 파일은 저장 공간 사용량에 포함되므로, 더 이상 필요 없으면 라이브러리에서 삭제하세요.

### 긴 YouTube 동영상의 일부만 쓰려면 어떻게 하나요?

4분 이상인 YouTube 동영상이면 노드가 어느 부분을 다운로드할지 묻습니다. 예를 들어 “시작”을 1:30, “끝”을 2:30으로 설정하고 “이 부분 다운로드”를 클릭하세요. 클립 앞뒤로 몇 초가 더 들어갈 수 있으므로, 정확하게 자르려면 동영상 자르기 노드를 추가하세요.

### 동영상 다운로드가 실패한 이유는 무엇인가요?

노드에 이유가 표시됩니다. 가장 흔한 원인은 비공개 동영상이나 연령 제한 동영상, Nodaro가 다운로드하는 지역에서 차단된 동영상, 그리고 내 계정에서 동시에 4개를 넘는 다운로드가 진행 중인 경우입니다. 메시지에 마우스를 올리면 사이트가 보낸 원래 문구를 볼 수 있습니다.

### API에서 시작한 워크플로도 동영상 URL 링크를 다운로드할 수 있나요?

네. API, MCP 또는 SDK에서 시작한 실행은 뒤의 노드에 파일이 필요하면 첫 노드가 실행되기 전에 게시물 링크를 다운로드합니다. 4분 이상인 YouTube 동영상은 sectionStartSec와 sectionEndSec로 지정한 구간만 다운로드됩니다. 구간이 없으면 실행은 아무것도 청구되기 전에 거부됩니다.