MusicGPT icon

MusicGPT

Interact with MusicGPT API for audio processing and voice management

Audio Generation → Generate Audio

AI-generated

Summary

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.

Links

Discussion