동영상 URL

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

사용 시기

• YouTube 동영상 전체나 일부를 다시 편집하거나, 자막을 넣거나, 분석합니다.
• TikTok 동영상이나 Instagram 릴스를 리믹스합니다.
• 소셜 동영상을 모션 전이의 모션 레퍼런스로 사용합니다.
• 프레임 추출로 동영상에서 프레임을 가져옵니다.
• 음성 텍스트 변환이나 더빙으로 동영상의 소리를 텍스트로 옮기거나 더빙합니다.

빠른 시작

링크를 가져오는 방식

긴 YouTube 동영상의 일부 다운로드

시작과 끝에는 1:30, 1:02:03 같은 시간이나 초 단위 숫자를 입력할 수 있습니다. 기본 구간은 0:00부터 1:00까지입니다.

받은 클립에는 앞뒤로 몇 초가 더 들어갈 수 있습니다. 컷이 동영상의 키프레임을 따르기 때문입니다. 정확하게 잘라야 하면 그 뒤에 동영상 자르기 노드를 추가하세요.

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

동영상 분석과 AI 검수에 쓸 구간

동영상 분석과 AI 검수는 동영상을 최대 10분까지 읽습니다. 동영상 URL 노드가 둘 중 하나에 바로 연결되어 있으면, 구간 선택 화면에 이 제한과 함께 1:00 이하 구간이 가장 저렴하다는 안내가 표시됩니다.

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

워크플로를 실행할 때 일어나는 일

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

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

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

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

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

• 실행에서 아무 노드에도 연결되지 않은 동영상 URL 노드는 그대로 둡니다.
• 음성 텍스트 변환, Suno 커버, 더빙은 링크의 소리만 사용합니다. 이 노드들만 링크를 읽으면 실행은 동영상 다운로드를 기다리지 않습니다.

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

출력

출력 동영상은 다운로드한 파일이거나, 붙여넣은 직접 파일 링크입니다. 노드는 백그라운드에서 링크의 소리도 가져오며, Suno 커버와 음성 텍스트 변환이 연결되어 있으면 그 소리를 사용합니다.

다운로드 실패 시

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

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

크레딧과 저장 공간

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

앱 입력으로 사용

동영상 URL 노드를 게시한 앱의 입력으로 고를 수 있습니다. 그러면 앱 사용자는 파일을 업로드하는 대신 자기 동영상의 링크를 붙여 넣습니다.

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

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

팁

• 소리만 쓰세요. YouTube 동영상의 소리만 필요하면 대신 레퍼런스 오디오 노드를 사용하세요.
• 짧은 구간을 고르세요. 짧은 구간은 더 빨리 다운로드되고, 그 뒤의 모든 노드가 처리할 동영상도 줄어듭니다.
• 써도 되는 동영상만 쓰세요. 사용할 권리가 있는 동영상만 다운로드하세요.

API에서 사용

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

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

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

동영상을 먼저 직접 다운로드하려면 POST /v1/download-video로 가져오세요. 그런 다음 반환된 파일 URL을 동영상 업로드 노드나 이 노드의 동영상 URL 필드에 넣으세요. 직접 파일 링크는 다운로드 없이 그 필드를 그대로 통과합니다. 보이스 및 미디어를 참고하세요.