Skip to main content

​
Welcome to sunor

sunor is a Sound & Music Aggregated API Platform that gives you unified access to multiple AI music and audio generation models through a single REST API.

​
What you can do

  • Generate music from text descriptions, custom lyrics, or by extending existing clips
  • Generate lyrics from a text prompt
  • Upload audio for use with AI models
  • Concatenate clips into longer compositions

​
How it works

Pay-as-you-go credits

No subscriptions. Top up credits and only pay for what you use. 1 credit = $0.01 USD.

REST API

Simple JSON-based API with standard HTTP methods. Submit a task, poll for results.

Multiple AI models

Access different AI music providers through one unified interface.

Async task system

Submit tasks and retrieve results when they are ready. No long-running connections needed.

​
Quick start

Get up and running in four steps:
1

Sign up

Create an account at sunor using Google OAuth.
2

Get your API key

Navigate to Dashboard > API Keys and create a new key.
3

Top up credits

Go to Dashboard > Billing and add credits via crypto payment.
4

Make your first API call

Submit a music generation task:
curl -X POST https://sunor.cc/api/v1/task \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "model": "suno",
    "task_type": "music",
    "input": {
      "gpt_description_prompt": "A cheerful acoustic guitar song about summer",
      "make_instrumental": false,
      "mv": "chirp-v4"
    }
  }'

​
Base URL

All API requests are made to: 
https://sunor.cc/api/v1

​
Next steps

Authentication

Learn how to authenticate your API requests.

Credits

Understand the credits system and pricing.

Create a Task

Explore the task creation endpoint.

Suno Model

Learn about the Suno music generation model.