AI Music API
  1. suno
AI Music API
  • Introduction
  • Credits Usage Guide
  • Error handling
  • suno
    • Suno Instructions
    • create music
      POST
    • extend music
      POST
    • concat music
      POST
    • cover music
      POST
    • create persona
      POST
    • create music with persona
      POST
    • upload music
      POST
    • get music
      GET
  • riffusion
    • Riffusion instructions
    • create music (with lyrics)
      POST
    • create music (with description)
      POST
    • cover music
      POST
    • extend music
      POST
    • replace music section
      POST
    • swap music sound
      POST
    • swap music vocals
      POST
    • upload
      POST
    • get music
      GET
  • nuro
    • Nuro Instruction
    • Error handling
    • create vocal music
      POST
    • create instrument music
      POST
    • get music
      GET
  • lyrics generation
    • Make Lyrics
  • get-credits
    GET
  1. suno

Suno Instructions

Key Field Usage#

1. Custom Mode: custom_mode = true#

In this mode, you can customize the song's title, style, and lyrics, corresponding to the fields:
title
tags
prompt

2. Non-Custom Mode: custom_mode = false#

In this mode, you only need the gpt_description_prompt field to describe the music.

3. Instrumental Control#

Use the make_instrumental field to control whether to generate instrumental-only music.

Field Details#

custom_mode:
A boolean switch for enabling custom mode.
Required
When enabled, it allows you to control the song's title, style, and lyrics.
prompt:
The song's lyrics.
Required if custom mode is enabled.
Should generally not exceed 3000 characters.
title:
The song's title.
Optional
Should generally not exceed 120 characters.
tags:
The song's style or genre.
Optional
Should generally not exceed 80 characters.
mv:
The model version for generation.
Required
Can be either chirp-v3-5 or chirp-v4 or chirp-v4-5 or chirp-v4-5-plus.
make_instrumental:
Controls whether to generate instrumental-only music.
Optional
gpt_description_prompt:
A description of the song.
Required if custom mode is disabled.
Should generally not exceed 200 characters.
task_type:
Specifies the type of task to perform.
Required
Allowed values: create_music, extend_music, concat_music, cover_music,cover_upload_music, extend_upload_music, persona_music.
persona_id:
The ID of a persona created via the "create persona" API.
Optional
This ID can be used to generate music based on the specified persona.
style_weight:
The weight of the tags field (style).
Optional
Range: >= 0 <= 1
weirdness_constraint:
The randomness or weirdness of the song.
Optional
Range: >= 0 <= 1
negative_tags:
Elements you want to avoid in your songs.
Optional

Note#

When use your own uploaded music, you need to use the upload task type.
Modified at 2025-07-20 08:16:15
Previous
Error handling
Next
create music
Built with