Daydream

Make an original instrumental song from a description: genre, mood, instruments, tempo, what it's for. Returns it queued; the player in the chat shows it rendering and plays it when it's done (about a minute), with MP3 and WAV downloads and its five stems (drums, bass, guitar, keys, other) as FLAC. Where there's no player, get_song gives those links once it's done. Artist names are not allowed and are removed from prompts before generation: describe the sound instead. Royalty-free, for commercial games and videos.

{
  "type": "object",
  "properties": {
    "prompt": {
      "type": "string",
      "maxLength": 400,
      "description": "The music in words, e.g. \"a calm village theme with flute and harp\"."
    },
    "duration": {
      "type": "number",
      "minimum": 10,
      "maximum": 120,
      "description": "Length in seconds (default 120)."
    },
    "loop": {
      "type": "boolean",
      "description": "A seamless loop, for a game level or a background."
    },
    "bpm": {
      "type": "integer",
      "minimum": 60,
      "maximum": 200,
      "description": "Tempo; left out, it's chosen from the prompt."
    },
    "key": {
      "type": "string",
      "description": "A note with sharps and major or minor, like \"C major\" or \"F# minor\"."
    },
    "variations": {
      "type": "integer",
      "enum": [
        1,
        2
      ],
      "description": "How many versions of it to make (default 1). Two count as one song."
    },
    "seed": {
      "type": "integer",
      "minimum": 0,
      "maximum": 2147483647,
      "description": "Makes the same song again from the same words and settings; left out, a new one each time."
    }
  },
  "required": [
    "prompt"
  ],
  "additionalProperties": false
}

Where a song made with create_song stands: its place in line, or, once done, each version's MP3 and WAV links and its five stems' FLAC links (a few seconds after the mix), and any part being made again with redo_stem.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^sng_[0-9A-Za-z]{22}$",
      "description": "The song's id from create_song."
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

Make one stem of a finished song again (new drums, say), with the other four exactly as they are; the mix becomes the new part with the rest. Counts as one song. Takes about a minute; the player shows it. undo_stem puts the old part back.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^sng_[0-9A-Za-z]{22}$",
      "description": "The song's id."
    },
    "version": {
      "type": "integer",
      "enum": [
        1,
        2
      ],
      "description": "Which version of the song (default 1)."
    },
    "stem": {
      "type": "string",
      "enum": [
        "drums",
        "bass",
        "guitar",
        "keys",
        "other"
      ],
      "description": "The part to make again."
    }
  },
  "required": [
    "id",
    "stem"
  ],
  "additionalProperties": false
}

Put a song's version back to how it was before its last redo_stem: the old part plays again, and the mix with it. Costs nothing. Only the last redo can be undone.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^sng_[0-9A-Za-z]{22}$",
      "description": "The song's id."
    },
    "version": {
      "type": "integer",
      "enum": [
        1,
        2
      ],
      "description": "Which version of the song (default 1)."
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

The songs on the person's Daydream account, newest first: each one's id, words, length, tempo and how many versions. Use get_song with an id to play one.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "How many (default 10)."
    }
  },
  "additionalProperties": false
}

How many songs the person has made this month and how many they can make (no limit on some accounts), and when the count starts again.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}