Compositores y colaboradores de pista (API)

Cuando creas una pista mediante la API pública de LabelGrid, describes a las personas que hay detrás con dos arrays separados: uno para los créditos de la canción (quién hizo qué) y otro para las reparticiones de publishing (quién posee la composición y su porcentaje). Esta guía explica qué espera cada array y las reglas que se aplican al crear una pista.

Dos arrays por pista

Cada pista lleva dos arrays independientes:

• contributors[] — créditos de la canción: quién hizo qué en la pista.
• writers[] — reparticiones de publishing: quién posee la composición y su porcentaje.

Ambos arrays hacen referencia a un perfil de compositor mediante writerId (camelCase) o writer_id (snake_case). Envía exactamente uno de los dos — enviar ambos se rechaza. El ID debe coincidir con un compositor que poseas.

Ambos arrays apuntan al mismo registro de compositores — los compositores que creas a través del endpoint Writers. Por tanto, un colaborador y un compositor de repartición de publishing hacen referencia al mismo registro de compositor subyacente.

contributors[] — obligatorio al crear

contributors[] es obligatorio al crear, con al menos una entrada. Cada entrada tiene:

• writerId / writer_id
• roles[] — de 1 a 3 roles, tomados de la lista de referencia de Roles de colaborador
• ai_contribution — none, partly o all

Reglas que se aplican al hacer POST de una pista:

• Cubrir las tres categorías de rol — entre tus colaboradores, debe haber al menos un rol de Intérprete (Performer), uno de Composición y letras (Composition & Lyrics) y uno de Producción e ingeniería (Production & Engineering).
• Al menos una persona — ai_contribution no puede ser all para todos los colaboradores.
• Sin IDs de compositor duplicados en el array de colaboradores.

writers[] — reparticiones de publishing (opcional, pero debe sumar 100% si está presente)

writers[] es opcional al crear. Si lo incluyes, cada entrada tiene:

• writerId / writer_id
• roles[] — al menos un rol; los únicos valores permitidos son Composer y Lyricist
• percentage_share — un número de 0 a 100

Reglas:

• Las reparticiones deben sumar 100% — los valores de percentage_share de todos los compositores deben sumar 100.
• Sin IDs de compositor duplicados.
• Sin roles duplicados para un mismo compositor.

Un ejemplo 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
    }
  ]
}

Errores comunes

• Usa el plural roles, no role.
• Usa percentage_share, no share.
• No envíes writerId y writer_id en la misma entrada.
• Para los compositores de repartición de publishing, solo se aceptan Composer y Lyricist como roles.
• Si incluyes writers[], las reparticiones deben sumar exactamente 100%.

Recursos relacionados

• Visión general de la API — endpoints, autenticación y la referencia completa (incluidos los datos de referencia de Roles de colaborador)
• Compositores y colaboradores — cómo funcionan los perfiles de compositor en tu catálogo