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 (valfria vid skapande, obligatoriska för distribution)

writers[] är valfri när du skapar ett spår, men obligatorisk för att distribuera släppet – varje spår behöver minst en låtskrivare med rollen Composer eller Lyricist och en procentandel, splittarna på varje spår måste summera till 100 % och instrumentala spår är inget undantag. Ett spår sparas alltså utan låtskrivare, men ett släpp vars spår saknar låtskrivare klarar inte valideringen och kan inte godkännas för distribution.

Varje post har:

• 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.

master_splits[] – inspelningssplittar (dem skapar vi åt dig)

Mastersplittar fördelar intäkterna från inspelningen. Precis som writers[] krävs de innan ett släpp kan distribueras – men till skillnad från writers[] behöver du nästan aldrig skicka dem: utelämnar du master_splits skapar LabelGrid en standardsplit för spåret med ditt bolags standardandel (50 % om du inte har ändrat den på bolaget) och fördelar resten jämnt mellan spårets artister. Mastersplittar används för royaltyredovisningen inuti LabelGrid och skickas aldrig till butikerna.

Importerar du en katalog i bulk: hoppa över master_splits och låt standardvärdena gälla. Skicka det bara för spår som behöver en egen fördelning – och om ditt bolags standardandel inte är den du vill ha, ändra den på bolaget innan du importerar.

När du skickar det har varje post:

• entity_type – label eller artist
• entity_id – ID:t för det bolaget eller den artisten
• percentage_share – ett tal från 0 till 100

Regler:

• Minst en post om arrayen finns med.
• Splittarna måste summera till 100 %.

Caution

Så fort du skickar master_splits är splitten din: en array vars andelar inte summerar till 100 % avvisas, och ingen standardsplit skapas för det spåret. Vill du inte ha en egen fördelning – utelämna fältet helt i stället för att skicka en ofullständig array.

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.
• Att utelämna writers[] på ett spår går bra att spara, men blockerar distributionen senare: varje spår behöver minst en låtskrivare, och splittarna måste summera till exakt 100 %.
• Att skicka en ofullständig master_splits-array: summerar den inte till 100 % avvisas den. Utelämna fältet helt, så skapar vi standardsplitten åt dig.

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