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

• Docs: https://docs.aimusicapi.ai/get-bgm

🔹 VOX Vocal Analysis API

/api/v1/sonic/vox

Extract deep vocal characteristics from any track.

• Supports: vocal_start_s, vocal_end_s

• Cost: 1 Credit

• Docs: https://docs.aimusicapi.ai/get-vox

🔹 Tag Upsampling API

/api/v1/sonic/upsample-tags

AI intelligently optimizes & refines music style tags for higher-quality generations.

• Cost: 1 Credit

• Docs: https://docs.aimusicapi.ai/upsample-tags

👤 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

• Docs: https://docs.aimusicapi.ai/create-sonic-persona

🎛️ 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 description

• Cost: 10 Credits

• Polling: async task (recommended 15–25s interval)

• Docs: https://docs.aimusicapi.ai/mashup

✂️ 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_s

• Provide:

  • Context lyrics (prompt)

  • New lyrics fragment (infill_lyrics)

• AI regenerates the section with smooth transitions

🔥 Auto Concat (Optional)

• Set auto_concat: true

• Automatically returns:

  • replaced → new fragment

  • full → fully concatenated song

• No manual concat calls needed

• Cost: 10 Credits

• Models: chirp-v4 → chirp-v5

• Docs: https://docs.aimusicapi.ai/replace-section

⚡ 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

• Extend: https://docs.aimusicapi.ai/upload-extend-music

• Cover: https://docs.aimusicapi.ai/upload-cover-music

📖 Documentation & Support

We’ve fully upgraded our documentation with clearer explanations and real-world request examples to ensure smoother integration.

👉 https://docs.aimusicapi.ai/

Happy Creating! 🎹