Suno API:
Generate AI Music
Integrate Suno AI music generation capabilities into your application through a stable, comprehensive REST API. Create custom songs, instrumentals, remixes, covers, and more—all through a unified interface.
Does Suno Have an Official API?
Suno currently does not provide a public, self-service REST API. Its music generation features can only be accessed through the Suno website and app.
Ace Data Cloud fills this gap by providing a stable, production-ready API that gives you complete programmatic access to all of Suno's music generation capabilities—including the current Chirp v6 model family—through a clean REST interface, with an OpenAPI specification, Webhook support, streaming, and pay-as-you-go pricing.
All Suno API Features
A comprehensive API suite covering the complete Suno music generation workflow
Complete Music Generation
Generate complete songs with lyrics, vocals, and instruments from text prompts, or create instrumental music. Supports inspiration mode and custom mode for fine-grained control.
Unified Actions, One API
Generate, Extend, Cover, Mashup, Stems, Add Stem, Extract Stem, Sounds, Adjust Speed, Remaster, Underpaint, Overpaint, Replace Section, and more—all through the /suno/audios endpoint.
Pay per use: Add Stem 0.672 Credits (1.344 in enhanced mode), Extract Stem 1.12, generate sounds 0.112, adjust speed 0.28; enhanced song generation mode is 1.12 Credits.
Custom Personas
Create and save custom singer voice styles with the Persona API. Reuse a consistent vocal identity across unlimited song generations.
AI Lyric Generation
Automatically generate structured lyrics with section markers (verse, chorus, bridge) using two AI models. Also supports mashup lyrics, combining the lyrics of two songs.
Multiple Output Formats
Supports output in MP3 (default), MP3 URL (generate playable links for existing audio, 0.04 Credits each), MP4 (video with visualization), WAV (lossless audio), and MIDI (music notation) formats. Vocal separation can extract vocals, drums, bass, and more.
Streaming and Webhooks
Supports real-time NDJSON streaming for progress updates, or set callback_url to receive results asynchronously. No polling required.
Enhanced Audio Upload
Use mode=enhanced with /suno/upload to import authorized audio that regular uploads may not support, then use the audio ID for subsequent creations such as Cover, Samples, and Mashup.
Studio Multitrack Projects
Create, read, and save multitrack projects with /suno/projects, generate or replace track candidates, and export a specified project version as a complete song.
curl -X POST https://api.acedata.cloud/suno/audios \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"action": "generate",
"prompt": "An upbeat pop song about a summer road trip",
"model": "chirp-v4",
"custom": false,
"callback_url": "https://your-app.com/webhook"
}'
{
"success": true,
"task_id": "b3d7a1...",
"data": [{
"id": "a8f2c9...",
"title": "Summer Highway",
"style": "cheerful pop, driving beat",
"duration": 124.5,
"audio_url": "https://cdn.acedata.cloud/assets/examples/fish/5ade0339-5f11-487e-aacc-06a908271706-8e3fcb0e5547.mp3",
"image_url": "https://cdn.acedata.cloud/e724d7f13d.png",
"video_url": "https://cdn.acedata.cloud/assets/examples/gemini/04a043bd-6b23-4b4e-945c-ce48158c3eee-3a89912507c7.mp4",
"state": "succeeded"
}]
}
Quick Start—Get Up and Running in 5 Minutes
A simple REST API with Bearer Token authentication. Generate your first AI song with a single request.
Get Your API Key
Sign up for Ace Data Cloud and get your Bearer Token from the console
Send a POST Request
Send a request to /suno/audios with your prompt and model preferences
Get Your Song
Receive the audio URL, cover image, lyrics, and video—ready to use instantly
Complete music workflow, one API
The most comprehensive Suno API—covering every music creation workflow
Generate
Create songs from text prompts in inspired or custom mode
Extend
Continue a song from any timestamp, adding new lyrics and styles
Cover
Create a new version of any song in a completely different style
Concat
Merge extended segments into one seamless complete track
Stems
Separate vocals, drums, bass, melodies, and other tracks
Remaster
Upgrade old songs with improved audio quality (v4.5+ / v5)
Underpaint
Add instrumental accompaniment to uploaded vocal tracks
Overpaint
Add AI vocals to uploaded instrumental tracks
Replace Section
Regenerate content within a specified time range of an existing song
Mashup
Blend two reference songs into a new creation
Upload + Extend
Upload your own audio and extend it with AI generation
Persona
Maintain a consistent singer identity across multiple songs
What can you build with the Suno API?
From consumer apps to enterprise platforms—developers are building these projects
Music Creation Apps
Build consumer apps that let users generate custom songs, share, and collaborate
Video & Content
Automatically generate royalty-free background music for videos, short clips, and podcasts
AI Agents & MCP
Integrate with Claude, ChatGPT, or any AI Agent through our MCP Server for natural-language music creation
E-commerce & Advertising
Generate branded music, advertising music, and product audio content in bulk
Get Started in 3 Steps
From sign-up to generating your first AI song in under 5 minutes
Sign Up and Get an API Key
Create a free account on Ace Data Cloud. Generate your Bearer Token from the API management console.
Make Your First API Call
Send a POST request with a text prompt to /suno/audios. Use the SDK, cURL, or any HTTP client.
Integrate and Scale
Embed the API into your app. Use Webhooks for asynchronous processing and scale to production with confidence.
Why Choose Ace Data Cloud Over Other Suno APIs?
See our competitive advantages in the features developers care about most
| Feature | Ace Data Cloud | Other Platforms |
|---|---|---|
| Chirp v5 Model | ✓ | Partially Supported |
| Unified Actions (Extend, Cover, Stems, etc.) | ✓ | Partially Supported |
| OpenAPI 3.0 Specification | ✓ | Partially Supported |
| Webhook Callbacks | ✓ | Partially Supported |
| NDJSON Streaming | ✓ | Partially Supported |
| Custom Persona | ✓ | Partially Supported |
| MP3 + MP3 URL + MP4 + WAV + MIDI | ✓ | Partially Supported |
| MCP Server (AI Agent Integration) | ✓ | Partially Supported |
| Pay As You Go | ✓ | Partially Supported |
| No Watermark | ✓ | Partially Supported |
Comparison of Suno and Other AI Models
Trying to decide between Suno, Udio, and other AI music platforms? See how they compare.
| Capability | Suno (via Ace Data) | Udio | Others |
|---|---|---|---|
| Songs with vocals | ✓ | ✓ | ✗ |
| Custom lyrics | ✓ | ✓ | ✗ |
| Instrumental music | ✓ | ✓ | ✓ |
| Song continuation and remixing | ✓ | ✓ | ✗ |
| Vocal separation | ✓ | ✗ | ✗ |
| Persona voice cloning | ✓ | ✗ | ✗ |
| API access | ✓ | ✗ | Limited |
Which model is right for you?
Choose from 6 Suno model versions based on your quality and speed needs
Chirp v3.0 / v3.5
LegacySuitable for basic music generation. Fastest speed and best value, ideal for prototyping and background music.
- ✓ Fastest generation speed
- ✓ Lowest cost (as low as $0.045/call)
- ✓ Reliable and stable for simple tasks
- ✓ Suitable for batch processing
Chirp v4 / v4.5
ProductionThe best balance of quality and cost, suitable for production-grade applications. Improved vocal, instrument, and mixing quality.
- ✓ Studio-quality output
- ✓ Clearer vocals and expressiveness
- ✓ Enhanced instrument separation
- ✓ Supports remastering (v4.5+)
- ✓ Custom voice Persona
Chirp v5
LatestSuno's latest and most advanced model, with the highest-fidelity audio and most natural vocals.
- ✓ Highest audio quality
- ✓ Most natural vocal expression
- ✓ Variation control (high/normal/subtle)
- ✓ All advanced features
- ✓ Best for flagship products
Suno API Pricing
Transparent pay-as-you-go pricing. No subscription fees. No hidden costs. Pay only for what you use.
Up to 27% off volume packages
Core music generation—2 songs generated per call
- ✓ v3.0 / v3.5: as low as $0.045 / call
- ✓ v4 / v4.5 / v5: as low as $0.052 / call
- ✓ Extend, Cover, Remix, Mashup
- ✓ Stems, Remaster, segment sampling, and Inspo inspiration features
- ✓ Underpaint & Overpaint
- ✓ Webhook + streaming
- ✓ Task polling—free
Volume discounts for high-usage teams
- ✓ Usage-based discounts
- ✓ Priority support
- ✓ Dedicated account manager
- ✓ Custom rate limits
- ✓ SLA guarantee
Frequently Asked Questions
Everything you need to know about using the Suno API
Does Suno have an official API? ▾
Suno currently does not provide a public, self-service REST API. Ace Data Cloud provides stable, production-ready APIs that give you full access to all of Suno's music generation capabilities, including the current Chirp v6 model family.
How does pricing work? ▾
We use a pay-as-you-go model, with no subscription or monthly fees. Each API call has transparent per-operation pricing—for example, song generation starts at $0.052 and lyrics start at $0.002. Volume packages offer discounts of up to 27%. You can top up at any time. Task polling is always free.
Which models are supported? ▾
Currently supported models include Chirp v6, v6-wild, v6-mini, and compatible models. Each model has its own focus in generation speed, experimentation, and style adherence; refer to the API parameter enumeration for specific available values.
How should I handle longer generation times? ▾
Three options: (1) Use callback_url—set a Webhook URL, and we will POST the result when complete. (2) Use NDJSON streaming—set the Accept: application/x-ndjson request header to receive real-time progress. (3) Poll via /suno/tasks—this endpoint is free and lets you check the status at any time.
Is the output watermarked? ▾
No. All audio outputs are clean and watermark-free. Generated MP3, MP3 URL, WAV, MP4, and MIDI files can be used directly in production environments.
Can it be used with AI Agents such as Claude or ChatGPT? ▾
Yes! We provide an official MCP Server (mcp-suno, available on PyPI) that integrates directly with Claude Desktop, VS Code, and other MCP-compatible AI tools. Your AI Agent can generate music through natural-language conversations. We also provide a standard REST API + OpenAPI specification to support any other integration method.
What is "Persona"? How do I use it? ▾
A Persona is a saved singer vocal style. Upload a reference song via /suno/upload, then create a Persona via /suno/persona. Once created, you can reference the persona_id in any generation request to maintain a consistent vocal identity across multiple songs.
Which output formats are supported? ▾
Six outputs: MP3 (default, included in every response), MP3 URL (generates a playable link for existing audio, via /suno/mp3), MP4 (video with waveform visualization, via /suno/mp4), WAV (lossless audio, via /suno/wav), MIDI (musical notation, via /suno/midi), and separated tracks (vocals, drums, bass, etc., via the stems operation).
Other AI Models
Explore our complete suite of AI APIs, covering images, video, search, and more
Flux API
Black Forest Labs' top-tier text-to-image model
Luma API
Create AI-generated videos using Dream Machine and Ray models
Veo API
Google's Veo video generation—cinematic-quality AI video
Claude API
Anthropic's Claude—powerful reasoning and coding capabilities through an OpenAI-compatible proxy
Start Generating AI Music Now
Join thousands of developers building with the most comprehensive Suno API. Pay as you go—no subscription fees, no commitments.