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

Error handling

āš ļø Error Handling Guide#

šŸ”¹ Error Types#

Error TypeError CodeError Message
Validation Error400"The 'mv' field is invalid. The model should be 'sonic-v3-5' or 'sonic-v4'."
Validation Error400"The 'persona_id' field is required when task_type = persona_music."
Validation Error400"The 'make_instrumental' field should be boolean."
Validation Error400"The 'custom_mode' field should be boolean."
Validation Error400"The prompt character length should be less than 3000."
Validation Error400"The 'gpt_description_prompt' character length should be less than 200."
Validation Error400"The tags character length should be less than 200."
Validation Error400"The title character length should be less than 80."
Validation Error400"description is required."
Validation Error400"The description character length should be less than 120."
Validation Error400"name and continue_clip_id are required fields."
Validation Error400"The name character length should be less than 80."
Validation Error400"The description character length should be less than 200."
Validation Error400"task not found."
Validation Error400"missing task id."
Unauthorized401"Authorization header is missing."
Unauthorized401"Invalid authorization format."
Forbidden403"The remaining credits are not enough. You can buy more one-time credit packs or subscribe."
Forbidden403"You do not have an active subscription. Please check whether your renewal was successful."
Forbidden403"The lyrics format is invalid. Please check and try again."
Forbidden403"The lyrics contain copyrighted content: 'specificError'. Please use original lyrics."
Forbidden403"The lyrics contain inappropriate content: 'specificError'."
Forbidden403"The song description needs moderation review."
Forbidden403"The song description contains artist names: 'specificError' which is not allowed."
Forbidden403"The song description contains producer tags: 'specificError' which is not allowed."
Not Found400"task not found."
Timeout504"Task failed due to timeout. Credits were previously refunded."
Server Error500"Internal Server Error."

šŸ“ Notes#

1.
The generated Sonic CDN URL does not have an expiration time.
2.
A song can only create one persona.
3.
Service Stability:
Sonic v3.5 is less stable than Sonic v4.
However, in terms of generation quality, Sonic v4 is less stable than Sonic v3.5.

šŸ“Œ Ensure to handle these errors properly in your integration for a smooth user experience.
Modified atĀ 2025-02-11 03:23:35
Previous
Common Scenarios
Next
Sonic Instructions
Built with