대량 업로드 및 대규모 카탈로그 이전

2026년 7월 업데이트.

대규모 카탈로그를 이전하거나 업로드하려면 LabelGrid의 대량 도구를 사용하세요. 자동화된 맞춤형 워크플로에는 API 연동을, 업계 표준 피드와 배급사 규모의 이전에는 DDEX 임포트를 이용합니다. 두 방식 모두 API 접근이 활성화된 요금제에서 사용할 수 있습니다. 기존 ISRC와 UPC를 메타데이터가 일치하도록 재사용하면 스트림과 플레이리스트가 유지됩니다. 이 가이드에서는 두 방식과 배급사 규모의 카탈로그를 안전하게 옮기는 방법을 설명합니다.

규모에 상관없이 다른 배급사에서 단계별로 이전하는 방법은 카탈로그 이전을 참고하세요.

대량 업로드 방식

이용 가능한 옵션

방식	적합한 용도	필요 요금제
API 연동	자동화된 워크플로, 맞춤형 연동	API 접근이 활성화된 요금제
DDEX 임포트	업계 표준 피드, 메이저 레이블 워크플로	Enterprise / API 요금제(지원팀 문의)

API 연동

개요

LabelGrid API를 사용하면 릴리스를 프로그래밍 방식으로 생성하고 관리할 수 있어, 대규모 카탈로그를 위한 완전 자동화된 워크플로를 구성할 수 있습니다.

할 수 있는 일

릴리스를 프로그래밍 방식으로 생성
API로 오디오 파일 업로드
메타데이터 대량 관리
배급 워크플로 자동화
기존 시스템과 연동

시작하기

요금제에서 API 접근을 활성화 — 아직 활성화되어 있지 않다면 지원팀에 문의하세요
계정 설정에서 API 자격 증명 생성
엔드포인트 세부 정보는 API 문서 확인
연동 구현 또는 당사 SDK 사용
프로덕션 전에 스테이징 환경에서 테스트

예시 요청

POST /api/public/releases
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

{
  "title": "Album Title",
  "type": "album",
  "primary_artist": "Artist Name",
  "release_date": "2024-03-15",
  "tracks": [
    {
      "title": "Track One",
      "track_number": 1,
      "isrc": "USRC12400001"
    }
  ]
}

이전 배급사 기록하기

이미 다른 곳에서 라이브 중인 릴리스를 이전할 때, 공개 Releases API는 옮겨 오는 배급사를 기록할 선택적 transfer_from_distributor 필드(자유 입력, 최대 255자)를 지원합니다. 릴리스가 배급되면 읽기 전용으로 바뀌므로, 제출 전이나 제출 시점에 설정하세요.

API의 이점

완전 자동화 - 수동 개입 불필요
시스템 연동 - DAM, CRM 등 기존 도구와 연결
예약 릴리스 - 향후 배급을 위해 릴리스를 대기열에 추가
맞춤형 검증 - 제출 전 콘텐츠 사전 검증
웹훅 알림 - 전송 상태를 실시간으로 확인
오류 처리 - 프로그래밍 방식의 오류 감지 및 재시도

요청 한도(Rate Limit)

API에는 시스템 안정성을 위한 요청 한도가 있습니다. 현재 요청 한도 세부 정보는 API 개요를 참고하세요.

전체 문서는 API 개요를 참고하세요.

DDEX 임포트

개요

DDEX(Digital Data Exchange)는 메이저 레이블이 배급사에 콘텐츠를 전달할 때 사용하는 업계 표준 형식입니다. LabelGrid는 이미 DDEX 전송 인프라를 갖춘 엔터프라이즈 고객을 위해 DDEX 임포트를 지원합니다.

DDEX란?

DDEX는 다음을 패키징하는 XML 기반 표준입니다.

릴리스 메타데이터
트랙 정보
오디오 파일 참조
아트워크 및 에셋
거래 조건 및 지역

지원 형식

버전	상태
ERN 4.3.2	지원(권장)
ERN 4.3.1	지원
ERN 4.3.0	지원
ERN 3.8.2	지원(레거시)

DDEX 설정 절차

DDEX 활성화를 요청하려면 지원팀에 문의
당사 기술팀과 온보딩 완료
전송 설정 및 파일 경로 구성
안전한 파일 전송을 위한 SFTP 자격 증명 설정
검증을 위해 테스트 전송 제출
승인되면 프로덕션 전송 시작

전송 워크플로

내 시스템 → DDEX XML + 에셋 → SFTP 업로드 → LabelGrid 처리 → 배급

DDEX 요건

요건	세부 정보
요금제	API 접근 활성화(지원팀 문의)
형식	ERN 4.3.2 권장(4.3.1, 4.3.0, 3.8.2도 지원)
전송	SFTP만 지원
에셋	오디오 파일 포함 또는 참조
검증	사전 검증 권장

