create_composition_plan
Generate a structured composition plan for music creation based on text prompts, specifying musical elements and timing for subsequent audio generation.
Instructions
Create a composition plan for music generation. Usage of this endpoint does not cost any credits but is subject to rate limiting depending on your tier. Composition plans can be used when generating music with the compose_music tool.
Args:
prompt: Prompt to create a composition plan for
music_length_ms: The length of the composition plan to generate in milliseconds. Must be between 10000ms and 300000ms. Optional - if not provided, the model will choose a length based on the prompt.
source_composition_plan: An optional composition plan to use as a source for the new composition plan
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| music_length_ms | No | ||
| prompt | Yes | ||
| source_composition_plan | No |
Input Schema (JSON Schema)
{
"properties": {
"music_length_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Music Length Ms"
},
"prompt": {
"title": "Prompt",
"type": "string"
},
"source_composition_plan": {
"anyOf": [
{
"$ref": "#/$defs/MusicPrompt"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"prompt"
],
"type": "object"
}