---
title: "generate_music: Generate music"
description: "Start a music generation from a creative brief."
canonical_url: "https://meetkuro.com/agents/tools/generate_music/"
updated: 2026-11-03
locale: "en"
tool: "generate_music"
scopes: ["generation.write"]
---

# 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

| Name | Type | Required | Details |
| --- | --- | --- | --- |
| `prompt` | string | yes | at least 1 character; at most 4000 characters |
| `idempotency_key` | string | no | 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 |
| `model` | string | no | one of "minimax-music-2.6", "eleven-music" |
| `lyrics` | string | no | at least 1 character; at most 3500 characters |
| `is_instrumental` | boolean | no | — |
| `lyrics_optimizer` | boolean | no | — |
| `sample_rate` | number | no | one of 16000, 24000, 32000, 44100 |
| `bitrate` | number | no | one of 32000, 64000, 128000, 256000 |
| `audio_format` | string | no | one of "mp3", "wav", "pcm" |
| `runs_on` | string | no | 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.

```json
{
  "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`:

```json
{
  "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`](https://meetkuro.com/agents/tools/quote_generation.md): Price a request exactly, and compare it to the balance, without creating anything.

---

## About Kuro

Kuro is an AI picture studio: prompt-driven images, clips, voice-overs and music, and storyboard-backed films with consistent characters across every scene.

Agents connect over MCP and can generate directly:

```
claude mcp add kuro https://api.meetkuro.com/mcp --transport http
```

The app is at https://app.meetkuro.com and requires an account.

Each guide, model page, comparison and free tool page on this site (not a tool's variants, and not the index pages) has a Markdown twin at its own URL plus `.md`, and so do /benchmarks/, the English /agents/ page (as /agents.md) and the MCP tool reference. Every tool: https://meetkuro.com/agents/tools/