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.014(~ 1 credits) per persona

May experience occasional downtime. Suitable for development and testing.

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

Source Task ID*

Task ID of a completed Suno music generation (e.g., task-audio-xxx)

Result ID*

The result_id of the song to extract from (found in result_data.songs[].result_id)

Persona Name*

Name for the persona

Persona Description*

Describe the music style and personality

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-persona	Persona Creation	$0.014/ request(1 Credits)

suno-persona

Persona Creation

Price:

$0.014/ request

(1 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

Create Persona

Create a reusable music persona from a completed Suno music generation task.

Asynchronous processing mode, use the returned task ID to .

Once created, use the persona_id in future music generations to maintain consistent style.

Request Parameters

modelstringRequiredDefault: suno-persona

Must be set to suno-persona for persona creation.

Value	Description
suno-persona	Persona creation model

Examplesuno-persona

model_params.source_task_idstringRequired

The task ID of a completed Suno music generation task.

Notes

Task must belong to the current user
Task status must be completed
Source model must be suno-v4 or later (v3.5 not supported)

Exampletask-audio-123-456

model_params.result_idstringRequired

The result_id of the specific song to extract persona from.

Notes

Found in the task's result_data.songs[].result_id
Each song can only be used to create one persona

Examplee231-xxxx-xxxx

model_params.namestringRequired

Name for the persona.

ExampleElectronic Pop Singer

model_params.descriptionstringRequired

Description of the persona's music style.

ExampleModern electronic style with energetic beats and synthesizer tones

model_params.vocal_startnumberOptional

Start time for vocal extraction in seconds.

Notes

Must be >= 0
If provided, vocal_end must also be specified
Window (vocal_end - vocal_start) should be 10-30 seconds

Example12.5

model_params.vocal_endnumberOptional

End time for vocal extraction in seconds.

Notes

Must be > vocal_start
Window (vocal_end - vocal_start) should be 10-30 seconds

Example25.8

model_params.stylestringOptional

Optional style tag for the persona.

Exampleelectronic pop

Response

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

// Completed (query via GET /v1/tasks/{task_id})
{
  "id": "task-unified-xxx-yyy",
  "status": "completed",
  "progress": 100,
  "result_data": {
    "persona_id": "5c57d49ef834110496fae5aa14fec441",
    "name": "Electronic Pop Singer",
    "description": "Modern electronic style with energetic beats",
    "source_task_id": "task-unified-1774169216-ocqaqde7",
    "source_result_id": "4fcc4507-a7ae-4441-ad8a-465c2f61d5bb"
  }
}

Using a Persona

After creating a persona, use the returned persona_id in any Suno music generation request to maintain consistent style:

POST /v1/audios/generations
{
  "model": "suno-v4.5-beta",
  "prompt": "A groovy dance track with energetic beats",
  "persona_id": "a1b2c3d4"
}