docs.sunoapi.org
language
language
  • 🇺🇸 English
  • 🇨🇳 Chinese
language
language
  • 🇺🇸 English
  • 🇨🇳 Chinese
Support
Suno API
Common APIFile Upload API
Suno API
Common APIFile Upload API
  1. Suno API
  • Suno API Documentation
  • Suno API Quick Start
  • Generate Music
    • Music Generation Callbacks
    • Music Extension Callbacks
    • Upload and Cover Audio Callbacks
    • Upload and Extend Audio Callbacks
    • Add Instrumental Callbacks
    • Add Vocals Callbacks
    • Music Cover Generation Callbacks
    • Replace Music Section Callbacks
    • Generate Music
      POST
    • Extend Music
      POST
    • Upload And Cover Audio
      POST
    • Upload And Extend Audio
      POST
    • Add Instrumental
      POST
    • Add Vocals
      POST
    • Get Music Generation Details
      GET
    • Recovery Audio
      POST
    • Get Recovery Audio Details
      GET
    • Get Timestamped Lyrics
      POST
    • Boost Music Style
      POST
    • Generate Music Cover
      POST
    • Replace Music Section
      POST
    • Get Music Cover Details
      GET
    • Generate Persona
      POST
    • Generate Mashup
      POST
  • Suno Voice
    • Suno Voice Validation Phrase Callbacks
    • Suno Voice Generation Callbacks
    • Suno Voice Regenerate Phrase Callbacks
    • Suno Voice Generate Verification Phrase
      POST
    • Suno Voice Get Verification Phrase
      GET
    • Suno Voice Create Custom Voice
      POST
    • Suno Voice Get Custom Voice Record
      GET
    • Suno Voice Regenerate Verification Phrase
      POST
    • Suno Voice Check Availability
      POST
  • Generate Lyrics
    • Lyrics Generation Callbacks
    • Generate Lyrics
    • Get Lyrics Generation Details
  • Generate Sounds
    • Generate Sounds
  • WAV Conversion
    • WAV Format Conversion Callbacks
    • Convert to WAV Format
    • Get WAV Conversion Details
  • Vocal Removal
    • Audio Separation Callbacks
    • MIDI Generation Callbacks
    • Vocal & Instrument Stem Separation
    • Get Audio Separation Details
    • Generate MIDI from Audio
    • Get MIDI Generation Details
  • Music Video Generation
    • Music Video Generation Callbacks
    • Create Music Video
    • Get Music Video Details
  1. Suno API

Suno API Documentation

Complete Suno API documentation - Your gateway to affordable and stable AI music API services

Welcome to Suno API Documentation#

This documentation provides comprehensive guides and references for integrating Suno API, a platform offering affordable and stable AI music API services that seamlessly integrate into your projects.

About Suno API#

Suno API delivers advanced AI music capabilities through easy-to-integrate APIs, including music generation, lyrics creation, audio processing, and video production. Our platform is designed for developers and businesses who need:
99.9% Uptime - Reliable and stable API performance
Affordable Pricing - Transparent, usage-based pricing system
20-Second Streaming Output - Fast delivery with streaming response
High Concurrency - Scalable solutions that grow with your needs
24/7 Support - Professional technical assistance
Watermark-Free - Commercial-ready music generation

Quick Start Guides#

Get started quickly with our comprehensive API quick start guides:

🎵 Music Generation APIs#

Generate Music
Create high-quality music from text descriptions using advanced AI models with support for various styles and genres.
Extend Music
Extend existing music tracks with AI-powered continuation, maintaining musical coherence and style.
Upload and Cover Audio
Transform existing audio with new styles and arrangements using AI music processing.
Upload and Extend Audio
Upload your own audio files and extend them with AI-generated content.
Add Vocals
Generate vocal tracks for instrumental music using advanced AI models.
Add Instrumental
Create instrumental accompaniment for vocal tracks with AI-powered arrangements.
Cover Music
Reinterpret existing music in different styles and arrangements using AI technology.

✍️ Lyrics Creation APIs#

Generate Lyrics
Create AI-powered lyrics for your songs with customizable themes and styles.
Get Timestamped Lyrics
Retrieve lyrics with precise timestamps for synchronization with audio tracks.

🔊 Audio Processing APIs#

Separate Vocals from Music
Extract vocals and instrumental tracks separately using advanced AI audio separation.
Convert to WAV Format
Convert generated music to high-quality WAV format for professional use.
Boost Music Style
Enhance and refine music styles with AI-powered audio processing.

🎬 Music Video APIs#

Create Music Video
Generate visual music videos from audio tracks using AI video generation technology.

🛠️ Utility APIs#

