brama music¶
Compose one song through a music route, over the same dispatch as POST /v1/audio/music, and write the audio the provider encoded.
Invocation¶
brama music --model <ROUTE> --lyrics <TEXT> --output <FILE> [--prompt <TEXT>] [--response-format <FORMAT>] [--json] --allow-provider-cost| Input | Required/default | Meaning |
|---|---|---|
--model <ROUTE> | required | A canonical route that composes music, such as minimax/music-2.6, or a media alias. |
--lyrics <TEXT> | required | The song's words, lines separated by newlines. |
--output <FILE> | required | Where the audio is written. |
--prompt <TEXT> | optional | Style, mood and instrumentation. |
--response-format <FORMAT> | optional | The container, such as mp3 or wav. |
--allow-provider-cost | required | Acknowledge the billable provider request. |
--json | optional; off | Print the result as one JSON document. |
Output and state¶
It writes the provider's audio to --output unchanged and prints route, audio (the content type), bytes and output, then exits 0.
Refusals¶
| Sentence | Exit | Meaning |
|---|---|---|
refusing a billable music request without explicit --allow-provider-cost | 2 | Nothing was sent. |
the dispatch refusal, such as an undeclared alias, a route that does not compose music, or provider_rate_limited: <provider's sentence> | 1 | The same sentences brama speak lists; no file was written. |
cannot write <path>: <reason> | 1 | The audio arrived and the destination could not be written. |
See media or the CLI tree.