MusicAPI
HomeDocs
HomeDocs
  1. Docs
  • 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. Docs

Music API FAQ & Troubleshooting

šŸŽµ Sonic API FAQ#

1. How can I quickly get started with all the features of the Sonic API?#

Start by testing all the features on the official Sonic platform to see the required parameters and their constraints.
Then, follow our documentation to test specific functionalities.
New accounts have 5 free test opportunities.

2. How do I generate a custom song?#

Set the custom_mode field to true, and fill in the prompt, title, and tags fields.

3. How can I generate a song based on a description?#

Set custom_mode to false and fill in the gpt_description_prompt field, which will contain your song description.

4. How do I generate custom and non-custom instrumental music?#

Use the custom_mode and make_instrumental fields:
custom_mode controls whether the generation is custom.
make_instrumental controls whether the music is instrumental.
Refer to Question 2 and Question 3 for details.

5. How can I extend music?#

Set task_types to extend_music.
Fill in the continue_clip_id (the clip ID of the song you want to extend).
Fill in the continue_at (the starting time point for extension in seconds).

6. How do I retrieve the full extended music?#

Songs extended using extend_music only include the extended part.
To get the full song, use concat_music as the task_type and provide the continue_clip_id of the extended clip.
This will merge the extended part with the original.

7. How can I create a song cover?#

Use cover_music as the task_type.
Set continue_clip_id to the clip ID of the original song to be covered.

8. How do I create a persona?#

Use the create_persona API and provide:
name ā†’ Persona name
description ā†’ Persona style description
continue_clip_id ā†’ Clip ID of the original song used to create the persona

9. How do I generate music using a created persona?#

Use persona_music as the task_type.
Provide the persona's ID in the persona_id field.

10. How can I upload my own song to obtain an official Sonic clip ID?#

Use the upload API.
Input the online song URL in the url field.
Send the request. Within about 20 seconds, you will receive the clip ID.
āš ļø Note: Uploaded songs must be:
Copyright-free
6 to 60 seconds long

11. How do I generate professional lyrics?#

Use the lyrics API and input your lyrics description in the description field.
šŸ”¹ This feature consumes lyrics credits instead of regular credits.

12. How can I extend a song I uploaded?#

1.
Upload your song using the upload API to get its clip ID.
2.
Use this clip ID to extend the song.
3.
Set task_type to extend_upload_music instead of extend_music.

13. How can I cover a song I uploaded?#

1.
Upload your song using the upload API to get its clip ID.
2.
Use this clip ID to cover the song.
3.
Set task_type to cover_upload_music instead of cover_music.
šŸš€ Now you are ready to explore all the features of the Sonic API!
Previous
Credits Usage Guide
Next
Common Scenarios
Built with