AI Music API
Home
Home
  1. suno
  • Introduction
  • Credits Usage Guide
  • Error handling
  • Webhook Integration Guide
  • suno
    • Suno Instructions
    • create music (custom mode)
      POST
    • create music (no-custom mode)
      POST
    • create music (Control singer gender)
      POST
    • create music (auto lyrics mode)
      POST
    • extend music
      POST
    • concat music
      POST
    • cover music
      POST
    • stems basic
      POST
    • stems full
      POST
    • create persona
      POST
    • create music with persona
      POST
    • upload music
      POST
    • get wav
      POST
    • get music
      GET
  • riffusion(Deprecated)
    • 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
  • producer
    • Producer Instructions
    • Complete Request Example
    • create music
    • get music
  • nuro
    • Nuro Instruction
    • Error handling
    • create vocal music
    • create instrument music
    • get music
  • 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.
for v4.5+ and v4.5-plus and v5, Should generally not exceed 5000 characters
for v4 and below, Should generally not exceed 3000 characters
title:
The song's title.
Optional
Should generally not exceed 80 characters.
tags:
The song's style or genre.
Optional
for v4.5+ and v4.5-plus and v5, Should generally not exceed 1000 characters
for v4 and below, Should generally not exceed 200 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-plusor chirp-v5.
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 400 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
vocal_gender:
"f"(Female) or "m"(Male). control the vocal of gender,
support sonic-v4-5 and sonic-v4-5-plus
Optional
auto_lyrics:
weather auto generate lyrics and style,Must be used with custom_mode:true
Optional

Note#

When use your own uploaded music, you need to use the upload task type.
Modified at 2025-09-27 07:18:49
Previous
Webhook Integration Guide
Next
create music (custom mode)
Built with