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

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