トラックのライターとコントリビューター（API）

LabelGrid 公開 API でトラックを作成するときは、その制作に関わった人々を 2 つの別々の配列で記述します。1 つは楽曲クレジット（誰が何を担当したか）、もう 1 つはパブリッシングの取り分（誰がその楽曲を所有し、何パーセントを持つか）です。このガイドでは、それぞれの配列に何を入れるか、そしてトラック作成時に適用されるルールを説明します。

トラックごとに 2 つの配列

各トラックには、独立した 2 つの配列があります。

• contributors[] - 楽曲クレジット。トラックで誰が何を担当したか。
• writers[] - パブリッシングの取り分。誰がその楽曲を所有し、何パーセントを持つか。

どちらの配列も、writerId（キャメルケース）または writer_id（スネークケース）でライタープロフィールを参照します。送信できるのはどちらか 一方だけ で、両方を送るとエラーになります。ID は、自分が所有するライターと一致している必要があります。

どちらの配列も、同じライターレジストリ（Writers エンドポイントで作成したライター）を参照します。つまり、コントリビューターとパブリッシングの取り分のライターは、同じライターレコードを指します。

contributors[] - 作成時に必須

contributors[] は作成時に 必須 で、少なくとも 1 件のエントリーが必要です。各エントリーには次の項目があります。

• writerId / writer_id
• roles[] - コントリビューターの役割の参照リストから選んだ 1〜3 個の役割
• ai_contribution - none、partly、all のいずれか

トラックを POST したときに適用されるルールは次のとおりです。

• 3 つの役割カテゴリーをすべてカバーする - コントリビューター全体で、Performer、Composition & Lyrics、Production & Engineering の役割が少なくとも 1 つずつ必要です。
• 少なくとも 1 人は人間 - すべてのコントリビューターの ai_contribution を all にすることはできません。
• コントリビューター配列内で ライター ID の重複は不可 です。

writers[] - パブリッシングの取り分（トラック作成時は任意、配信するには必須）

writers[] は トラックを作成するだけなら任意ですが、リリースを配信するには必須 です。各トラックに Composer または Lyricist の役割と取り分の割合を持つライターが少なくとも 1 人必要で、トラックごとの取り分の合計は 100% でなければならず、インストゥルメンタルも例外ではありません。つまり、ライターなしでもトラックは問題なく保存できますが、トラックにライターがいないリリースは検証を通らず、配信の承認も受けられません。

各エントリーには次の項目があります。

• writerId / writer_id
• roles[] - 役割は 1 つ以上。指定できる値は Composer と Lyricist のみです
• percentage_share - 0 から 100 までの数値

ルール：

• 取り分の合計は 100% でなければなりません - すべてのライターの percentage_share の合計が 100 になる必要があります。
• ライター ID の重複は不可。
• 1 人のライターに対する 役割の重複は不可。

master_splits[] - 原盤の取り分（こちらで自動的に作成します）

マスタースプリットは原盤収益の配分を表します。writers[] と同じくリリースを配信する前に必須ですが、writers[] とは違って、ご自身で送る必要はほとんどありません。master_splits を省略すると、LabelGrid がそのトラックのデフォルトの取り分を作成します。レーベルのデフォルト配分（レーベル側で変更していなければ 50%）を割り当て、残りをトラックのアーティストで均等に分けます。マスタースプリットは LabelGrid 内部の印税計算に使うもので、ストアに送信されることはありません。

カタログを一括で取り込む場合は、master_splits を省略してデフォルトに任せてください。送るのは独自の配分が必要なトラックだけにし、レーベルのデフォルト配分が希望どおりでない場合は、取り込む前にレーベル側で変更してください。

送信する場合、各エントリーには次の項目があります。

• entity_type - label または artist
• entity_id - そのレーベルまたはアーティストの ID
• percentage_share - 0 から 100 までの数値

ルール：

• 配列を指定する場合は エントリーが 1 件以上 必要です。
• 取り分の合計は 100% でなければなりません。

注意

master_splits を送った時点で、取り分の管理はご自身の責任になります。合計が 100% にならない配列は拒否され、そのトラックにデフォルトの取り分も作成されません。独自の配分が不要な場合は、不完全な配列を送るのではなく、フィールドごと省略してください。

最小限の例

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

よくあるエラー

• 単数形の role ではなく、複数形の roles を使ってください。
• share ではなく percentage_share を使ってください。
• 同じエントリーで writerId と writer_id を両方送らないでください。
• パブリッシングの取り分のライターでは、役割として Composer と Lyricist のみが受け付けられます。
• トラックで writers[] を省略しても保存はできますが、後で配信がブロックされます。各トラックにはライターが少なくとも 1 人必要で、取り分の合計はちょうど 100% でなければなりません。
• 不完全な master_splits 配列を送ること。合計が 100% にならない配列は拒否されます。フィールドごと省略すれば、デフォルトの取り分をこちらで作成します。

関連情報

• API 概要 - エンドポイント、認証、完全なリファレンス（コントリビューターの役割の参照データを含む）
• ライターとコントリビューター - カタログでライタープロフィールがどのように機能するか