AI로 음악 분류하기

빠른 시작

앱에서 만든 파일과 이 가이드 링크를 ChatGPT, Claude 같은 외부 AI에 함께 전달합니다.

YouTube는 이 단계에서 변경되지 않습니다.AI 분류는 내부 속성 후보를 저장할 뿐입니다. 실제 재생목록 변경은 규칙 계산, 미리보기, 사용자 승인, 적용 단계를 거칩니다.

요청 JSON

앱의 exporter가 생성하는 형식입니다. 사용자는 이 구조를 직접 편집할 필요가 없습니다.

값을 결정하는 기준instructions.allowedAttributes는 AI가 사용할 수 있는 속성 키를 제한하고, instructions.userClassificationCriteria는 문자열 속성에 어떤 값을 사용할지 정하는 사용자 기준입니다. AI는 두 값을 가장 먼저 확인하고 사용자 기준을 최우선으로 적용해야 합니다.

{
  "format": "youtube-music-organizer-classification-request",
  "schemaVersion": 1,
  "createdAtMillis": 1799708400000,
  "instructions": {
    "task": "Classify each track only when evidence is sufficient. Use UNKNOWN by omitting uncertain attributes.",
    "allowedAttributes": [
      "contentType",
      "longForm",
      "mood",
      "scene",
      "source",
      "style",
      "vcScope",
      "voice",
      "voicebank"
    ],
    "requiredOutputFormat": "youtube-music-organizer-classification-pack",
    "requiredSchemaVersion": 1,
    "confidenceRange": "0.0..1.0",
    "minimumAcceptedConfidence": 0.9,
    "doNotInventYoutubeIds": true,
    "userClassificationCriteria": "동인 음악은 확인 가능한 서클·앨범·원작 근거가 있을 때만 scene=doujin으로 분류",
    "outputExample": {
      "format": "youtube-music-organizer-classification-pack",
      "schemaVersion": 1,
      "packVersion": "user-1",
      "classifications": [
        {
          "youtubeId": "copy from tracks",
          "attributes": {
            "scene": "doujin",
            "source": "touhou"
          },
          "confidence": 0.95,
          "evidence": [
            "short evidence"
          ]
        }
      ]
    }
  },
  "tracks": [
    {
      "youtubeId": "fake-uni-song",
      "title": "Into the UNIverse",
      "artistChannel": "Sample Producer",
      "durationSeconds": 226,
      "currentPlaylists": [
        "UNI"
      ],
      "note": "동인음악인지 확인"
    }
  ]
}

요청 최상위 키

instructions 하위 키

tracks[] 키

결과 JSON

앱의 importer가 읽는 전체 형식입니다. 실제 파일에는 JSON 앞뒤의 설명이나 Markdown 코드 펜스를 넣지 마세요.

{
  "format": "youtube-music-organizer-classification-pack",
  "schemaVersion": 1,
  "packVersion": "docs-example-1",
  "classifications": [
    {
      "youtubeId": "fake-uni-song",
      "attributes": {
        "voice": "vocal_synth",
        "voicebank": "UNI",
        "scene": "doujin",
        "style": "electronic",
        "source": "original",
        "mood": "bright",
        "contentType": "song",
        "vcScope": true,
        "longForm": false
      },
      "confidence": 0.95,
      "evidence": [
        "사용자 메모와 곡 메타데이터를 함께 확인"
      ]
    }
  ]
}

결과 최상위 키

classifications[] 키

packVersion은 결과 작성자가 만듭니다.같은 결과 묶음에는 하나의 안정적인 값을 사용하세요. 날짜와 순번을 조합한 personal-2026-09-14-1 같은 값이 권장됩니다. 현재 schema v1에서는 필수이며 앱이 대신 채우지 않습니다.

속성/허용 값

현재 validator는 아래 9개 키만 허용합니다. 문자열 속성은 고정 enum이 아니며 사용자의 분류 기준을 따르는 200자 이하 값입니다. 근거가 부족하면 UNKNOWN을 쓰지 말고 해당 키를 생략하세요.

