Suno API Pricing, Docs & Playground

Use supported Suno music models on one API. Compare pricing, open the docs, test prompts in the playground, and start integrating with async task workflows.

Model Type:

Price: $0.111(~ 8 credits) per song

May experience occasional downtime. Suitable for development and testing.

Use the same API endpoint for all versions. Only the model parameter differs.

Model Version*

Prompt*

93 (suggested: 2,000)

Custom Mode

Enable for fine control over style, title, lyrics

Instrumental Only

Generate music without vocals

Music Style

E.g., pop, rock, electronic, 120bpm

Song Title

Max 80 characters

Click Generate to see preview

History

Max 20 items

0 running · 0 completed

Your generation history will appear here

Suno Music API

Generate AI music with supported Suno models on one API. Compare pricing, view docs, test prompts in the playground, and integrate with async task workflows.

Pricing

Model	Mode	Price
suno-v4-beta	Music Generation	$0.111/ song(8 Credits)
suno-v4.5-beta	Music Generation	$0.111/ song(8 Credits)
suno-v4.5all-beta	Music Generation	$0.111/ song(8 Credits)
suno-v4.5plus-beta	Music Generation	$0.111/ song(8 Credits)
suno-v5-beta	Music Generation	$0.111/ song(8 Credits)

suno-v4-beta

Music Generation

Price:

$0.111/ song

(8 Credits)

suno-v4.5-beta

Music Generation

Price:

$0.111/ song

(8 Credits)

suno-v4.5all-beta

Music Generation

Price:

$0.111/ song

(8 Credits)

suno-v4.5plus-beta

Music Generation

Price:

$0.111/ song

(8 Credits)

suno-v5-beta

Music Generation

Price:

$0.111/ song

(8 Credits)

If it's down, we automatically use the next cheapest available—ensuring 99.9% uptime at the best possible price.

Suno Music API Overview

Generate music from prompts or custom lyrics

Create AI music generation tasks from text prompts and optional custom lyric structures. Use supported Suno models for vocal or instrumental workflows through a single API entry point.

Try Demo

Demonstration of Suno Music API prompt-driven generation

Use an async task API

Submit music generation requests to `/v1/audios/generations`, then poll `/v1/tasks/{task_id}` or handle callbacks in your app. This fits audio generation workloads better than instant-response patterns.

View Documentation

Integration schematic for Suno Music API async task workflows

Access model variants and Persona flows

Route between currently listed Suno music models and work with Persona-related flows where supported. This helps developers keep music generation and reusable style workflows in one place.

Explore Features

Visualization of Suno model variants and Persona support

Why Developers Use the Suno Music API

This page is designed to answer the practical questions developers ask first: what models are supported, how pricing works, how the async flow behaves, and where to find the docs.

Pricing and credits per generation

Current public music pricing on this page is listed as 8 credits per song for the supported Suno music models shown in the pricing table.

Supported Suno models and Persona support

The current public model list on this page includes suno-v4-beta, suno-v4.5-beta, suno-v4.5all-beta, suno-v4.5plus-beta, and suno-v5-beta, with Persona-related flows shown separately.

Async workflow, docs, and playground access

Music generation is handled as an asynchronous task flow, and this page brings together the playground, API docs, and integration entry points in one place.

How to Use the Suno Music API

A practical 3-step flow aligned with the current async API reference.

Get Your API Key

Sign in to the Evolink AI dashboard, create an API key, and use the playground or docs to validate the request shape before integrating.

Submit an async generation task

Send a POST request to `/v1/audios/generations` with your model, prompt, and required parameters. Add a callback URL if your app handles completion asynchronously.

Poll status and save the result

Query `GET /v1/tasks/{task_id}` or receive a callback when the task completes, then save the generated audio promptly. The current API reference states audio links remain valid for 72 hours.

Get Started

Key Suno Music API Details

Focused on pricing, model support, workflow shape, and developer-facing integration behavior.

Models

Supported model lineup

The public music lineup on this page currently lists suno-v4-beta, suno-v4.5-beta, suno-v4.5all-beta, suno-v4.5plus-beta, and suno-v5-beta.

Pricing

Current public pricing

Music generation on this page is priced from 8 credits per song for the listed Suno models, with Persona shown separately in the pricing section.

Workflow

Async task endpoint

Create music generation tasks through `POST /v1/audios/generations` instead of relying on instant-response request patterns.

API

Task status retrieval

Track completion through `GET /v1/tasks/{task_id}` and build polling or callback handling around the async lifecycle.

Persona

Persona creation flow

Persona support is presented as a separate workflow for reusable style or voice continuity built from completed Suno tasks.

Docs

Playground and docs

Use the playground to test prompts, then move into the API reference and dashboard flow when you are ready to integrate.

Suno Music API FAQ

Everything you need to know about the product and billing.

The Suno Music API is the programmatic interface used to create AI music generation tasks from text prompts and related parameters. On Evolink AI, this page acts as the product entry point for pricing, docs, playground testing, and async integration.

For the music generation models currently listed on this page, pricing is shown as 8 credits per song. Use the pricing section on this page as the source of truth for the current public Suno music pricing displayed here.

The current public music lineup shown on this page includes suno-v4-beta, suno-v4.5-beta, suno-v4.5all-beta, suno-v4.5plus-beta, and suno-v5-beta.

