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 sonic-v3-5 or sonic-v4 or sonic-v4-5 or sonic-v4-5-plus or sonic-v5.

make_instrumental:
Controls whether to generate instrumental-only music.

Optional

audio_weight:
use for cover_music, Control how much influence the original audio has over the final result.

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 extending your own uploaded music, you need to use the extend_upload_music task type.

Sonic Instructions

Key Field Usage#

1. Custom Mode: custom_mode = true#

2. Non-Custom Mode: custom_mode = false#

3. Instrumental Control#

Field Details#

Note#

Key Field Usage

1. Custom Mode: `custom_mode = true`

2. Non-Custom Mode: `custom_mode = false`

3. Instrumental Control

Field Details

Note