suno_generate_music
Generate complete music from a text prompt. Describe genre, mood, or theme and get AI-created lyrics, melody, and arrangement.
Instructions
Generate AI music from a text prompt using Suno's Inspiration Mode.
This is the simplest way to create music - just describe what you want and Suno
will automatically generate appropriate lyrics, melody, style, and arrangement.
Use this when:
- You want quick music generation with minimal input
- You don't have specific lyrics in mind
- You want Suno to be creative with the arrangement
For full control over lyrics and style, use suno_generate_custom_music instead.
Returns:
Task ID and generated audio information including URLs, title, lyrics, and duration.Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| prompt | Yes | Description of the music to generate. Be descriptive about genre, mood, instruments, and theme. Examples: 'A happy birthday song with acoustic guitar', 'Epic orchestral battle music with dramatic choir', 'Chill lo-fi hip hop beat for studying' | |
| model | No | Suno model version. 'chirp-v5-5' is the latest and recommended for best quality with 8-minute max duration. 'chirp-v4-5' is a reliable choice for most use cases. Older models (v3, v3-5, v4) have shorter duration limits. | chirp-v5-5 |
| instrumental | No | If true, generate instrumental music without vocals. Default is false (with vocals). | |
| variation_category | No | Variation intensity for v5+ models. 'high' for maximum variation, 'normal' for balanced, 'subtle' for minimal changes. Only supported in chirp-v5 and above. | |
| callback_url | No | Webhook callback URL for asynchronous notifications. When provided, the API will call this URL when the audio is generated. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |