Actions16
Generate Music
AI-generatedSummary
Generate a new music track using the Suno AI music generation models by providing a descriptive text prompt and optionally custom lyrics, style, title, and musical tags. Configure generation options such as whether the output should be instrumental only, and select the model version to use.
Inputs
- Prompt — Text description of the music to generate, guiding the AI's creation.
- Lyrics — Custom lyrics to include in the generated music (optional if a prompt is provided).
- Style — Description of the musical style, such as "upbeat pop" or "jazz ballad", influencing the track's character.
- Title — Title for the generated music track.
- Model Version — Suno AI model version to use for generation, with options ranging from V3.5 up to the latest V5.5.
- Instrumental — Boolean flag to generate instrumental-only music (no vocals).
- Tags — Comma-separated musical style tags (e.g., "rock, guitar, upbeat") as an alternative to 'Style', supported in model versions V4 and above.
- Reply URL — Webhook URL to receive a callback when the generation task completes, useful for asynchronous workflows.
- Reply Ref — Custom reference string passed back in webhook callbacks for correlation.
- Wait for Completion — Whether to wait for the generation task to complete before returning; defaults to true and polls status with timeout.
Output shape
a single JSON object representing the task result or final generated music data
If waiting for completion is enabled, the node polls the task status until completion (success or failure) or a 5-minute timeout occurs. The response data includes parsed URLs for the generated audio and other metadata for easy use in subsequent workflow steps.