Låtskrivare och medverkande på spår (API)

När du skapar ett spår via LabelGrids publika API beskriver du personerna bakom det med två separata arrayer: en för låtkrediter (vem gjorde vad) och en för förlagssplittar (vem äger kompositionen och med hur stor andel). Den här guiden förklarar vad varje array förväntar sig och vilka regler som körs när du skapar ett spår.

Två arrayer per spår

Varje spår har två oberoende arrayer:

• contributors[] – låtkrediter: vem gjorde vad på spåret.
• writers[] – förlagssplittar: vem äger kompositionen och med hur stor andel.

Båda arrayerna refererar till en låtskrivarprofil med writerId (camelCase) eller writer_id (snake_case). Skicka exakt ett av de två, för att skicka båda avvisas. ID:t måste matcha en låtskrivare som du äger.

Båda arrayerna pekar mot samma register över låtskrivare, alltså de låtskrivare du skapar via Writers-endpointen. En medverkande och en förlagssplittlåtskrivare refererar därför till samma underliggande låtskrivarpost.

contributors[] – obligatorisk vid skapande

contributors[] är obligatorisk vid skapande, med minst en post. Varje post har:

• writerId / writer_id
• roles[] – 1 till 3 roller, valda från referenslistan över roller för medverkande
• ai_contribution – none, partly eller all

Regler som körs när du gör POST på ett spår:

• Täck alla tre rollkategorierna – bland dina medverkande måste det finnas minst en roll inom Performer, en inom Composition & Lyrics och en inom Production & Engineering.
• Minst en människa – ai_contribution får inte vara all för samtliga medverkande.
• Inga dubbletter av writer-ID:n i contributors-arrayen.

writers[] – förlagssplittar (valfri, men måste summera till 100 % om den finns med)

writers[] är valfri vid skapande. Om du tar med den har varje post:

• writerId / writer_id
• roles[] – minst en roll; de enda tillåtna värdena är Composer och Lyricist
• percentage_share – ett tal från 0 till 100

Regler:

• Splittarna måste summera till 100 % – percentage_share-värdena för alla låtskrivare måste summera till 100.
• Inga dubbletter av writer-ID:n.
• Inga dubbletter av roller för en och samma låtskrivare.

Ett minimalt exempel

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

Vanliga fel

• Använd pluralformen roles, inte role.
• Använd percentage_share, inte share.
• Skicka inte både writerId och writer_id på samma post.
• För förlagssplittlåtskrivare accepteras bara Composer och Lyricist som roller.
• Om du tar med writers[] måste splittarna summera till exakt 100 %.

Relaterat

• API-översikt – endpoints, autentisering och den fullständiga referensen (inklusive referensdatan för roller för medverkande)
• Låtskrivare och medverkande – så fungerar låtskrivarprofiler i din katalog