예시 값은 고정 enum이 아닙니다. 문자열 값은 요청 파일의 userClassificationCriteria를 우선해 정하고, 비어 있지 않은 경우에만 저장합니다. 공식 결과 파일에서 vcScope와 longForm은 따옴표 없는 JSON boolean만 사용합니다.

검증 규칙

• 결과 파일은 JSON 객체 하나여야 합니다. 설명문과 ```json 코드 펜스를 포함하지 않습니다.
• format, schemaVersion, packVersion, classifications 이름을 바꾸거나 삭제하지 않습니다.
• 원본 youtubeId를 그대로 사용하고, 요청에 없는 곡을 임의로 추가하지 않습니다.
• confidence는 문자열이 아니라 0.0~1.0 숫자로 작성합니다.
• 허용되지 않은 속성 키를 만들지 않습니다. 문자열 속성은 200자 이하, boolean 속성은 true/false만 사용합니다.
• 확실하지 않은 속성은 생략합니다. 한 결과의 attributes가 완전히 비어 있으면 그 곡 결과 자체를 제외합니다.
• 결과 파일은 10MB 이하, 분류 결과는 최대 20,000곡, 근거는 곡당 최대 20개입니다.

자동 사용 기준: confidence ≥ 0.90. 0.90 미만 결과도 가져오지만 RuleEngine에는 즉시 사용하지 않고 사용자 검토 대상으로 남깁니다. 사용자가 승인하면 신뢰도 1.0으로 저장됩니다.

confidence 모델

현재 schema v1은 곡 단위 confidence 하나를 사용합니다. 이 값은 해당 곡의 attributes 객체 전체에 적용됩니다. voice=0.99, style=0.65처럼 속성별 값을 보내면 v1 importer가 읽을 수 없습니다.

향후 schema v2 후보로 속성별 confidence를 검토합니다. 이번 변경에서는 v1 파일 형식과 importer 호환성을 유지하며 새 필드를 추가하지 않습니다.

AI 분류 지침

• 곡 하나에 여러 속성이 동시에 존재할 수 있습니다. 속성 하나만 고르는 단일 분류 문제가 아닙니다.
• 태그/내부 속성과 실제 YouTube 재생목록은 다른 개념입니다. 분류 결과 JSON에는 재생목록 변경을 넣지 않습니다.
• currentPlaylists는 중요한 힌트지만 절대적인 정답은 아닙니다.
• 사용자 메모와 userClassificationCriteria, 사용자가 직접 만든 규칙을 자동 추론보다 우선합니다.
• 확실하지 않으면 억지로 추측하지 않고 해당 속성을 생략하며 confidence를 과장하지 않습니다.
• longForm이나 Minor III 같은 관리 개념을 일반 음악 장르와 혼동하지 않습니다. Minor III는 속성이 아니라 사용자 재생목록 이름일 수 있습니다.
• 한 곡은 여러 재생목록에 중복 배치될 수 있습니다.
• AI가 기존 YouTube 재생목록에서 곡을 자동 제거한다고 가정하지 않습니다. 자동 제거는 이 앱의 기본 동작이 아닙니다.

규칙 제작 지침

현재 앱은 규칙 JSON 가져오기를 지원하지 않습니다. AI가 규칙을 제안할 때는 아래 실제 Rule Builder 항목만 사용하고, 사용자가 앱 화면에 입력할 수 있는 형태로 설명해야 합니다.

조건 모델

실행 모델

지원되는 규칙 예시

조건 방식: ALL

조건
CURRENT_PLAYLIST / EQUALS / UNI

실행
ADD_PLAYLIST / VC
ADD_PLAYLIST / vocal synth

이유
# UNI 곡을 관련 Playlist에 함께 정리

조건 방식: ANY

조건
DURATION / GREATER_OR_EQUAL / 1800
TITLE / CONTAINS / Mix

실행
LONG_FORM
ADD_PLAYLIST / Minor III

이유
# 긴 Mix 또는 장문 콘텐츠를 관리 Playlist에 정리

사용자 직접 규칙은 자동 분류 추론보다 우선합니다. 같은 우선순위에서는 차단 결과가 추가 결과보다 우선합니다.

AI에게 이 지침을 함께 전달하세요

오류 해결