January 25th, 2026
We’ve launched several new specialized APIs and powerful music-editing capabilities to help you build faster, save credits, and unlock advanced creative workflows.
🚀 New Analysis & Optimization APIs
🔹 BPM Detection API
/api/v1/sonic/bpm
Analyze audio tempo and get Average / Max / Min BPM.
Cost: 1 Credit
🔹 VOX Vocal Analysis API
/api/v1/sonic/vox
Extract deep vocal characteristics from any track.
Supports:
vocal_start_s,vocal_end_sCost: 1 Credit
🔹 Tag Upsampling API
/api/v1/sonic/upsample-tags
AI intelligently optimizes & refines music style tags for higher-quality generations.
Cost: 1 Credit
👤 Persona API Enhancements
Added 5 new customizable parameters for deeper vocal & style control:
describe
styles
vox_audio_id
vocal_start_s
vocal_end_s
Cost: 1 Credit
🎛️ New Creative Editing APIs
🔀 Mashup API — Mix Two Songs into One
/api/v1/sonic/mashup
Create a brand-new song by blending two existing clips into a unique mashup.
Key Highlights
Mix exactly 2 clip IDs into one new song
Supports custom lyrics or AI-generated lyrics
Full control over style, vocals, creativity & instrumentation
Compatible with sonic- and chirp- models**
Modes
Custom Mode (
custom_mode: true)
→ You provide exact lyrics (full control)AI Description Mode (
custom_mode: false)
→ AI generates lyrics from a short descriptionCost: 10 Credits
Polling: async task (recommended 15–25s interval)
✂️ Replace Section API — Edit Lyrics In-Place
/api/v1/sonic/replace-section
Replace a specific time-range + lyrics section inside an existing song and regenerate music with proper context awareness.
Perfect for
Fixing verses or choruses
Iterating lyrics without regenerating the full song
Professional editing & refinement workflows
How It Works
Define the time range:
infill_start_s→infill_end_sProvide:
Context lyrics (
prompt)New lyrics fragment (
infill_lyrics)
AI regenerates the section with smooth transitions
🔥 Auto Concat (Optional)
Set
auto_concat: trueAutomatically returns:
replaced→ new fragmentfull→ fully concatenated song
No manual concat calls needed
Cost: 10 Credits
Models: chirp-v4 → chirp-v5
⚡ All-in-One “POWER” APIs (Save Credits!)
Skip manual steps and simplify complex workflows:
upload-extend → Upload + Extend + Concat
upload-cover → Upload + Cover generation
auto_concat → Automatic audio merging
💰 Efficiency
Only 10 Credits total
Save 4 Credits vs separate calls
📘 Docs
📖 Documentation & Support
We’ve fully upgraded our documentation with clearer explanations and real-world request examples to ensure smoother integration.
Happy Creating! 🎹
December 16th, 2025
✅ New Suno “Get Lyrics Timeline” endpoint Fetch the timestamped lyrics timeline by clip ID — perfect for karaoke-style / scrolling lyrics.
Billing: the first request costs 1 credit, and subsequent requests are free for the same clip.
https://docs.aimusicapi.ai/get-suno-lyrics-timeline
🎤 Persona IDs are now permanent Newly created persona IDs can be reused forever.
You can create a persona from an existing song or by uploading your own recording, then generate unlimited songs with the same virtual singer.
November 10th, 2025
🎵 New Features Just Dropped! Take your music to the next level with 3 powerful new generation capabilities — now live on our platform:
🔁 1. Remaster (task_type = remaster)
Transform any existing track using our latest AI models:
Supported Models: chirp-v4, chirp-v4-5-plus, chirp-v5
Perfect for: A/B testing different styles, improving fidelity, or refreshing old tracks.
🎹 2. Add Instrumental (task_type = add_instrumental)
Enhance your uploaded audio with rich instrumental backing:
Upload a vocal or dry mix → get AI-generated instrumentals layered in
Optional: Provide lyrics to influence style and progression
🎤 3. Add Vocals (task_type = add_vocals)
Bring your lyrics to life with professional-quality AI vocals:
Input your instrumental track + lyrics
The model generates a polished vocal performance, synced and stylized
💰 Cost: 10 credits per generation ⚙️ Supported Models:
chirp-v4-5-plus, chirp-v5 (for all 3 features)
chirp-v4 additionally supported for Remaster
📚 Full Documentation:
https://docs.aimusicapi.ai/suno-api-instructions
https://docs.aimusicapi.ai/remaster-suno-music
https://docs.aimusicapi.ai/add-vocal-suno
https://docs.aimusicapi.ai/add-instrumental-suno
🚀 Ready to create? These new tools are now live — give them a try and push your sound further than ever!
October 24th, 2025
Persona API Fixed, You can now retrieve the persona_id from any clip_id created on our platform, and then use that persona_id to generate new songs.
📄 Docs:
https://docs.sunoapi.com/create-suno-persona
https://docs.sunoapi.com/create-suno-persona-music
New MIDI API Available You can now fetch full MIDI JSON data and a processed .mid file URL for any generated clip_id. Great for preview or reference use.
📄 Docs:
https://docs.sunoapi.com/get-midi
Both features require 2 credits per request.
October 12th, 2025
✅ Webhook Support is now LIVE
You can now add webhook_url and webhook_secret to your API requests to automatically receive results when generation completes. Perfect for async pipelines or product integrations.
🎧 FUZZ-2.0 Pro is Here!
Producer API now supports FUZZ-2.0 Pro, delivering audio quality comparable to Suno v5, with improved vocal coherence and scene consistency.
📚 Full docs: https://docs.sunoapi.com/webhook-guide
💬 Let us know how you’re using it — excited to see what you build!
October 2nd, 2025
We've officially launched support for the Producer AI model (FUZZ‑2.0) as an upgrade to Riffusion.
🔧 What's new:
✅ New endpoint:
/api/v1/producer✅ Returns 1 song per request (instead of 2)
✅ Supports new fields & extended parameters
✅ No watermark issue (unlike old Riffusion)
✅ Compatible with all standard
lyrics,sound,weirdnessinputs
The old Riffusion API is still live, but it will no longer be updated and still includes watermarks. We strongly recommend switching to the new Producer API for better audio quality and long-term support.
September 24th, 2025
You can now generate music using the latest Suno v5 model via SunoAPI.
Just set the following parameter in your request:
mv=chirp-v5 🆕 What’s new in Suno v5?
🎤 Authentic vocals
🎧 Superior audio quality
🎚️ More control and flexibility
👉 Feel free to test it out on our docs site:
https://docs.sunoapi.com
September 15th, 2025
We’ve released two powerful new features:
1. Vocal Gender Control Control AI singer’s voice:
vocal_gender: "f" (female) or "m" (male)
Docs → https://docs.sunoapi.com/music-voice-gender
2. Auto Lyrics & Style from Prompt Let AI generate lyrics & genre from your description:
auto_lyrics: true (requires custom_mode: true)
August 23rd, 2025
Generate BGM directly from text prompts
Control music structure
Duration extended: 30–120s
August 11th, 2025
🆕 Stems API (Basic & Full)
Stems Basic: Splits generated songs into 2 tracks — vocals and instruments
→ 10 credits per requestStems Full: Splits into 12 detailed tracks — individual vocals and instrument layers
→ 50 credits per request
🆕 Get WAV API
Retrieve high-quality WAV URLs of generated songs
More detail, better fidelity — ideal for professional use
→ 2 credits per request
💡 Changes & Optimizations
⬇️ Concat API Cost Reduced
The credit cost has been lowered from 10 → 2 credits per request
🔧 Updated Field Limits
prompt(lyrics, required in custom mode)v4.5+ / v4.5-plus: up to 5000 characters
v4 and below: up to 3000 characters
tags(style/genre, optional)v4.5+ / v4.5-plus: up to 1000 characters
v4 and below: up to 200 characters
📚 View full API documentation: https://docs.sunoapi.com