Track-Autoren & -Mitwirkende (API)

Wenn Sie einen Track über die öffentliche LabelGrid-API erstellen, beschreiben Sie die beteiligten Personen mit zwei separaten Arrays: eines für die Songcredits (wer was gemacht hat) und eines für die Verlagsanteile (wer die Komposition besitzt und mit welchem Prozentsatz). Diese Anleitung erklärt, was jedes Array erwartet, und die Regeln, die beim Erstellen eines Tracks gelten.

Zwei Arrays pro Track

Jeder Track enthält zwei unabhängige Arrays:

• contributors[] — Songcredits: wer was am Track gemacht hat.
• writers[] — Verlagsanteile: wer die Komposition besitzt und mit welchem Prozentsatz.

Beide Arrays verweisen über writerId (camelCase) oder writer_id (snake_case) auf ein Autorenprofil. Senden Sie genau eines von beiden — beide zu senden wird abgelehnt. Die ID muss zu einem Autor passen, den Sie besitzen.

Beide Arrays verweisen auf dasselbe Autorenregister — die Autoren, die Sie über den Writers-Endpunkt anlegen. Ein Mitwirkender und ein Verlagsanteil-Autor verweisen also auf denselben zugrunde liegenden Autorendatensatz.

contributors[] — beim Erstellen erforderlich

contributors[] ist beim Erstellen erforderlich, mit mindestens einem Eintrag. Jeder Eintrag hat:

• writerId / writer_id
• roles[] — 1 bis 3 Rollen aus der Referenzliste der Mitwirkenden-Rollen
• ai_contribution — none, partly oder all

Regeln, die bei einem Track-POST gelten:

• Alle drei Rollenkategorien abdecken — unter Ihren Mitwirkenden muss es mindestens eine Rolle als Interpret (Performer), eine für Komposition & Text (Composition & Lyrics) und eine für Produktion & Engineering (Production & Engineering) geben.
• Mindestens eine Person — ai_contribution darf nicht für jeden Mitwirkenden all sein.
• Keine doppelten Autoren-IDs im Mitwirkenden-Array.

writers[] — Verlagsanteile (optional, müssen aber zusammen 100 % ergeben, wenn vorhanden)

writers[] ist beim Erstellen optional. Wenn Sie es einbeziehen, hat jeder Eintrag:

• writerId / writer_id
• roles[] — mindestens eine Rolle; die einzigen zulässigen Werte sind Composer und Lyricist
• percentage_share — eine Zahl von 0 bis 100

Regeln:

• Die Anteile müssen zusammen 100 % ergeben — die percentage_share-Werte aller Autoren müssen in Summe 100 ergeben.
• Keine doppelten Autoren-IDs.
• Keine doppelten Rollen für einen einzelnen Autor.

Ein minimales Beispiel

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

Häufige Fehler

• Verwenden Sie den Plural roles, nicht role.
• Verwenden Sie percentage_share, nicht share.
• Senden Sie nicht writerId und writer_id im selben Eintrag.
• Für Verlagsanteil-Autoren werden als Rollen nur Composer und Lyricist akzeptiert.
• Wenn Sie writers[] einbeziehen, müssen die Anteile genau 100 % ergeben.

Verwandte Ressourcen

• API-Überblick — Endpunkte, Authentifizierung und die vollständige Referenz (einschließlich der Referenzdaten zu den Mitwirkenden-Rollen)
• Autoren & Mitwirkende — wie Autorenprofile in Ihrem Katalog funktionieren