generate_music

Generate music

Start a music generation from a creative brief. This spends credits, or runs on the user's own key, and returns immediately.

Models:

minimax-music-2.6 — MiniMax Music 2.6; ~12.5 per track
eleven-music — Eleven Music; ~12.5 per track; instrumental only — takes no lyrics and no lyrics_optimizer; always MP3 — sample_rate and bitrate are not accepted

Scope

generation.write — Makes, edits, imports, shares and deletes media in the account.

Behaviour

Writes: Creates or changes items in the caller's own account.
Adds or updates: Adds or updates; nothing the caller already has is deleted or overwritten.
Stays in the account: Stays inside the caller's private Kuro account: any media provider it calls acts on Kuro's account, and the result is visible to no one else.

Credits

What the tool's description says about credits, verbatim.

This spends credits, or runs on the user's own key, and returns immediately.

Inputs

promptstring · required
at least 1 character · at most 4000 characters
idempotency_keystring · optional
Optional. Pass the same value to retry one operation without spending twice; omit it for a new operation. Different arguments under a reused key are refused.
at least 1 character · at most 128 characters
modelstring · optional
one of "minimax-music-2.6", "eleven-music"
lyricsstring · optional
at least 1 character · at most 3500 characters
is_instrumentalboolean · optional
lyrics_optimizerboolean · optional
sample_ratenumber · optional
one of 16000, 24000, 32000, 44100
bitratenumber · optional
one of 32000, 64000, 128000, 256000
audio_formatstring · optional
one of "mp3", "wav", "pcm"
runs_onstring · optional
Who pays: "credits", or one of the user's own keys by vendor (get_credits lists them). Leave out to follow their payer order; set it only when the user chose.
one of "credits", "replicate", "fal", "siray", "runware", "higgsfield", "sunra", "comfy"

Example call

A tools/call request with the required arguments only, each a placeholder read off the schema. Replace them before sending.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "generate_music",
    "arguments": {
      "prompt": "<prompt>"
    }
  }
}

Input schema

As the server sends it in tools/list.

{
  "type": "object",
  "properties": {
    "idempotency_key": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128,
      "description": "Optional. Pass the same value to retry one operation without spending twice; omit it for a new operation. Different arguments under a reused key are refused."
    },
    "prompt": {
      "type": "string",
      "minLength": 1,
      "maxLength": 4000
    },
    "model": {
      "type": "string",
      "enum": [
        "minimax-music-2.6",
        "eleven-music"
      ]
    },
    "lyrics": {
      "type": "string",
      "minLength": 1,
      "maxLength": 3500
    },
    "is_instrumental": {
      "type": "boolean"
    },
    "lyrics_optimizer": {
      "type": "boolean"
    },
    "sample_rate": {
      "type": "number",
      "enum": [
        16000,
        24000,
        32000,
        44100
      ]
    },
    "bitrate": {
      "type": "number",
      "enum": [
        32000,
        64000,
        128000,
        256000
      ]
    },
    "audio_format": {
      "type": "string",
      "enum": [
        "mp3",
        "wav",
        "pcm"
      ]
    },
    "runs_on": {
      "type": "string",
      "enum": [
        "credits",
        "replicate",
        "fal",
        "siray",
        "runware",
        "higgsfield",
        "sunra",
        "comfy"
      ],
      "description": "Who pays: \"credits\", or one of the user's own keys by vendor (get_credits lists them). Leave out to follow their payer order; set it only when the user chose."
    }
  },
  "required": [
    "prompt"
  ],
  "additionalProperties": false
}

Related tools

quote_generation
Price a request exactly, and compare it to the balance, without creating anything.

Every tool· This page as Markdown