Get Music Generation Details
Monitor and retrieve detailed information about your music generation tasks.
Get Remaining Credits
Check your account credit balance and usage statistics.
Get Lyrics Generation Details
Track the status and details of your lyrics generation requests.
Get WAV Conversion Details
Monitor WAV format conversion tasks and download status.
Get Vocal Separation Details
Check the progress of vocal separation tasks and access separated audio files.
Get Music Video Details
Track music video generation progress and retrieve download links.
Get Cover Details
Monitor the status of music cover tasks and get cover results.

Documentation Features#

Interactive Examples - Test APIs directly in our documentation
Code Samples - Ready-to-use examples in multiple programming languages
Comprehensive Guides - Step-by-step integration instructions
API Reference - Complete parameter documentation and response schemas
Best Practices - Optimization tips and common use cases
Callback Documentation - Webhook integration guides for all endpoints

Key Features#

🚀 Latest AI Music Models#

We provide APIs for the latest AI music models, including Suno V5_5, V5, V4.5 Plus, V4.5 All, V4.5, and V4, offering high-quality music generation. Supports creation of both vocal and instrumental tracks, music extension, and multi-format downloads.

💎 Watermark-Free Commercial Use#

All music generated through our API is watermark-free, making it immediately suitable for commercial projects. This removes the need for additional fees, enabling creators and developers to effortlessly integrate high-quality tracks into their workflows.

⚡ 20-Second Streaming Output#

We ensure rapid delivery with streaming output, enabling developers to integrate AI-generated music seamlessly into their workflows without delays. This feature supports real-time applications and live content creation.

🏗️ High-Concurrency Architecture#

Our API is built to handle multiple simultaneous requests, ensuring reliable performance even under heavy traffic. This makes it ideal for large-scale applications and high-demand platforms.

💰 Transparent and Affordable Pricing#

We offer cost-effective and transparent pricing plans, making it accessible to creators and enterprises. Our transparent, usage-based model ensures predictable costs.

🔧 Comprehensive Developer Support#

We streamline integration with detailed, developer-friendly API documentation, ensuring a hassle-free implementation process. Supported by an experienced technical team.

Getting Started#

1.
Sign Up - Create your free account at Suno API
2.
Get API Key - Obtain your authentication credentials from the API Key Management Page
3.
Choose Your API - Select from our comprehensive API collection
4.
Follow Quick Start - Use our Quick Start Guide for rapid integration
5.
Test & Deploy - Verify your integration and go live

AI Model Versions#

Choose the right model for your needs:

V4 - Improved Vocals#

Enhanced vocal quality and refined audio processing, up to 4 minutes. Ideal choice when vocal clarity is paramount.

V4_5 - Smart Prompts#

Excellent prompt understanding with faster generation speeds, up to 8 minutes. Our advanced model for complex music requests.

V4_5PLUS - Richer Tones#

Most advanced model with enhanced tonal variation and new creative approaches, up to 8 minutes. Best choice for highest quality and longest tracks.

V4_5ALL - Better Song Structure#

V4.5-all is better song structure, max 8 min. Perfect for well-structured musical pieces.

V5 - Latest Model#

Cutting-edge model with enhanced quality and capabilities. Our newest offering for advanced music generation.

V5_5 - Voice-Customized Model#

Unleash Your Voice: Custom Models Tailored to Your Unique Taste.

Use Cases#

🎮 Game Developers#

Generate dynamic background music, sound effects, and adaptive audio for gaming experiences using our music generation and extension APIs.

🎬 Content Creators#

Create royalty-free music for videos, podcasts, and social media content with our watermark-free output, enjoying unlimited commercial use rights.

🏢 Businesses#

Integrate AI music generation into apps, websites, and services using our high-concurrency API to enhance user experiences.

🎭 Music Producers#

Prototype songs, generate ideas, and create full compositions with professional-quality output. Use vocal separation for remixing and audio processing.

🎤 Karaoke & Entertainment#

Leverage timestamped lyrics and vocal separation features for karaoke applications and interactive music experiences.

Support & Community#

24/7 Support - Contact our technical team anytime
Email Support - support@sunoapi.org
Documentation Updates - Regular improvements and new features
API Status - Monitor real-time service status
Developer Resources - Comprehensive guides and best practices

Callback Integration#

All major endpoints support webhook callbacks for real-time notifications:
Music Generation Callbacks
Lyrics Generation Callbacks
Music Extension Callbacks
Audio Processing Callbacks
Music Video Callbacks
WAV Conversion Callbacks
Cover Callbacks
Upload and Cover Callbacks
Upload and Extend Callbacks
Add Vocals Callbacks
Add Instrumental Callbacks

API Base URL#

All API requests should be sent to:
https://api.sunoapi.org

Authentication#

All API requests require authentication using a Bearer token:
Obtain your API key from the API Key Management Page.
Ready to get started? Choose an API above and follow the quick start guide to begin integrating powerful AI music capabilities into your projects. Visit Suno API to create your account and start generating amazing music today!
Next
Suno API Quick Start
Built with