Credits

Understand the sunor credits system, pricing, and billing

Credits

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 task type

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

How billing works

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

1. Credits frozen

   When a task is submitted, the required credits are immediately frozen (reserved) from your available balance. This prevents over-spending.

2. Task processes

   The task is sent to the upstream AI provider and processed asynchronously.

3. Settlement

   • Success: Frozen credits are permanently deducted from your balance.
   • Failure: Frozen credits are automatically refunded to your available balance.

Topping up credits

1. Go to 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

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

Checking your balance

Use the Get Balance endpoint to check your current credits:

curl https://sunor.cc/api/v1/account/balance \
  -H "x-api-key: YOUR_API_KEY"

Response:

{
  "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.