Get started with the Suno API to generate AI music, lyrics, and audio content in minutes Welcome to Suno API# The Suno API enables you to create high-quality AI-generated music, lyrics, and audio content using state-of-the-art AI models. Whether you're building a music app, automating creative workflows, or developing audio content, our API provides comprehensive tools for music generation and audio processing.
Generate Music
Create original music tracks with or without lyrics
Extend Music
Extend existing music tracks seamlessly
Generate Lyrics
Create creative lyrics from text prompts
Music Videos
Convert audio tracks into visual music videos
Upload & Cover
Transform uploaded audio into new styles
Upload & Extend
Upload audio files and extend them seamlessly
Add Instrumental
Generate instrumental accompaniment for uploaded audio
Add Vocals
Add vocal singing to uploaded audio files
Separate Vocals
Separate vocals and instrumentals from music
Convert to WAV
Convert audio to high-quality WAV format
Get Lyrics
Retrieve timestamped synchronized lyrics Authentication# Keep your API key secure and never share it publicly. If compromised, reset it immediately.
API Base URL# Quick Start Guide# Step 1: Generate Your First Music Track# Start with a simple music generation request: Step 2: Check Task Status# Use the returned task ID to check the generation status: {
"code" : 200 ,
"msg" : "success" ,
"data" : {
"taskId" : "5c79****be8e"
}
} {
"code" : 200 ,
"msg" : "success" ,
"data" : {
"taskId" : "5c79****be8e" ,
"status" : "SUCCESS" ,
"response" : {
"sunoData" : [
{
"id" : "e231****-****-****-****-****8cadc7dc" ,
"audioUrl" : "https://example.cn/****.mp3" ,
"streamAudioUrl" : "https://example.cn/****" ,
"imageUrl" : "https://example.cn/****.jpeg" ,
"prompt" : "A calm and relaxing piano track" ,
"title" : "Peaceful Piano" ,
"tags" : "calm, relaxing, piano" ,
"duration" : 198.44 ,
"createTime" : "2025-01-01 00:00:00"
}
]
}
}
} Core Features# Text-to-Music : Generate music from text descriptions with AI
Music Extension : Seamlessly extend existing audio tracks
Lyrics Generation : Create structured lyrical content from creative prompts
Audio Upload & Cover : Upload audio files and transform them into different musical styles
Add Instrumental : Generate instrumental accompaniment for uploaded audio files
Add Vocals : Add vocal singing to uploaded audio files with custom styles
Vocal Separation : Isolate vocals, instrumentals, and other audio components
Format Conversion : Support for WAV and other high-quality audio formats
Music Videos : Create visual content synchronized with your audio tracks
Audio Processing : Comprehensive tools for audio enhancement and manipulation
AI Models# Choose the right model for your needs:
V3_5
Better song structure Max 4 minutes, improved song organization
V4
Improved vocals Max 4 minutes, enhanced vocal quality
V4_5
Smart prompts Max 8 minutes, faster generation
V4_5PLUS
Richer sound Max 8 minutes, new creative ways
V4_5ALL
Smart and fast Max 8 minutes, smarter prompts, faster generations
V5
Faster generation Max 8 minutes, superior musicality, improved speed Generation Modes# Parameter Overview# Parameter Type Required Description customModeboolean Yes Controls parameter complexity: false (Simple Mode) or true (Advanced Mode) instrumentalboolean Yes Determines vocal presence: true (Instrumental only) or false (Includes lyrics)
Key Parameters# Parameter Type Required Description promptstring Yes Text description used to generate music stylestring No Music style instructions (Custom Mode only) titlestring No Title for the generated music (Custom Mode only)
Prompt Character Limits# Non-Custom Mode : 500 characters
Custom Mode (V3_5 & V4) : 3,000 characters
Custom Mode (V4_5, V4_5PLUS & V5) : 5,000 characters
Style Character Limits# V3_5 & V4 : 200 characters
V4_5, V4_5PLUS & V5 : 1,000 characters
Title Character Limit# Maximum Length : 80 characters
Complete Workflow Example# Here's a complete example that generates music with lyrics and waits for completion: Advanced Features# Boost Music Style (V4_5 Models)# Enhance your style descriptions for better results: Audio Processing Features# Convert, separate, and enhance your generated music: Async Processing with Callbacks# Set up webhook callbacks for automatic notifications:
Learn More About Callbacks
Complete guide to implementing and handling Suno API callbacks Status Codes & Task States# Status Description PENDINGTask is waiting to be processed or currently generating TEXT_SUCCESSLyrics/text generation completed successfully FIRST_SUCCESSFirst track generation completed SUCCESSAll tracks generated successfully CREATE_TASK_FAILEDFailed to create task GENERATE_AUDIO_FAILEDFailed to generate audio SENSITIVE_WORD_ERRORContent filtered due to sensitive words
Best Practices# Error Handling# Support# Our technical support team is here to assist you.
API Status : Check our status page for real-time API health
Ready to start creating amazing AI music? Get your API key and begin composing today! 