Yes. The current API reference on this page shows an async task flow: submit to `POST /v1/audios/generations`, then retrieve task results through `GET /v1/tasks/{task_id}` or a callback-based workflow.

Before launching a production workflow, review the upstream provider requirements that apply to your use case and confirm your app can handle the current async task flow, result delivery, and asset retention behavior described in the API reference.

Suno Persona is the Persona-related workflow shown on this page for reusable style or voice continuity. Use the Persona variant and API reference to review the current creation flow and task requirements.

Use the API reference and documentation entry points linked from this page. The model page is intended to help you compare pricing, open docs, test prompts in the playground, and move into implementation from one place.

The current API reference on this page states that generated audio links are valid for 72 hours. Save completed results promptly after task completion instead of treating response URLs as permanent storage.

API Reference

Select endpoint

Authentication

All APIs require Bearer Token authentication.

Header

Authorization: 
Bearer YOUR_API_KEY

Get API Key

POST

/v1/audios/generations

Generate Music

Create a music generation task using text prompts or custom lyrics.

Asynchronous processing mode, use the returned task ID to .

Generated audio links are valid for 72 hours, please save them promptly.

Request Parameters

modelstringRequiredDefault: suno-v5-beta

Music generation model name.

Value	Description
suno-v4-beta	V4 version, up to 4 minutes
suno-v4.5-beta	V4.5 version (Recommended)
suno-v4.5all-beta	V4.5 full-featured version
suno-v4.5plus-beta	V4.5+ enhanced version
suno-v5-beta	V5 latest version

Examplesuno-v5-beta

custom_modebooleanRequiredDefault: false

Enable custom mode for fine-grained control over style, title, lyrics.

Notes

false: Simple mode, AI auto-generates lyrics and style
true: Custom mode, allows control over style, title, lyrics

Examplefalse

instrumentalbooleanRequiredDefault: false

Generate instrumental music without vocals.

Examplefalse

promptstringOptional

Music description or lyrics content.

Notes

Simple mode: Music description, AI auto-generates lyrics
Custom mode: Used as exact lyrics
Max length: 3000 chars (V4), 5000 chars (V4.5+)

ExampleA cheerful summer pop song about road trips

stylestringOptional

Music style specification (required in custom mode).

Notes

Use comma-separated tags: pop, rock, electronic, jazz
Max length: 200 chars (V4), 1000 chars (V4.5+)

Examplepop, electronic, upbeat, female vocals

titlestringOptional

Song title (required in custom mode).

Notes

Max length: 80 characters

ExampleSummer Dreams

vocal_genderstringOptional

Vocal gender preference (custom mode only).

Value	Description
m	Male voice
f	Female voice

Examplef

negative_tagsstringOptional

Styles to avoid in the generated music.

Exampleheavy metal, screaming, sad

style_weightnumberOptional

Style weight, controls adherence to the specified style.

Notes

Range: 0.0 ~ 1.0, one decimal place
Higher values = closer adherence to specified style
Value of 0 is treated as unset

Example0.7

weirdness_constraintnumberOptional

Creativity level, controls the experimental degree of the output.

Notes

Range: 0.0 ~ 1.0, one decimal place
Higher values = more creative/experimental output
Lower values = more traditional/conservative output

Example0.3

audio_weightnumberOptional

Audio weight, controls the weight of audio features.

Notes

Range: 0.0 ~ 1.0, one decimal place
Value of 0 is treated as unset

Example0.5

persona_idstringOptional

Apply a Persona style to music generation (custom mode only).

Notes

Only effective when custom_mode is true
Create a persona_id via the Create Persona endpoint
Each persona captures unique vocal and style characteristics

Examplea1b2c3d4

persona_modelstringOptional

Persona model type to apply (custom mode only).

Value	Description
style_persona	Style-oriented persona (all models, default)
voice_persona	Voice-oriented persona (V5 only)

Notes

Only effective when custom_mode is true and persona_id is provided
voice_persona is only available with suno-v5-beta model

Examplestyle_persona

callback_urlstringOptional

HTTPS callback URL for task completion notification.

Notes

Only HTTPS protocol supported
Callbacks to internal IP addresses are prohibited
URL length must not exceed 2048 characters
Timeout: 10 seconds, max 3 retries on failure

Examplehttps://your-domain.com/webhooks/suno-callback

Response

// Immediate response (task created)
{
  "id": "task-unified-xxx-yyy",
  "object": "audio.generation.task",
  "created": 1774168248,
  "model": "suno-v5-beta",
  "status": "pending",
  "progress": 0,
  "type": "audio"
}

// Completed (query via GET /v1/tasks/{task_id})
{
  "id": "task-unified-xxx-yyy",
  "status": "completed",
  "progress": 100,
  "model": "suno-v5-beta",
  "result_data": [
    {
      "result_id": "4fcc4507-xxxx-xxxx",
      "title": "Summer Dreams",
      "tags": "pop, electronic, upbeat",
      "duration": 142,
      "audio_url": "https://media.evolink.ai/...",
      "image_url": "https://media.evolink.ai/..."
    },
    {
      "result_id": "c41cb076-xxxx-xxxx",
      "title": "Summer Dreams",
      "tags": "pop, electronic, upbeat",
      "duration": 136,
      "audio_url": "https://media.evolink.ai/...",
      "image_url": "https://media.evolink.ai/..."
    }
  ],
  "results": [
    "https://media.evolink.ai/...",
    "https://media.evolink.ai/..."
  ]
}