MusicAPI
HomeDocs
HomeDocs
  1. studio(Unavailable)
  • Introduction
  • Credits Usage Guide
  • Music API FAQ & Troubleshooting
  • Common Scenarios
  • Error handling
  • sonic
    • Sonic 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
  • studio(Unavailable)
    • Studio Instructions
    • description mode (Use case1)
      POST
    • extend mode (Use case2)
      POST
    • custom mode (Use case3)
      POST
    • instrumental mode (Use case4)
      POST
    • get music
      GET
  • lyrics generation
    • Make Lyrics
      POST
  • nuro
    • Nuro Instruction
    • Error handling
    • create vocal music
      POST
    • create instrument music
      POST
    • get music
      GET
  1. studio(Unavailable)

Studio Instructions

Three Generation Modes in Studio#

lyrics_type=user
Uses user-provided lyrics (specified in the lyrics field) to generate music. In this mode, the prompt acts as tags for defining the music style. This corresponds to Suno's custom mode.
lyrics_type=instrumental
Creates instrumental music, where the prompt is used for relevant keywords or styles.
lyrics_type=generate
Automatically generates lyrics. The prompt field describes the type of song you want. This corresponds to Suno's descriptive mode.

Key Fields#

FieldTypeDescription
promptstringKeywords or descriptions for the song or style,is required
lyricsstringLyrics to be used in the music, when lyrics_type is user,is required
lyrics_typestringLyrics type: user (custom), generate (descriptive), instrumental (pure instrumental), is required
model_typestringModel type. The studio130-v1.5 model consumes twice the credits of studio32-v1.5. studio130-v1.5 will generate 130 seconds length of music, and studio32-v1.5 will generate 32 seconds length of music, is required
negative_promptstringNegative keywords to avoid in the output, is optional
config.modestringExtension mode: precede (extend the start of the song), continuation (extend the end), or regular (generate complete music), is required
config.source.song_idstringThe ID of the song to extend, when use extend mode, is required

Additional Parameters#

song_section_start/end#

Defines the start and end positions for generating a section of the song:
0% (0) corresponds to the beginning of the song.
50% (0.5) corresponds to the middle of the song.
100% (1) corresponds to the end of the song.
This parameter is primarily used in song extension modes.

lyrics_placement_start/end#

Specifies where to place the lyrics in the song:
8% places lyrics at the start of the song.
50% places lyrics in the middle.
90% places lyrics at the end of the song.
This parameter is particularly useful in song extension modes.

prompt_strength#

Controls how strongly the prompt influences the generated content:
Higher values increase adherence to the prompt but may make the audio sound less natural.

lyrics_strength#

Controls how strongly the lyrics influence the generated content:
Lower values may produce more natural audio but might neglect parts of the lyrics.

clarity_strength#

Adjusts the priority between audio clarity and instrument separation:
Higher values produce clearer audio but may reduce the naturalness of the sound.

generation_quality#

An experimental feature that balances generation quality and speed.

context_length#

The context length determines how much of the track the model considers when generating output. Longer context improves coherence but limits style changes, while shorter context is more flexible but less coherent.

Other Field Descriptions#

FieldTypeDescription
song_section_startnumberThe start position for extension (0-1 decimal), is optional
song_section_endnumberThe end position for extension (0-1 decimal), is optional
lyrics_placement_startnumberThe start position for lyrics placement (0-1 decimal), is optional
lyrics_placement_endnumberThe end position for lyrics placement (0-1 decimal), is optional
prompt_strengthnumberStrength of the prompt (0-1 decimal), default is 0.5, is required
clarity_strengthnumberClarity strength (0-1 decimal), default is 0.25, is required
lyrics_strengthnumberLyrics strength (0-1 decimal), default is 0.5, is required
generation_qualitynumberOptions: 0.25, 0.5, 0.75, 1. Default is 0.75. Higher values improve quality but reduce speed, is required
seednumberRandom seed. Default -1 means random generation, is optional
bypass_prompt_optimizationbooleanWhether to skip prompt optimization. Default is false, is optional
Previous
get music
Next
description mode (Use case1)
Built with