Starchild Music

Search Starchild's catalog of original songs by meaning: describe the song in plain words (e.g. 'uplifting country ballad about starting over, female vocal'). Optional filters narrow by genre, mood, vocal or tempo. Shows an in-chat browser where every result plays, in every production style, with more results on request (use offset).

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 400,
      "description": "What the person is looking for, in their own words"
    },
    "genre": {
      "type": "string",
      "maxLength": 40,
      "description": "e.g. Country, Pop, Rock, R&B, Holiday"
    },
    "mood": {
      "type": "string",
      "maxLength": 40,
      "description": "e.g. Uplifting, Romantic, Sad, Energetic"
    },
    "vocal": {
      "type": "string",
      "enum": [
        "Female",
        "Male",
        "Duet",
        "Instrumental"
      ]
    },
    "tempo": {
      "type": "string",
      "enum": [
        "Slow",
        "Medium",
        "Fast"
      ]
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "default": 8
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "maximum": 290,
      "default": 0,
      "description": "For more results: how many to skip"
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Full details for one Starchild song: writers, genres, moods, key, tempo, every production style, sounds-like, similar songs, and which licenses are available. Accepts the song id, its starchild.music link, or its exact title.

{
  "type": "object",
  "properties": {
    "song": {
      "type": "string",
      "maxLength": 300,
      "description": "Song id, starchild.music/songs/... link, or exact title"
    }
  },
  "required": [
    "song"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Play a Starchild song: shows an in-chat player with the original recording and every production style made for it (same vocal; switch styles mid-song), plus starchild.music links for each style.

{
  "type": "object",
  "properties": {
    "song": {
      "type": "string",
      "maxLength": 300,
      "description": "Song id, starchild.music/songs/... link, or exact title"
    }
  },
  "required": [
    "song"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Hear a Starchild song in a different production style (for example Country, Acoustic Indie, Electro Rock, Latin Salsa, Piano Ballad Orchestral). Returns a link that opens the song on starchild.music set to that style, with the original vocal. Lists the available styles if the requested one isn't made for this song.

{
  "type": "object",
  "properties": {
    "song": {
      "type": "string",
      "maxLength": 300,
      "description": "Song id, starchild.music/songs/... link, or exact title"
    },
    "style": {
      "type": "string",
      "maxLength": 60,
      "description": "Style name, e.g. 'country' or 'acoustic indie'"
    }
  },
  "required": [
    "song",
    "style"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

What licensing a Starchild song costs. With a song, returns exactly which licenses and add-ons that song offers and their prices. Without one, returns the standard price list. All prices are one-time, in US dollars.

{
  "type": "object",
  "properties": {
    "song": {
      "type": "string",
      "maxLength": 300,
      "description": "Optional song id, link, or exact title"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Turn chosen songs and licenses into one link that opens the person's Starchild cart with everything already added. Checkout happens on starchild.music. Use license ids from license_options (e.g. song-only, song-instrumental, royalty-free, exclusive-license).

{
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "song": {
            "type": "string",
            "maxLength": 300
          },
          "license": {
            "type": "string",
            "maxLength": 40,
            "default": "song-only"
          }
        },
        "required": [
          "song"
        ],
        "additionalProperties": false
      },
      "minItems": 1,
      "maxItems": 10
    }
  },
  "required": [
    "items"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Check whether a Starchild license certificate number (format SC-2026-123456) is genuine, and which song and license it covers.

{
  "type": "object",
  "properties": {
    "certificate_number": {
      "type": "string",
      "maxLength": 40
    }
  },
  "required": [
    "certificate_number"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

For songwriters and catalog owners: how to list original songs on Starchild, what it costs, how licensing earnings are paid, and who keeps the rights.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

For a connected Starchild member: their credit balance. Making a new version costs 2 credits per style (3 for songs over 3:30).

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

For a connected Starchild member: render NEW versions of a catalog song in chosen production styles, keeping the original vocal, using their credits (2 per style, 3 per style for songs over 3:30). Optional creative direction in plain words. Takes a few minutes; returns a job id for check_transform. Results also save to the member's Gen library on starchild.music. Use change_style first for styles that already exist (free).

{
  "type": "object",
  "properties": {
    "song": {
      "type": "string",
      "maxLength": 300,
      "description": "Song id, starchild.music/songs/... link, or exact title"
    },
    "styles": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 60
      },
      "minItems": 1,
      "maxItems": 4,
      "description": "Style names, e.g. ['Country Rock', 'Punk Rock']"
    },
    "direction": {
      "type": "string",
      "maxLength": 400,
      "description": "Optional creative direction, e.g. 'darker, slower, more acoustic guitar'"
    }
  },
  "required": [
    "song",
    "styles"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

For a connected Starchild member: progress and listening links for a transform started with transform_song.

{
  "type": "object",
  "properties": {
    "job": {
      "type": "string",
      "maxLength": 64
    }
  },
  "required": [
    "job"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}