DDEX를 사용하는 경우

DDEX 임포트는 다음의 경우에 적합합니다.

이미 DDEX 전송 인프라를 갖추고 있는 경우
DDEX를 사용하는 다른 배급사에서 이전하는 경우
콘텐츠 관리 시스템이 DDEX를 기본으로 내보내는 경우
확립된 워크플로를 가진 메이저 레이블이나 대형 독립 사업자인 경우

API를 사용하는 경우

REST/JSON API는 다음의 경우에 더 적합합니다.

새 연동을 처음부터 구축하는 경우
XML보다 최신 웹 API를 선호하는 경우
실시간 양방향 통신이 필요한 경우
웹훅 기반 알림을 원하는 경우

방식 선택

항목	API 연동	DDEX 임포트
설정 복잡도	낮음	높음
기존 인프라	새로 구축	기존 DDEX 활용
형식	JSON	XML
전송 방식	HTTPS	SFTP
실시간 업데이트	예(웹훅)	폴링 필요
적합한 용도	신규 연동	엔터프라이즈 이전

처리 시간

API나 DDEX로 콘텐츠를 업로드한 뒤 처리 시간은 다음에 따라 달라집니다.

릴리스 및 트랙 수
오디오 파일 크기
메타데이터 복잡도
현재 시스템 부하

카탈로그가 클수록 처리에 자연히 더 오래 걸립니다. 특정 카탈로그 규모에 대한 예상 소요 시간 안내가 필요하면 지원팀에 문의하세요.

대규모 이전의 제출 한도

대규모 이전은 API와 DDEX 임포트도 함께 집계되는 롤링 제출 한도에 걸릴 수 있습니다. 작동 방식은 카탈로그 및 릴리스 한도를 참고하세요. 일회성 대규모 이전 전에는 지원팀에 문의해 임시 예외 기간을 설정하면, 이전 도중 한도에 걸리는 일을 피할 수 있습니다.

FAQ

”대규모 카탈로그를 LabelGrid로 어떻게 이전하나요?”

대량 업로드를 사용하세요. 자동화된 맞춤형 워크플로에는 API 연동을, 업계 표준 피드와 배급사 규모의 이전에는 DDEX 임포트를 이용합니다. 두 방식 모두 요금제에 API 접근이 활성화되어 있어야 합니다. 기존 ISRC와 UPC를 메타데이터가 정확히 일치하도록 그대로 재사용하면 DSP가 스트림, 저장, 플레이리스트를 유지하며, 이전 배급사에서 카탈로그를 내리기 전에 먼저 LabelGrid에 업로드하세요.

”LabelGrid가 DDEX로 제 카탈로그를 임포트할 수 있나요?”

네. LabelGrid는 기존 DDEX 전송 인프라를 갖춘 고객을 위해 SFTP를 통한 DDEX 임포트(ERN 4.3.2 권장, 4.3.1·4.3.0·3.8.2도 지원)를 지원합니다. 활성화하려면 지원팀에 문의하세요. LabelGrid는 DDEX 표준을 지원하지만 DDEX 컨소시엄 회원은 아닙니다.

”LabelGrid는 어떤 DDEX ERN 버전을 지원하나요?”

LabelGrid는 DDEX ERN 3.8.2, 4.3.0, 4.3.1, 4.3.2를 지원하며, 새 전송에는 4.3.2를 권장합니다. LabelGrid는 이 표준들을 지원하며 DDEX 컨소시엄 회원은 아닙니다.

”대규모 카탈로그를 이전할 때 스트림과 플레이리스트가 그대로 유지되나요?”

네, 동일한 ISRC와 UPC를 메타데이터가 정확히 일치하도록 재사용하면 유지됩니다. DSP는 ISRC와 UPC로 콘텐츠를 매칭하므로, 코드와 메타데이터가 같으면 기존 릴리스와 카탈로그를 병합해 스트리밍 기록, 저장, 플레이리스트 등재를 그대로 이어갈 수 있습니다.

”일회성 대규모 이전에는 제출 한도가 어떻게 적용되나요?”

대규모 이전은 API와 DDEX 임포트를 포함해 집계되는 롤링 제출 한도에 반영됩니다. 대규모 이전 전에 지원팀에 문의해 임시 예외 기간을 설정하면 이전 도중 한도에 걸리지 않습니다.

도움이 필요하신가요?

대량 업로드 설정 지원:

API 연동: API 개요를 참고하거나 지원팀에 문의하세요
DDEX 활성화: 요건을 담아 지원팀에 문의하세요

당사 팀이 적합한 방식을 고르고 설정을 안내해 드립니다.

아직 LabelGrid를 사용하지 않으세요?

방금 읽으신 내용은 모두 저희 플랫폼에서 이용하실 수 있어요.

LabelGrid로 할 수 있는 일 보기 →