> ## 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.

# Credits

> Pay-as-you-go credits for the sunor API. Suno music 10 credits ($0.10), Udio music 5 credits ($0.05), Suno lyrics 5 credits, no subscription.

sunor uses a **pay-as-you-go credits system**. You top up credits and they are consumed when you create tasks.

## Credit value

**1 credit = \$0.01 USD**

For example, 1000 credits = \$10.00 USD.

## Pricing by model and task type

### Suno

| Task Type | Credits | USD Equivalent | Description                                 |
| --------- | ------- | -------------- | ------------------------------------------- |
| `music`   | 10      | \$0.10         | Generate a music clip from a prompt         |
| `lyrics`  | 5       | \$0.05         | Generate song lyrics from a prompt          |
| `upload`  | 1       | \$0.01         | Upload an audio file for use with AI models |
| `concat`  | 5       | \$0.05         | Concatenate two clips into one              |

### Udio

| Task Type | Credits | USD Equivalent | Description                              |
| --------- | ------- | -------------- | ---------------------------------------- |
| `music`   | 5       | \$0.05         | Generate a music clip via the Udio model |

## How billing works

When you submit a task, sunor follows a **freeze-then-settle** billing model:

<Steps>
  <Step title="Credits frozen">
    When a task is submitted, the required credits are immediately frozen (reserved) from your available balance. This prevents over-spending.
  </Step>

  <Step title="Task processes">
    The task is sent to the upstream AI provider and processed asynchronously.
  </Step>

  <Step title="Settlement">
    * **Success**: Frozen credits are permanently deducted from your balance.
    * **Failure**: Frozen credits are automatically refunded to your available balance.
  </Step>
</Steps>

## Topping up credits

1. Go to [Dashboard > Billing](https://sunor.cc/dashboard/billing).
2. Select a top-up amount.
3. Complete payment via cryptocurrency (powered by OxaPay).
4. Credits are added to your account once payment is confirmed.

## Volume bonus

Larger top-ups earn **bonus credits** on top of the credits you pay for:

| Top-up amount   | Bonus    |
| --------------- | -------- |
| $500 – $999     | **+5%**  |
| $1,000 – $2,999 | **+10%** |
| \$3,000+        | **+12%** |

The bonus is granted automatically when your payment is confirmed. For example, a \$500 top-up gives 50,000 credits + 2,500 bonus = **52,500 credits**.

<Note>
  Self-serve top-up is capped at $1,000. For $1,000+ volume pricing (including the +12% tier), [contact us on Telegram](https://t.me/+Wz-V9IBpSY5lMzE1) or email [support@sunor.cc](mailto:support@sunor.cc).
</Note>

## Credit expiry

<Warning>
  Credits expire **12 months** from the date of each top-up. Unused credits after this period are forfeited.
</Warning>

## Checking your balance

Use the [Get Balance](/api-reference/get-balance) endpoint to check your current credits:

```bash theme={null}
curl https://sunor.cc/api/v1/account/balance \
  -H "x-api-key: YOUR_API_KEY"
```

Response:

```json theme={null}
{
  "code": 200,
  "data": {
    "available": 950,
    "frozen": 10,
    "total": 960
  }
}
```

| Field       | Description                           |
| ----------- | ------------------------------------- |
| `available` | Credits available to spend            |
| `frozen`    | Credits reserved by in-progress tasks |
| `total`     | `available` + `frozen`                |

## Failed tasks

If a task fails for any reason (upstream provider error, timeout, etc.), the frozen credits are **automatically refunded** to your available balance. You are never charged for failed tasks.