AI Music API
    AI Music API
    • Introduction
    • Credits Usage Guide
    • Error handling
    • suno
      • Suno 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
    • riffusion
      • 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
    • nuro
      • Nuro Instruction
      • Error handling
      • create vocal music
        POST
      • create instrument music
        POST
      • get music
        GET
    • lyrics generation
      • Make Lyrics
    • get-credits
      GET

    Error handling

    🔹 Error Types#

    Error TypeError CodeError Message
    Validation Error400"The 'mv' field is invalid. The model should be 'chirp-v3-5','chirp-v4' or 'chirp-v4-5'."
    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."
    📌 Ensure to handle these errors properly in your integration for a smooth user experience.
    Modified at 2025-07-15 14:20:02
    Previous
    Credits Usage Guide
    Next
    Suno Instructions
    Built with