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

🎵

Available Actions

🤖

Model Versions

📡

API Endpoints

📦

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) using two AI models. 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.

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-v4",
    "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://cdn1.suno.ai/a8f2c9.mp3",
    "image_url": "https://cdn2.suno.ai/a8f2c9.jpeg",
    "video_url": "https://cdn1.suno.ai/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.

Get API Key

Send POST Request

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

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

Register and Get API Key

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

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.

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

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?

Suno API:
Generate AI Music

chirp-v3-5

Playground

Input

Result

API

Pricing

Packages

Route pricing

Request calculator

Overview

chirp-v3-5

Model facts