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.118(~ 8 credits) per generation

Each generation returns 2 tracks

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

Click Generate to see preview

History

Max 20 items

0 running · 0 completed

Results are kept for 24 hours — download anything you want to keep.

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.

Billing Rules

•Charged per generation request, not per track
•Each generation returns 2 tracks, so the per-track price is half the listed price

Pricing

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

suno-v4-beta

Music Generation

Price:

$0.118/ generation

(8 Credits)

suno-v4.5-beta

Music Generation

Price:

$0.118/ generation

(8 Credits)

suno-v4.5all-beta

Music Generation

Price:

$0.118/ generation

(8 Credits)

suno-v4.5plus-beta

Music Generation

Price:

$0.118/ generation

(8 Credits)

suno-v5-beta

Music Generation

Price:

$0.118/ generation

(8 Credits)

suno-v5.5-beta

Music Generation

Price:

$0.118/ generation

(8 Credits)

If an upstream route is unavailable, EvoLink can use the next available option where fallback coverage exists, helping teams keep costs and operations predictable.

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 generation for the supported Suno music models shown in the pricing table. Each generation returns 2 tracks.

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, suno-v5-beta, and suno-v5.5-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 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.

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, suno-v5-beta, and suno-v5.5-beta.

Pricing

Current public pricing

Music generation on this page is priced from 8 credits per generation (2 tracks) 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.

Cost Example

100 songs/month with Suno V5.550 × $0.1176 = $5.88 (8 credits/call, 2 songs)

Music-app MVP with 1,000 songs500 × $0.1176 = $58.80

Production app with 10,000 songs/month5,000 × $0.1176 = $588

Each API call generates 2 tracks. Price is $0.1176 per call (8 credits).

Explore more AI models on EvoLink →

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, this page acts as the product entry point for pricing, docs, playground testing, and async integration.

We use pure pay-per-use pricing with no fixed subscription or hidden fees. Each generation request costs 8 credits (about $0.1176) and returns 2 tracks, so the effective price is 4 credits per track. Use the pricing section on this page as the source of truth for the current public Suno music pricing.

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, suno-v5-beta, and suno-v5.5-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

Endpoints

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.

Supports simple mode, custom mode, vocal music, instrumental music, and reusable Personas.

Asynchronous processing mode, use the returned task ID to .

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

Each request generates multiple music variations.

Request Parameters

modelstringRequired

Music generation model name.

Value	Description
suno-v5.5-beta	V5.5 with custom duration control
suno-v5-beta	V5 with Voice Persona support
suno-v4.5plus-beta	V4.5+ enhanced version, up to 8 minutes
suno-v4.5all-beta	V4.5 full-featured version, up to 8 minutes
suno-v4.5-beta	V4.5 version, up to 8 minutes
suno-v4-beta	V4 version, up to 4 minutes

Notes

Compatible non-beta model names remain supported, including suno-v5.5
V4 prompt/style limits: 3000/200 characters
V4.5, V5, and V5.5 prompt/style limits: 5000/1000 characters

Examplesuno-v5.5-beta

custom_modebooleanOptionalDefault: 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

instrumentalbooleanOptionalDefault: false

Generate instrumental music without vocals.

Notes

In simple mode, this parameter does not change which fields are required
In custom mode, prompt becomes optional when instrumental is true

Examplefalse

promptstringOptional

Music description or lyrics content.

Notes

Simple mode: Music description, AI auto-generates lyrics
Custom mode: Used as exact lyrics
Simple mode max length: 500 characters
Custom mode 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, V5, and V5.5)
Do not send when custom_mode=false; invalid combinations return a parameter error

Examplepop, electronic, upbeat, female vocals

titlestringOptional

Song title (required in custom mode).

Notes

Max length: 80 characters
Do not send when custom_mode=false; invalid combinations return a parameter error

ExampleSummer Dreams

vocal_genderstringOptional

Vocal gender preference (custom mode only).

Value	Description
m	Male voice
f	Female voice

Notes

Only accepted when custom_mode is true
Increases the probability of the selected voice; it does not guarantee it

Examplef

negative_tagsstringOptional

Styles to avoid in the generated music (custom mode only).

Notes

Only accepted when custom_mode is true

Exampleheavy metal, screaming, sad

style_weightnumberOptional

Style weight, controls adherence to the specified style.

Notes

Only accepted when custom_mode is true
Range: 0.0 ~ 1.0, up to two decimal places
Value must be a multiple of 0.01
Higher values = closer adherence to specified style
0 is a valid explicit value

Example0.7

weirdness_constraintnumberOptional

Creativity level, controls the experimental degree of the output.

Notes

Only accepted when custom_mode is true
Range: 0.0 ~ 1.0, up to two decimal places
Value must be a multiple of 0.01
Higher values = more creative/experimental output
Lower values = more traditional/conservative output
0 is a valid explicit value

Example0.3

audio_weightnumberOptional

Audio weight, controls the weight of audio features.

Notes

Only accepted when custom_mode is true
Range: 0.0 ~ 1.0, up to two decimal places
Value must be a multiple of 0.01
0 is a valid explicit value

Example0.5

persona_idstringOptional

Apply a Persona style to music generation (custom mode, V5 and V5.5 only).

Notes

Only accepted when custom_mode is true
Only supported by suno-v5-beta or suno-v5.5-beta (including compatible aliases) — this restriction applies to persona_id itself, not only to persona_model
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
voice_persona	Voice-oriented persona

Notes

Requires custom_mode=true
Both Persona modes are available only with suno-v5-beta or suno-v5.5-beta (including compatible aliases)
Requires persona_id — without it there is no persona to apply and the parameter has no effect

Examplestyle_persona

durationintegerOptionalDefault: 20

Optional target duration in seconds (Suno V5.5 custom mode only).

Notes

Only supported by suno-v5.5-beta and its compatible alias suno-v5.5
Requires custom_mode=true
Must be an integer from 10 to 360 seconds
Other models or simple mode return a parameter error

Example120

callback_urlstringOptional

HTTPS callback URL for terminal task status.

Notes

One callback is sent when the task reaches completed, failed, or cancelled
Upstream text and first intermediate stages are not forwarded
The callback body matches GET /v1/tasks/{id}
Only HTTPS is supported
Callbacks to internal IP addresses are prohibited
URL length must not exceed 2048 characters
Per-attempt timeout: 10 seconds
Up to 3 retries after the initial request fails
A 2xx response is considered successful

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.5-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.5-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/..."
  ]
}