대량 업로드 가이드

카탈로그가 큰 레이블에는 대량 업로드 도구가 상당한 시간을 절약해 줍니다. LabelGrid는 여러 음원을 한 번에 업로드하는 두 가지 방법, 즉 API 연동과 DDEX 가져오기를 지원합니다.

대량 업로드 방법

이용 가능한 옵션

방법	적합한 경우	필요한 요금제
API 연동	자동화 워크플로, 맞춤형 연동	API 접근이 활성화된 요금제
DDEX 가져오기	업계 표준 피드, 메이저 레이블 워크플로	Enterprise / API 요금제(지원팀 문의)

참고

대량 업로드 방법은 API 접근이 활성화된 요금제에서 이용할 수 있습니다. 요금제에 API 접근이 포함되어 있지 않다면, LabelGrid 대시보드에서 음원을 개별로 만들거나 지원팀에 문의해 API 접근 활성화를 상의하세요.

---

API 연동

개요

LabelGrid API를 사용하면 프로그램으로 음원을 생성하고 관리할 수 있어, 큰 카탈로그를 위한 완전 자동화 워크플로를 구축할 수 있습니다.

할 수 있는 일

• 프로그램으로 음원 생성
• API로 오디오 파일 업로드
• 메타데이터 일괄 관리
• 배급 워크플로 자동화
• 기존 시스템과 연동

시작하기

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

요청 예시

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 등 다른 도구와 연결
• 예약 발매 - 향후 배급을 위해 음원 대기열에 등록
• 맞춤 검증 - 제출 전 콘텐츠 사전 검증
• 웹훅 알림 - 전송 상태 실시간 업데이트 수신
• 오류 처리 - 프로그램으로 오류 감지 및 재시도

요청 한도

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 설정 과정

1. DDEX 활성화를 요청하려면 지원팀에 문의합니다
2. 저희 기술팀과 함께 온보딩을 완료합니다
3. 전송 설정과 파일 경로를 구성합니다
4. 안전한 파일 전송을 위해 SFTP 자격 증명을 설정합니다
5. 검증을 위해 테스트 전송을 제출합니다
6. 승인되면 프로덕션 전송을 시작합니다

전송 워크플로

Your System → DDEX XML + Assets → SFTP Upload → LabelGrid Processing → Distribution

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로 콘텐츠를 업로드하면, 처리 시간은 다음에 따라 달라집니다.

• 음원과 트랙 수
• 오디오 파일 크기
• 메타데이터 복잡도
• 현재 시스템 부하

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

---

대규모 이관 시 제출 한도

계정에 7일 단위의 롤링 음원 제출 한도가 적용될 수 있습니다. 이 한도가 활성화되어 있으면, 계정에서 이뤄지는 모든 음원 제출(API와 DDEX 가져오기로 제출한 음원 포함)이 집계되며, 음원을 재제출하는 것도 한도에 포함됩니다.

대규모 일회성 카탈로그 이관을 계획 중이고 한 주에 20건이 넘는 음원을 제출할 것으로 예상된다면, 이를 안내가 필요한 작업으로 보고 먼저 지원팀에 문의해 함께 계획을 세우세요. 지원팀이 이관을 위한 임시 한도 면제 기간을 마련해 드릴 수 있으니, 업로드를 시작했다가 도중에 한도에 막히기 전에 미리 연락하세요.

모든 트랙이 들어왔는지 확인하세요

대량 또는 DDEX 가져오기 후에는 배급하기 전에 모든 트랙이 올바르게 들어왔는지 확인하세요.

---

관련 문서

큰 카탈로그를 관리하고 계신가요? LabelGrid가 규모에 맞춰 음원을 어떻게 정리해 두는지는 저희 웹사이트의 카탈로그 관리에서 확인하세요.

---

도움이 필요하신가요?

대량 업로드 설정에 도움이 필요하면:

• API 연동: API 개요를 참고하거나 지원팀에 문의하세요
• DDEX 활성화: 요건과 함께 지원팀에 문의하세요

저희 팀이 알맞은 방법을 고르고 설정 과정을 안내해 드리겠습니다.