> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sunor.cc/llms.txt
> Use this file to discover all available pages before exploring further.

# Suno API Documentation

> Complete Suno API documentation. REST endpoints, authentication, code examples, and guides for generating music, lyrics, and audio programmatically.

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

<CardGroup cols={2}>
  <Card title="Pay-as-you-go credits" icon="coins">
    No subscriptions. Top up credits and only pay for what you use. 1 credit = \$0.01 USD.
  </Card>

  <Card title="REST API" icon="code">
    Simple JSON-based API with standard HTTP methods. Submit a task, poll for results.
  </Card>

  <Card title="Multiple AI models" icon="robot">
    Access different AI music providers through one unified interface.
  </Card>

  <Card title="Async task system" icon="clock">
    Submit tasks and retrieve results when they are ready. No long-running connections needed.
  </Card>
</CardGroup>

## Quick start

Get up and running in four steps:

<Steps>
  <Step title="Sign up">
    Create an account at [sunor](https://sunor.cc/login) using Google OAuth.
  </Step>

  <Step title="Get your API key">
    Navigate to [Dashboard > API Keys](https://sunor.cc/dashboard/api-keys) and create a new key.
  </Step>

  <Step title="Top up credits">
    Go to [Dashboard > Billing](https://sunor.cc/dashboard/billing) and add credits via crypto payment.
  </Step>

  <Step title="Make your first API call">
    Submit a music generation task:

    ```bash theme={null}
    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
        }
      }'
    ```
  </Step>
</Steps>

## Base URL

All API requests are made to:

```
https://sunor.cc/api/v1
```

## Next steps

<CardGroup cols={2}>
  <Card title="Authentication" icon="key" href="/authentication">
    Learn how to authenticate your API requests.
  </Card>

  <Card title="Credits" icon="coins" href="/credits">
    Understand the credits system and pricing.
  </Card>

  <Card title="Create a Task" icon="plus" href="/api-reference/create-task">
    Explore the task creation endpoint.
  </Card>

  <Card title="Suno Model" icon="music" href="/models/suno">
    Learn about the Suno music generation model.
  </Card>
</CardGroup>