콘텐츠 가져오기

동영상 가져오기

TubePress로 콘텐츠를 가져오는 다양한 방법과 가져오기 대기열의 작동 방식을 설명합니다.

TubePress는 라이브러리를 여러 방식으로 채울 수 있습니다 — 단일 클립을 직접 추가하는 것부터 클라우드에서 수십만 개의 완성된 동영상을 불러오는 것까지 다양합니다. 이 페이지에서는 내장 가져오기 도구를 소개하고 각 경로가 어디에 있는지 안내합니다.

어떤 방법을 선택하든 결과는 동일합니다: 다른 동영상과 마찬가지로 편집, 정리, 검토 및 게시할 수 있는 일반 동영상입니다. 보유한 콘텐츠의 양과 한 번만 불러올 것인지, 계속해서 자동으로 추가될 것인지에 따라 적합한 방법을 선택하세요.

TubePress에 콘텐츠를 가져오는 방법

동영상을 추가하는 단 하나의 "정답" 방법은 없습니다 — 각 방법은 서로 다른 규모와 워크플로에 적합합니다. 아래 표를 사용하여 선택하고, 세부 내용을 보려면 링크를 따라가세요.

방법	적합한 경우	제공하는 것	반복 여부?	크레딧?
수동 업로드	자체 호스팅된 단일 클립	동영상 파일	아니오	아니오
단일 URL 가져오기	임베드된 동영상 하나	임베드 코드 또는 동영상 URL	아니오	아니오
일괄 가져오기	한 번에 여러 동영상	CSV 또는 JSON 파일	아니오 (대기 중)	AI 사용 시에만
피드 가져오기	자동으로 지속적인 성장	피드 URL	예	AI 사용 시에만
카탈로그	완성된 라이브러리	400,000개 이상의 동영상 중 선택	아니오	예

경험칙. 동영상 몇 개 → 직접 추가. 동영상 스프레드시트 → 일괄 가져오기. 계속 게시되는 소스 → 피드. 소싱 없이 품질 콘텐츠 원함 → 카탈로그.

TubePress에는 별도의 "동영상 하나" 가져오기 도구가 없습니다 — 단일 동영상을 추가하려면 동영상 화면(/admin/videos)에서 동영상 추가를 선택하세요. 미디어를 제공하는 두 가지 방법이 있습니다:

수동 업로드 — 직접 호스팅하는 동영상 파일을 업로드합니다.
단일 URL 가져오기 — 다른 곳에 호스팅된 클립을 임베드하려면 <iframe> 임베드 코드 또는 직접 동영상 URL을 붙여넣으세요.

제목과 썸네일을 입력하고, 카테고리, 태그 또는 출연자를 첨부한 후 초안으로 저장하거나 바로 게시하세요. 두 방법 모두 크레딧을 사용하지 않습니다.

몇 개 이상인가요? 하나씩 추가하는 방식을 건너뛰고 일괄 가져오기를 위한 CSV 또는 JSON 파일을 준비하거나 카탈로그를 찾아보세요.

일괄 가져오기는 /admin/import의 파일 업로드 탭에 있습니다. 단일 CSV 또는 JSON 파일을 받아 — URL 목록을 붙여넣는 방식이 아닙니다 — 각 행 또는 객체를 동영상으로 변환합니다.

파일을 업로드 영역에 드래그하거나 (클릭하여 탐색) TubePress가 열을 읽고 미리보기를 표시합니다. 최소한의 CSV는 다음과 같습니다:

title,embed_code,thumbnail,duration,tags
My clip,https://ex.com/v/123.mp4,https://ex.com/t.jpg,612,"solo,hd"

다음으로 열을 드래그하여 TubePress 필드에 매핑합니다. 가져오기 도구가 인식하는 필드는 다음과 같습니다:

title

동영상 제목. 가져오기 도구가 실제로 필요로 하는 유일한 필드입니다.

embed_code

<iframe> 임베드 코드 또는 동영상 URL.

thumbnail

이미지 URL. 선택적으로 자체 스토리지에 다운로드할 수 있습니다.

video_id

재가져오기 시 중복 제거에 사용되는 안정적인 외부 ID.

categories / tags / performers / channels

쉼표로 구분된 이름; 없으면 생성됩니다.

description, slug, duration, views, published_at

동일한 방식으로 매핑되는 선택적 추가 항목.

시작하기 전에 중복 처리 방법(건너뛰기 또는 업데이트, video_id로 일치), 자체 스토리지에서 제공되도록 썸네일 다운로드 여부, 그리고 선택적 AI 재작성 또는 번역을 설정하세요.

일괄 가져오기는 임베드만 합니다, 호스팅하지 않습니다. 각 행은 임베드 또는 플레이어 링크를 저장합니다; 동영상 파일은 가져오거나 트랜스코딩되지 않습니다. 실제 파일을 자체 호스팅하려면 다운로드 모드의 피드 가져오기 또는 카탈로그를 사용하세요.

작은 파일을 초과하는 경우 백그라운드에서 시작을 선택하세요. TubePress는 작업을 생성하고 가져오기 프로세서에 전달하며, 탭을 닫은 후에도 행을 처리합니다. 시스템 crontab이 필요하지 않습니다 — 내장 pseudo-cron에서 실행됩니다.

프로세서는 안전하고 탄력적으로 설계되었습니다:

이중 집계 없음. 작업별 잠금으로 동일한 행이 두 번 처리되는 것을 방지하므로, 페이지가 열려 있고 cron이 함께 실행되더라도 카운트가 정확합니다.

/admin/import을 열고 가져오기 대기열을 확인하세요. 각 활성 작업은 실시간 카운트를 표시합니다 — 가져온 수, 건너뛴 수, 오류 수, 전체 대비 처리된 수 — 몇 초마다 새로 고침됩니다.

여기에서 작업을 일시 중지, 재개, 취소 또는 삭제할 수 있습니다. 지난 24시간의 작업은 목록에 남아 있어 실패한 행에 대한 샘플 오류 메시지를 포함하여 무슨 일이 있었는지 검토할 수 있습니다.

.csv 및 .json 파일만 허용됩니다; 다른 형식은 처음부터 거부됩니다.
행당 실질적인 최소값은 제목, 임베드 코드, 썸네일입니다.
업로드 크기는 서버의 upload_max_filesize 및 post_max_size에 의해 제한됩니다. 매우 큰 파일은 분할하거나 백그라운드 작업을 사용하세요.
안정적인 video_id를 매핑하면 파일을 다시 실행할 때 중복이 아닌 업데이트가 됩니다.
썸네일 다운로드를 활성화하면 소스를 핫링크하는 대신 이미지를 자체 호스팅합니다.
AI 재작성 및 번역은 크레딧을 소모하며 연결된 tubepress.io 계정이 필요합니다; 잔액이 너무 낮으면 명확한 메시지와 함께 작업이 중지됩니다.

여전히 막히셨나요?

대시보드에서 티켓을 열면 저희 팀이 도와드리겠습니다.