Compositores e colaboradores de faixas (API)

Quando você cria uma faixa pela API pública do LabelGrid, descreve as pessoas por trás dela com dois arrays separados: um para os créditos da música (quem fez o quê) e outro para os splits de publishing (quem é dono da composição e qual a porcentagem). Este guia explica o que cada array espera e as regras que entram em ação quando você cria uma faixa.

Dois arrays por faixa

Cada faixa carrega dois arrays independentes:

• contributors[]: créditos da música, ou seja, quem fez o quê na faixa.
• writers[]: splits de publishing, ou seja, quem é dono da composição e qual a porcentagem.

Os dois arrays referenciam um perfil de compositor por writerId (camelCase) ou writer_id (snake_case). Envie exatamente um dos dois: enviar os dois é rejeitado. O ID precisa corresponder a um compositor que pertence a você.

Os dois arrays apontam para o mesmo registro de compositores: aqueles que você cria pelo endpoint Writers. Ou seja, um colaborador e um compositor de split de publishing referenciam o mesmo registro de compositor subjacente.

contributors[]: obrigatório na criação

contributors[] é obrigatório na criação, com pelo menos uma entrada. Cada entrada tem:

• writerId / writer_id
• roles[]: de 1 a 3 funções, escolhidas na lista de referência Contributor Roles
• ai_contribution: none, partly ou all

Regras que entram em ação quando você faz POST de uma faixa:

• Cubra as três categorias de função: entre os seus colaboradores, é preciso haver pelo menos uma função de Performer, uma de Composition & Lyrics e uma de Production & Engineering.
• Pelo menos um humano: ai_contribution não pode ser all para todos os colaboradores.
• Sem IDs de compositor duplicados no array de colaboradores.

writers[]: splits de publishing (opcional, mas, se presente, deve somar 100%)

writers[] é opcional na criação. Se você o incluir, cada entrada tem:

• writerId / writer_id
• roles[]: pelo menos uma função; os únicos valores permitidos são Composer e Lyricist
• percentage_share: um número de 0 a 100

Regras:

• Os splits devem somar 100%: os valores de percentage_share de todos os compositores precisam totalizar 100.
• Sem IDs de compositor duplicados.
• Sem funções duplicadas para um mesmo compositor.

Um exemplo mínimo

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

Erros comuns

• Use o plural roles, não role.
• Use percentage_share, não share.
• Não envie writerId e writer_id na mesma entrada.
• Para compositores de split de publishing, só Composer e Lyricist são aceitos como funções.
• Se você incluir writers[], os splits precisam somar exatamente 100%.

Relacionados

• Visão geral da API: endpoints, autenticação e a referência completa (incluindo os dados de referência Contributor Roles)
• Compositores e colaboradores: como funcionam os perfis de compositor no seu catálogo