Penulis Lagu & Kontributor (API)

Saat Anda membuat sebuah lagu melalui API publik LabelGrid, Anda mendeskripsikan orang-orang di baliknya dengan dua array terpisah: satu untuk kredit lagu (siapa mengerjakan apa) dan satu untuk pembagian hak penerbitan (siapa pemilik komposisi beserta persentasenya). Panduan ini menjelaskan apa yang diharapkan oleh masing-masing array dan aturan yang berjalan ketika Anda membuat lagu.

Dua array per lagu

Setiap lagu membawa dua array yang independen:

• contributors[]: kredit lagu, yaitu siapa mengerjakan apa pada lagu tersebut.
• writers[]: pembagian hak penerbitan, yaitu siapa pemilik komposisi beserta persentasenya.

Kedua array merujuk profil penulis melalui writerId (camelCase) atau writer_id (snake_case). Kirim tepat salah satu dari keduanya; mengirim keduanya akan ditolak. ID harus cocok dengan penulis yang Anda miliki.

Kedua array mengarah ke registri penulis yang sama, yaitu penulis yang Anda buat melalui endpoint Writers. Jadi seorang kontributor dan seorang penulis pembagian hak penerbitan merujuk pada catatan penulis yang sama.

contributors[]: wajib saat pembuatan

contributors[] wajib diisi saat pembuatan, dengan minimal satu entri. Setiap entri memiliki:

• writerId / writer_id
• roles[]: 1 hingga 3 peran, diambil dari daftar referensi Peran Kontributor
• ai_contribution: none, partly, atau all

Aturan yang aktif saat Anda melakukan POST sebuah lagu:

• Cakup ketiga kategori peran: di seluruh kontributor Anda, harus ada minimal satu peran Performer, satu peran Composition & Lyrics, dan satu peran Production & Engineering.
• Minimal satu manusia: ai_contribution tidak boleh all untuk setiap kontributor.
• Tidak boleh ada ID penulis yang sama di seluruh array kontributor.

writers[]: pembagian hak penerbitan (opsional saat pembuatan, wajib untuk distribusi)

writers[] bersifat opsional untuk membuat sebuah lagu, tetapi wajib untuk mendistribusikan rilis: tiap lagu butuh minimal satu penulis dengan peran Composer atau Lyricist beserta persentase bagiannya, pembagian di tiap lagu harus berjumlah total 100%, dan lagu instrumental pun tidak dikecualikan. Jadi sebuah lagu tetap tersimpan tanpa penulis, tetapi rilis yang lagu-lagunya tidak punya penulis tidak akan lolos validasi dan tidak bisa disetujui untuk distribusi.

Setiap entri memiliki:

• writerId / writer_id
• roles[]: minimal satu peran; nilai yang diperbolehkan hanya Composer dan Lyricist
• percentage_share: angka dari 0 hingga 100

Aturan:

• Pembagian harus berjumlah total 100%: nilai percentage_share di seluruh penulis harus berjumlah 100.
• Tidak boleh ada ID penulis yang sama.
• Tidak boleh ada peran yang sama untuk satu penulis.

master_splits[]: pembagian master (kami yang membuatkannya untuk Anda)

Pembagian master membagi pendapatan dari rekaman. Seperti writers[], pembagian ini wajib ada sebelum sebuah rilis bisa didistribusikan — tetapi, berbeda dengan writers[], Anda hampir tidak pernah perlu mengirimnya: jika Anda menghilangkan master_splits, LabelGrid membuat pembagian default untuk lagu tersebut memakai bagian default label Anda (50% kecuali Anda sudah mengubahnya di label) dan membagi sisanya rata di antara artis lagu itu. Pembagian master dipakai untuk pembukuan royalti di dalam LabelGrid dan tidak pernah dikirim ke toko.

Jika Anda mengimpor katalog secara massal, jangan sertakan master_splits dan biarkan nilai default berlaku. Kirim field ini hanya untuk lagu yang butuh pembagian khusus — dan jika bagian default label Anda bukan yang Anda inginkan, ubah dulu di label sebelum mengimpor.

Jika Anda mengirimnya, setiap entri memiliki:

• entity_type: label atau artist
• entity_id: ID label atau artis tersebut
• percentage_share: angka dari 0 hingga 100

Aturan:

• Minimal satu entri jika array-nya disertakan.
• Pembagian harus berjumlah total 100%.

Perhatian

Begitu Anda mengirim master_splits, pembagian itu jadi tanggung jawab Anda: array yang persentasenya tidak berjumlah 100% akan ditolak, dan tidak ada pembagian default yang dibuat untuk lagu itu. Kalau Anda tidak butuh pembagian khusus, hilangkan field-nya sepenuhnya alih-alih mengirim array yang tidak lengkap.

Contoh minimal

{
  "title": "Track One",
  "contributors": [
    {
      "writerId": "wr_123",
      "roles": ["Vocals", "Composer", "Producer"],
      "ai_contribution": "none"
    }
  ],
  "writers": [
    {
      "writerId": "wr_123",
      "roles": ["Composer", "Lyricist"],
      "percentage_share": 100
    }
  ]
}

Kesalahan umum

• Gunakan bentuk jamak roles, bukan role.
• Gunakan percentage_share, bukan share.
• Jangan kirim writerId dan writer_id sekaligus pada entri yang sama.
• Untuk penulis pembagian hak penerbitan, hanya Composer dan Lyricist yang diterima sebagai peran.
• Menghilangkan writers[] dari sebuah lagu tetap bisa disimpan, tetapi menghambat distribusi nantinya: tiap lagu butuh minimal satu penulis, dan pembagiannya harus berjumlah tepat 100%.
• Mengirim array master_splits yang tidak lengkap: kalau jumlahnya bukan 100%, array itu ditolak. Hilangkan field-nya sepenuhnya dan kami akan membuat pembagian default untuk Anda.

Terkait

• Gambaran Umum API: endpoint, autentikasi, dan referensi lengkap (termasuk data referensi Peran Kontributor)
• Penulis & Kontributor: cara kerja profil penulis di katalog Anda