Suno Music Generation API

MP3 export

Use POST /suno/mp3 with the completed song's audio_id. Set async=true to receive a task ID and poll /suno/tasks; use the final returned audio_url. See the MP3 integration guide.

Suno AI music and lyrics generation service.

API home page: Ace Data Cloud - Suno Music Generation

Keywords: suno-api, ai-music, music-generation, lyrics-generation, rest-api, ai-api, aiaudio, AI API, REST API, Developer API, Ace Data Cloud

Why Use Suno Music Generation on Ace Data Cloud

Unified developer platform with one API key, billing system, and usage tracking
Production-ready AI API endpoints served from https://api.acedata.cloud
English integration guides, API references, and service documentation
Global-ready workflow for developers building chat, image, video, music, and search products

Custom Models (Beta)

Create a reusable music model from 6–24 authorized audio files, query its status, and generate new tracks through POST /suno/custom-models. See the custom models integration guide.

Studio Projects (Beta)

Use POST /suno/projects to manage versioned multitrack projects. The public API reference and integration guide contain the complete schema and recorded examples.

Send Authorization: Bearer YOUR_API_KEY, Content-Type: application/json, and an Idempotency-Key of 1–128 characters for every action except retrieve. Use a new key for each new operation. The same key and request replay the original success or failure without regenerating; changing the request under the same key returns 409. If submission times out, query the original task or replay with the same key before considering a new paid operation.

Project workflow

Action	Required inputs beyond `action`	Result and next step
`create`	`title` (1–200 characters)	Synchronous; retain `data.id` as the project ID.
`retrieve`	`id`	Synchronous; read the latest `data.version_id` and complete `data.state`.
`save`	`id`, complete `state`, latest `version_id`	Synchronous even if a `task_id` is returned; use the new version. Only the first save of an empty project may omit `version_id`.
`upload`	`id`, `version_id`, public HTTPS `audio_url`	Async; read `response.data.candidate.audio_id` from the completed task.
`add_track`	`id`, `version_id`, completed `audio_id`	Async; add the source audio and retain the new version.
`render`	`id`, `version_id`, `title`	Async; read `response.data.audio_id` and `audio_url` for the mix.
`generate_track`	`id`, `version_id`, `source_audio_id`, `render_audio_id`, `model`, `start_seconds`, `end_seconds`, `stem_control_tags`	Async; produces candidates without changing the project. Save an empty target track before generating.
`replace_section`	`id`, `version_id`, `source_audio_id`, `model`, `start_seconds`, `end_seconds`	Async; produces replacement candidates without changing the project; no render reference required.
`commit_candidate`	`id`, `version_id`, `operation_id`, `candidate_id`, `track_id`	Async; submit a selected candidate and retain the new version.
`remove_track`	`id`, `version_id`, `track_id`	Synchronous; retain the new version.

For async actions, async=false does not make them synchronous. Poll POST /suno/tasks with {"action":"retrieve","id":"TASK_ID"}, or set callback_url. A task ID means accepted, not successful: wait for finished_at and check response.success; failures are in response.error. See the task result guide.

save replaces the entire state, not a partial patch. Retrieve it first, edit only the intended fields, and preserve unknown fields. Save a uniquely identified audio track with type:"audio" and clips:[] before generating a new-track candidate, because candidates are tied to that saved version. Do not create the target track after generation. Read operation_id and candidates[].id from the completed generation task, and track_id from the project's state.tracks[].id; none of these is the project ID or the new submission's task ID.

Timing and optional controls

