Auteurs et contributeurs de piste (API)

Lorsque vous créez une piste via l’API publique de LabelGrid, vous décrivez les personnes qui se trouvent derrière avec deux tableaux distincts : un pour les crédits de la chanson (qui a fait quoi) et un pour les répartitions d’édition (qui possède la composition et son pourcentage). Ce guide explique ce qu’attend chaque tableau et les règles qui s’appliquent à la création d’une piste.

Deux tableaux par piste

Chaque piste comporte deux tableaux indépendants :

• contributors[] — crédits de la chanson : qui a fait quoi sur la piste.
• writers[] — répartitions d’édition : qui possède la composition et son pourcentage.

Les deux tableaux référencent un profil d’auteur via writerId (camelCase) ou writer_id (snake_case). Envoyez exactement l’un des deux — envoyer les deux est rejeté. L’ID doit correspondre à un auteur que vous possédez.

Les deux tableaux pointent vers le même registre d’auteurs — les auteurs que vous créez via le point de terminaison Writers. Ainsi, un contributeur et un auteur de répartition d’édition référencent le même enregistrement d’auteur sous-jacent.

contributors[] — requis à la création

contributors[] est requis à la création, avec au moins une entrée. Chaque entrée comporte :

• writerId / writer_id
• roles[] — de 1 à 3 rôles, tirés de la liste de référence des Rôles de contributeur
• ai_contribution — none, partly ou all

Règles qui s’appliquent lors d’un POST de piste :

• Couvrir les trois catégories de rôle — parmi vos contributeurs, il doit y avoir au moins un rôle d’Interprète (Performer), un de Composition et paroles (Composition & Lyrics) et un de Production et ingénierie (Production & Engineering).
• Au moins une personne — ai_contribution ne peut pas être all pour tous les contributeurs.
• Pas d’ID d’auteur en double dans le tableau des contributeurs.

writers[] — répartitions d’édition (facultatif à la création, obligatoire pour distribuer)

writers[] est facultatif pour créer une piste, mais obligatoire pour distribuer la sortie : chaque piste a besoin d’au moins un auteur avec un rôle Composer ou Lyricist et un pourcentage, les répartitions de chaque piste doivent totaliser 100 % et les titres instrumentaux ne font pas exception. Une piste s’enregistre donc sans auteur, mais une sortie dont les pistes n’en ont aucun ne passera pas la validation et ne pourra pas être approuvée pour la distribution.

Chaque entrée comporte :

• writerId / writer_id
• roles[] — au moins un rôle ; les seules valeurs autorisées sont Composer et Lyricist
• percentage_share — un nombre de 0 à 100

Règles :

• Les répartitions doivent totaliser 100 % — les valeurs de percentage_share de tous les auteurs doivent totaliser 100.
• Pas d’ID d’auteur en double.
• Pas de rôles en double pour un même auteur.

master_splits[] — répartitions de l’enregistrement (nous les créons pour vous)

Les répartitions master partagent les revenus de l’enregistrement. Comme writers[], elles sont obligatoires avant qu’une sortie puisse être distribuée — mais, contrairement à writers[], vous n’avez presque jamais à les envoyer : si vous omettez master_splits, LabelGrid crée une répartition par défaut pour la piste à partir de la part par défaut de votre label (50 % sauf si vous l’avez modifiée sur le label), le reste étant partagé à parts égales entre les artistes de la piste. Les répartitions master servent à la comptabilité des redevances au sein de LabelGrid et ne sont jamais transmises aux plateformes.

Si vous importez un catalogue en masse, laissez master_splits de côté et laissez les valeurs par défaut s’appliquer. Ne l’envoyez que pour les pistes qui nécessitent une répartition personnalisée — et si la part par défaut de votre label n’est pas celle que vous voulez, modifiez-la sur le label avant d’importer.

Lorsque vous l’envoyez, chaque entrée comporte :

• entity_type — label ou artist
• entity_id — l’identifiant de ce label ou de cet artiste
• percentage_share — un nombre de 0 à 100

Règles :

• Au moins une entrée si le tableau est présent.
• Les répartitions doivent totaliser 100 %.

Attention

Dès que vous envoyez master_splits, la répartition vous appartient : un tableau dont les parts ne totalisent pas 100 % est refusé, et aucune répartition par défaut n’est créée pour cette piste. Si vous ne voulez pas de répartition personnalisée, omettez complètement le champ plutôt que d’envoyer un tableau incomplet.

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

Erreurs courantes

• Utilisez le pluriel roles, pas role.
• Utilisez percentage_share, pas share.
• N’envoyez pas writerId et writer_id sur la même entrée.
• Pour les auteurs de répartition d’édition, seuls Composer et Lyricist sont acceptés comme rôles.
• Omettre writers[] sur une piste permet de l’enregistrer mais bloque la distribution ensuite : chaque piste a besoin d’au moins un auteur, et les répartitions doivent totaliser exactement 100 %.
• Envoyer un tableau master_splits partiel : s’il ne totalise pas 100 %, il est refusé. Omettez complètement le champ et nous créerons la répartition par défaut pour vous.

Ressources associées

• Aperçu de l’API — points de terminaison, authentification et la référence complète (y compris les données de référence des Rôles de contributeur)
• Auteurs et contributeurs — comment fonctionnent les profils d’auteur dans votre catalogue