Actions25
- Advanced Generation Actions
- Audio Generation Actions
- Audio Processing Actions
- Search Actions
Audio Generation → Generate Audio
AI-generatedSummary
Generate music through MusicGPT from either a descriptive prompt or custom lyrics and a music style. Optional settings control vocals, voice, excluded tags, output duration, and a completion webhook.
Inputs
- Generation Mode (required) — Choose Prompt (the default) or Custom (Lyrics + Style).
- Prompt (required) — In Prompt mode, describe the music to generate.
- Music Style (required) — In Custom mode, specify the music style.
- Lyrics — In Custom mode, provide lyrics for the song.
- Make Instrumental — Generate without vocals; defaults to false.
- Vocal Only — Generate vocals without instrumentation; defaults to false.
- Voice Name or ID — Optionally select a voice; defaults to none, which omits the voice ID from the request.
- Negative Tags — Optional tags or themes to avoid.
- Output Length — Desired length in seconds, from 0 to 300. The default 0 omits this setting from the request.
- Webhook URL — Optional URL for a completion notification.
Output shape
One item per input item, containing a JSON object with success, task_id, conversion_id_1, conversion_id_2, eta, and message fields from the API response.
Starts a generation task and returns its task/conversion details; the generated audio itself is not returned here. Errors are raised unless Continue On Fail is enabled, in which case an item with an error field is returned.