トラックのライターとコントリビューター（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[] - パブリッシングの取り分（任意。ただし指定する場合は合計 100% が必須）

writers[] は作成時には 任意 です。含める場合、各エントリーには次の項目があります。

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

ルール：

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

最小限の例

{
  "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[] を含める場合、取り分の合計はちょうど 100% でなければなりません。

関連情報

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