Suno API Docs: Generate Songs, Stems & Voice Clone

Updated 2026-10-23 · Suno-API team

Suno-API uses Suno's official V6 models to provide a plain HTTP API. One API key covers music generation, lyrics, cover songs, extend, stems, WAV export and voice clone; each generation costs 0.6 CNY and returns two tracks.

Start here: create an API key, call POST /api/music/create, poll POST /api/music/query until the song is completed, then request the final media URL. Generation costs 0.6 CNY and returns 2 tracks; task queries and downloads are not charged separately.

Start here

• Quick Start Guide
• Authentication
• Supported Models
• Suno API documentation overview
• Account balance query API
• Simple mode generation API
• Custom mode generation API
• Speech generation API
• Sound effects API
• Lyrics generation API
• Voice clone and generate-with-voice API (not recommended)
• 【Recommended】 Voice profile API
• Style boost API
• Prompt suggestions API
• Upload source audio API
• Enhanced upload API
• Upload-then-cover API
• Cover from a source clip API
• Extend API
• Get Full Song API (full-length stitching)
• Remaster API
• Replace Section API
• Add instrumental API
• Add vocal API
• Add stem API
• Mashup API
• Sample API
• Inspiration API
• Crop API
• Remove section API
• Fade in / out API
• Reverse API
• Speed API
• Separation (vocal & backing split) API
• Vocal removal API
• Stem delete API
• WAV generation/retrieval API
• MIDI retrieval API
• Song media download and preview API
• Free2 download API
• Song query and history API
• Timestamped lyrics API
• Music commercial licensing certificate API

Base URL and authentication

curl -X POST https://www.suno-api.io/api/music/create \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"description": "an upbeat pop song"}'