Suno API Quickstart
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
All API requests require authentication using a Bearer token. Get your API key from the API Key Management Page.API Base URL
Authentication Header
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:Response Format
Successful Response: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
customMode [boolean, required]
Controls parameter complexity:false: Simple mode, only prompt requiredtrue: Advanced mode, requires style and title
instrumental [boolean, required]
Determines if music includes vocals:true: Instrumental only (no lyrics)false: Include vocals/lyrics
Key Parameters
prompt [string, required]
Text description of the desired music. Be specific about genre, mood, and instruments. Character Limits:- Non-custom mode: 500 characters
- Custom mode (V3_5 & V4): 3000 characters
- Custom mode (V4_5, V4_5PLUS & V5): 5000 characters
style [string]
Music style specification (Custom Mode only). Examples: Jazz, Classical, Electronic, Pop, Rock, Hip-hop Character Limits:- V3_5 & V4: 200 characters
- V4_5, V4_5PLUS & V5: 1000 characters
title [string]
Title for the generated music track (Custom Mode only). Max length: 80 charactersComplete 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:Status Codes & Task States
PENDING
Processing. Task is waiting to be processed or currently generating.TEXT_SUCCESS
Partial. Lyrics/text generation completed successfully.FIRST_SUCCESS
Partial. First track generation completed.SUCCESS
Complete. All tracks generated successfully.CREATE_TASK_FAILED
Error. Failed to create task.GENERATE_AUDIO_FAILED
Error. Failed to generate audio.SENSITIVE_WORD_ERROR
Error. Content filtered due to sensitive words.Best Practices
- Prompt Engineering: Use detailed descriptions
- Model Selection: Choose V3_5 for structure, V4 for vocals, V5 for quality
- Performance Optimization: Use callbacks instead of polling
- Content Guidelines: Avoid prohibited content to prevent SENSITIVE_WORD_ERROR
Error Handling
- Content Policy Violations (Code 400)
- Insufficient Credits (Code 402)
- Rate Limiting (Code 429)
Support
Need help? Our technical support team is here to assist you.- Email: [email protected]
- Documentation: docs.apikley.ru
- 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!
Rate limits and quotas are enforced by Apikley and may differ from upstream providers.

