Suno AI API Documentation & Developer Guide
Build AI music experiences with the definitive Suno API. Integrate high-fidelity text-to-music generation, vocal synthesis, stem separation, lyrics alignment, and lossless audio workflows directly into your web, mobile, and game applications.
Quickstart: How to Get Your Suno API Key in 3 Minutes
Obtain Your Suno API Key
Register a free developer account and generate your private Bearer secret key from the API Keys Dashboard. Get 5 free credits instantly.
Submit a Generation Task
Send an HTTP POST request to /api/v1/createTask with your prompt, custom lyrics, and audio parameters.
Receive Master Audio
Suno synthesizes dual stereo tracks and automatically delivers download links to your designated callBackUrl webhook.
curl -X POST https://api.sunoapi.top/api/v1/createTask \
-H "Authorization: Bearer sk_live_your_suno_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"taskType": "generate_music",
"prompt": "An upbeat futuristic synthwave track with punchy drums and melodic leads",
"tags": "synthwave, electronic, retro, 80s",
"title": "Neon Horizon",
"customMode": true,
"instrumental": false,
"callBackUrl": "https://yourdomain.com/api/suno-webhook"
}'All API requests must include your Suno API secret key passed as a standard Bearer token in the HTTP Authorization header:
Authorization: Bearer sk_live_...
All API endpoints are served over HTTPS with global low-latency CDN edge termination:
https://sunoapi.top/api/v1
Complete Suno AI API Reference (38 Endpoints)
Browse every Suno API endpoint, webhook callback specification, parameter schema, and response code.
Music Generation
(9 endpoints)Generate Music
Generate complete dual-track AI music from text prompts, custom lyrics, and genre tags.
Generate Music Cover
Generate personalized cover art images based on an existing music generation task.
Extend Music
Continue and lengthen an existing song from a designated timestamp with style continuity.
Add Vocals to Music
Synthesize custom lyrical vocals on top of an existing backing instrumental track.
Add Instrumental to Music
Generate accompanying musical instruments and harmonies under acapella vocals.
Boost Music Style
Amplify genre characteristics, bass punch, vocal clarity, and arrangement dynamics.
Generate Mashup Music
Intelligently blend stems, vocals, and instruments from multiple songs with tempo alignment.
Replace Music Section
Target and regenerate a specific chorus, bridge, or verse without altering the rest of the song.
Upload and Cover Audio
Upload custom audio files (MP3/WAV) to produce AI covers and acoustic adaptations.
Voice & Persona
(5 endpoints)Generate Persona
Create a reusable singer identity and distinct vocal timbre across recurring music runs.
Custom Voice Cloning
Clone singing vocals from high-definition audio references to produce custom voice models.
Regenerate Voice Phrase
Regenerate the phrase recording verification protocol for an existing custom voice.
Check Voice Status
Query model readiness, voice validation status, and training metadata (No credits consumed).
Generate Validation Phrase
Create security validation phrase for speaker ownership verification.
Audio Processing & Stems
(4 endpoints)Stem Separation (Vocals & Instruments)
Isolate crystal-clear acapella vocals and independent backing instrumental audio stems.
Convert Audio to WAV
Lossless audio decompression from MP3 to broadcast-standard uncompressed WAV PCM format.
Recovery Audio Records
Retrieve and re-generate signed CDN media URLs for historic music generation tasks.
Generate Sound Effects (SFX)
Synthesize custom gaming, cinematic, foley, and interface sound effects from text prompts.
Lyrics & MIDI
(3 endpoints)Generate Structured Lyrics
Generate verse-chorus-bridge song lyrics tailored to requested topic, genre, and emotional mood.
Timestamped Lyrics Alignment
Extract millisecond-level word & sentence timestamps for synchronized karaoke and subtitles.
Generate MIDI from Audio
Transcribe musical notes, pitches, and rhythm into multi-track standard MIDI (.mid) files.
Video Generation
(1 endpoints)Callbacks & Webhooks
(16 endpoints)Webhook Security Verification
Verify HMAC-SHA256 signatures, timestamps, and webhook payloads for secure callback handling.
Generate Music Webhook
Real-time asynchronous notification when dual-track music generation completes.
Music Cover Art Webhook
Webhook dispatch with generated high-resolution album cover artwork image URLs.
Extend Music Webhook
Webhook notification delivering extended song files with appended timestamps.
Add Vocals Webhook
Asynchronous event dispatched once synthetic vocal tracks are mixed and ready.
Add Instrumental Webhook
Webhook payload with completed instrumental accompaniment and stem links.
Replace Section Webhook
Notification triggered when the regenerated song section has been inserted seamlessly.
Upload & Cover Webhook
Webhook dispatched when uploaded audio file has been transformed into AI cover version.
Upload & Extend Webhook
Webhook payload returning extended audio file built upon user-uploaded sound source.
Custom Voice Generation Webhook
Dispatches custom voice identifier ID once acoustic model training completes.
Voice Validation Phrase Webhook
Returns generated verification phrase script and sample validation checklist.
Stem Separation Webhook
Dispatches isolated stems (vocals, instruments, bass) download links upon completion.
Convert to WAV Webhook
Webhook delivery with signed high-resolution lossless WAV audio file URL.
Lyrics Generation Webhook
Webhook payload with formatted song lyrics, verses, chorus, and style tags.
Generate MIDI Webhook
Webhook delivery with polyphonic multi-track MIDI note events and instrument channels.
Music Video Generation Webhook
Webhook dispatched with final 1080p MP4 music video URL and duration metadata.
Frequently Asked Questions About Suno AI API
Clear, definitive answers for developers searching for Suno API access, integration keys, and capabilities.
Q1.Does Suno AI Have an API for Developers?
While Suno.com does not offer an open self-serve public developer API directly on their consumer site, sunoapi.top provides a production-grade, high-availability Suno AI API. Developers can programmatically generate songs, separate stems, clone voices, align lyrics, and transcribe MIDI through standard RESTful endpoints and real-time Webhooks.
Q2.How Do I Obtain a Suno API Key?
Getting your Suno API key takes less than 60 seconds: 1. Create a free account on sunoapi.top. 2. Navigate to Dashboard > API Keys. 3. Click "Generate Secret Key". Every new account receives 5 free credits instantly to test music generation in our interactive playground or directly via cURL/SDK.
Q3.What Capabilities and Models Are Supported?
The Suno API supports the latest Chirp v4, v3.5, and v3 audio models across 38 endpoints. Core capabilities include: dual-track music generation (up to 4 minutes), song extension, add vocals to backing tracks, add instrumental accompaniment to acapella, section in-painting, 2-stem and 12-stem separation, lossless WAV conversion, structured lyrics generation, polyphonic MIDI transcription, and 1080p MP4 music video rendering.
Q4.What Are the Pricing and Credit Costs?
The API uses transparent pay-as-you-go credit billing. Music generation starts at 30 credits per dual-track song (~$0.024/track), stem separation is 200 credits, and all asynchronous Webhook callbacks are 100% free (0 credits). Volume discounts and enterprise tiers are available in the billing dashboard.
Q5.How Do Asynchronous Webhooks Work?
Because generating high-fidelity music takes 20-50 seconds, requests to POST /api/v1/createTask return immediately with a task_id. You provide a callBackUrl parameter, and our cloud cluster posts a JSON payload with your master MP3/WAV links once synthesis completes. All callbacks include automatic retries and HMAC signature verification.
Ready to test Suno AI API in your project?
Generate your private secret key and receive 5 free credits immediately.