start_seconds / end_seconds select a range in the source audio, with 0 ≤ start_seconds < end_seconds. Replacement must not extend past the source duration. The selected range does not guarantee candidate output length.
start_beats / end_beats are project timeline beats. state.timing.bps is positive beats per second, default 2. Clip fields startBeats, endBeats, and readStartBeats also use project beats. Adding 41 seconds at beat 0 gives a default end of beat 82 at 2 bps.
add_track accepts name, color (default #7251F7), title, start_beats (default 0), end_beats, and nonnegative gain (default 1). The default end is start plus audio duration times bps.
Generation and replacement accept title, tags, and negative_tags. generate_track additionally accepts prompt, batch_size (1–4, default 2), instrumental (default true), and vocal_gender (f, m, or unspecified, default unspecified). stem_control_tags is a description such as add Piano, not an enum.
For replacement, prompt supplies source lyrics or context, while replacement_lyrics supplies the new lyrics. fixed defaults to false; fixed=true requires a range shorter than 26 seconds and remains unverified in the recorded workflow.
For new-track commits, optional name, nonnegative gain (default 1), and non-overlapping start_beats / end_beats control placement. Defaults use the source clip's start and the candidate's actual duration. Replacement commits target the original track containing the unique source clip and must omit start_beats and end_beats.
Rendering accepts lyrics (default [Instrumental]), tags, and an optional beat range. Without a range it uses the earliest and latest audible clips; muted clips are excluded and solo tracks take precedence. An empty or inaudible project cannot be rendered.

The generation model enums are chirp-v3-5, chirp-v4, chirp-v4-5, chirp-v4-5-plus, chirp-v5, chirp-v5-5, chirp-v6, chirp-v6-wild, and chirp-v6-mini. Passing validation does not guarantee that the model supports the selected operation; check the terminal task result. There is no automatic model substitution.

Beta limitations and recovery

The recorded October 9, 2026 workflow generated and committed a new-track candidate, but rendering the project containing it failed with studio_audio_unavailable. Removing that candidate track and rendering the latest version succeeded. The same workflow produced 36-second replacement candidates for an 8-second selection in a 41-second source; committing one failed with bad_request, leaving the original track unchanged. Candidate generation, a playable URL, or a successful commit is not proof that the whole project can be rendered.

On project_version_conflict or project_candidate_stale (409), retrieve the latest project and replan; do not replay stale candidates. If a candidate duration cannot safely match the source or selected section, retain the original track and inspect the candidate rather than forcing guessed beat positions. For audio-access failures, preserve the project and check the source and trace_id. Do not automatically repeat paid generation to resolve these failures. Projects and candidates are bound to their application and execution environment; do not assume cross-application reuse or automatic failover. Use only audio you have rights to process and retain final exported audio URLs.

Overview

Suno API · Ace Data Cloud

Suno API:
Generate AI Music

Integrate Suno AI music generation capabilities into your application through a stable and comprehensive REST API. Create custom songs, pure music, remixes, covers, and more—all through a unified interface. ```

📄 View Documentation

⚡ 6 Model Versions 🎵 16 Actions 📄 OpenAPI 3.0 Specification 🔑 Bearer Token Authentication

🎵

16

Available Actions

🤖

6

Model Versions

📡

12

API Endpoints

📦

5

Output Formats

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 official website and application.

Ace Data Cloud fills this gap by providing a stable, production-ready API, allowing you to programmatically access all of Suno's music generation features—including the latest Chirp v5 model—through a simple REST interface, equipped with OpenAPI specifications, Webhook support, streaming, and pay-as-you-go pricing.

All Features of the Suno API

A comprehensive API suite covering the complete workflow of Suno music generation

🎵

Complete Music Generation

Generate complete songs with lyrics, vocals, and instruments from text prompts, or create pure instrumental music. Supports inspiration mode and custom mode, providing fine control.

🔄

16 Actions, One API

Generate, Extend, Cover, Blend, Stems, Remaster, Underpaint, Overpaint, Replace Section, etc.—all accomplished through the /suno/audios endpoint.

🎤

Custom Persona

Create and save custom singer voice styles through the Persona API. Reuse a consistent vocal identity across unlimited song generations.

📝

AI Lyrics Generation

Automatically generate structured lyrics with paragraph markers (verse, chorus, bridge). The required model parameter accepts default or remi-v1. Also supports mashup lyrics, blending the lyrics of two songs.

🔀

Multi-format Output

Supports output in MP3 (default), MP4 (with visualized video), WAV (lossless audio), and MIDI (music notation) formats. Vocal separation can extract vocals, drums, bass, etc.

⚡

Streaming and Webhook

Supports NDJSON real-time streaming for progress updates, or set a callback_url to asynchronously receive results. No polling required.

Example URL note: Media hosts in historical response snapshots are normalized to media.example.com for publication; they show response structure and are not downloadable assets. Terminal audio and WAV results preferentially use Ace Data Cloud CDN URLs, while intermediate preview URLs are not persisted.

cURL

curl -X POST https://api.acedata.cloud/suno/audios \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"action": "generate",
"prompt": "A cheerful pop song about a summer road trip",
"model": "chirp-v6",
"custom": false,
"callback_url": "https://your-app.com/webhook"
}'

Response

{
"success": true,
"task_id": "b3d7a1...",
"data": [{
"id": "a8f2c9...",
"title": "Summer Highway",
"style": "cheerful pop, driving beat",
"duration": 124.5,
"audio_url": "https://media.example.com/suno/a8f2c9.mp3",
"image_url": "https://media.example.com/suno/a8f2c9.jpeg",
"video_url": "https://media.example.com/suno/a8f2c9.mp4",
"state": "succeeded"
}]
}

Quick Start - Get Started in 5 Minutes

A simple REST API using Bearer Token authentication. One request to generate your first AI song.

1

Get API Key

Register on Ace Data Cloud and obtain your Bearer Token from the console

2

Send POST Request

Send a request to /suno/audios with your prompt and model preferences

3

Get Your Song

Receive audio URL, cover image, lyrics, and video—ready to use

16 Actions, One API

The most comprehensive Suno API—covering every music creation workflow

✨

Generate

Create songs from text prompts in inspiration 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 continued segments into a 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 pure instrumental tracks

✂️

Replace Section

Regenerate content in a specified time range of an existing song

🔀

Blend

Fuse two reference songs into a new creation

📤

Upload + Extend

Upload your own audio and continue it with AI generation

🎯

Persona

Maintain a consistent singer identity across multiple songs

+ Upload Cover + Persona Voice + Sample + Full Stems

What can you build with the Suno API?

From consumer applications to enterprise platforms—developers are building these projects

🎮

Music Creation Apps

Build consumer applications that allow users to generate custom songs, share, and collaborate

🎬

Video and Content

Automatically generate copyright-free background music for videos, short films, and podcasts

🤖

AI Agent and MCP

Integrate with Claude, ChatGPT, or any AI Agent through our MCP Server for natural language music creation

🏪

E-commerce and Advertising

Generate brand music, advertising music, and product audio content in bulk

3 Steps to Get Started Quickly

From registration to generating your first AI song in under 5 minutes

01

Register and Get API Key

Create a free account on Ace Data Cloud. Generate your Bearer Token from the API management console.

02

Initiate Your First API Call

Send a POST request to /suno/audios with a text prompt. You can use SDK, cURL, or any HTTP client.

03

Integration and Expansion

Embed the API into your application. Use Webhook for asynchronous processing and confidently scale to production.

View Documentation →

Why choose Ace Data Cloud over other Suno APIs?

See our comparative advantages on the features that matter most to developers

Feature	Ace Data Cloud	Other Platforms
Chirp v5 Model	✓	Partially supported
16 Actions (Extend, Cover, Stems, etc.)	✓	Partially supported
OpenAPI 3.0 Specification	✓	Partially supported
Webhook Callback	✓	Partially supported
NDJSON Streaming	✓	Partially supported
Custom Persona	✓	Partially supported
MP3 + 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 with Other AI Models

Hesitating between Suno, Udio, and other AI music platforms? Check out their comparison.

Capability	Suno (via Ace Data)	Udio	Others
Songs with Vocals	✓	✓	✗
Custom Lyrics	✓	✓	✗
Pure Instrumental	✓	✓	✓
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

Quick Start

Base URL: https://api.acedata.cloud
Service page: Suno Music Generation on Ace Data Cloud
Docs: Developer documentation

curl --request POST "https://api.acedata.cloud/suno/audios" \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{}'

APIs and Guides

Explore the supported endpoints and integration guides for Suno Music Generation.

API	Path	Integration Guidance
Suno Audios Generation API	`/suno/audios`	Suno Audios Generation API Integration Guide
Suno Persona API	`/suno/persona`	Suno Persona API Integration Guide
Suno MP4 API	`/suno/mp4`	Suno MP4 API Integration Guide
Suno Vox API	`/suno/vox`	Suno Vox API Integration Guide
$t(document_title_suno_timing_generation_api)	`/suno/timing`	Suno Timing API Integration Guide
Suno Wav API	`/suno/wav`	Suno Wav API Integration Guide
Suno MIDI API	`/suno/midi`	Suno MIDI API Integration Guide
Suno Style Generation API	`/suno/style`	Suno Style API Integration Guide
Suno Lyrics Generation API	`/suno/lyrics`	Suno Lyrics Generation API Integration Guide
Suno MashupLyrics Generation API	`/suno/mashup-lyrics`	Suno Mashup Lyrics Generation API Integration Guide
Suno Tasks API	`/suno/tasks`	Suno Tasks API Integration Guide
Suno Upload API	`/suno/upload`	Suno Upload API Integration Guide
Suno Studio Projects API (Beta)	`/suno/projects`	Project workflow

Related Resources

Support

If you meet any issue, please check support info or browse the latest documentation on docs.acedata.cloud.

Name		Name	Last commit message	Last commit date
docs		docs
README.md		README.md

Latest commit

History

Folders and files

Repository files navigation

Suno Music Generation API

MP3 export

Why Use Suno Music Generation on Ace Data Cloud

Custom Models (Beta)

Studio Projects (Beta)

Project workflow

Timing and optional controls

Beta limitations and recovery

Overview

Suno API: Generate AI Music

Does Suno have an official API?

All Features of the Suno API

Complete Music Generation

16 Actions, One API

Custom Persona

AI Lyrics Generation

Multi-format Output

Streaming and Webhook

Quick Start - Get Started in 5 Minutes

Get API Key

Send POST Request

Get Your Song

16 Actions, One API

Generate

Extend

Cover

Concat

Stems

Remaster

Underpaint

Overpaint

Replace Section

Blend

Upload + Extend

Persona

What can you build with the Suno API?

Music Creation Apps

Video and Content

AI Agent and MCP

E-commerce and Advertising

3 Steps to Get Started Quickly

Register and Get API Key

Initiate Your First API Call

Integration and Expansion

Why choose Ace Data Cloud over other Suno APIs?

Comparison of Suno with Other AI Models

Which model is right for you?

Quick Start

APIs and Guides

Related Resources

Support

About

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Suno API:
Generate AI Music