Credits Usage Guide#
MusicAPI uses a unified credit system across all models. This guide explains how credits work and how they are consumed.
Credit Types#
1. Subscription Credits#
Monthly credits included with your subscription plan.| Feature | Description |
|---|
| Reset | Monthly on billing date |
| Rollover | ❌ Unused credits do not carry over |
| Priority | Used after extra credits are depleted |
One-time purchasable credits for additional usage.| Feature | Description |
|---|
| Expiration | ✅ Never expire |
| Priority | Consumed before subscription credits |
| Requirement | Active subscription required to use |
| Purchase | Available in credit packs from dashboard |
Credits Cost by Operation#
Sonic Model#
| Operation | Credits | Output |
|---|
| Create music | 15 | 2 songs |
| Extend music | 15 | 2 songs |
| Cover music | 15 | 2 songs |
| Persona music | 15 | 2 songs |
| Concat music | 2 | 1 song |
| Upload music | 2 | 1 clip_id |
| Upload + Extend | 15 | 2 songs |
| Upload + Cover | 15 | 2 songs |
| Create persona | 1 | 1 persona |
| Get BPM | 1 | BPM data |
| Get VOX | 1 | Vocal audio |
| Upsample tags | 1 | Enhanced tags |
| Get WAV | 1 | WAV file |
| Get MIDI | 1 | MIDI data |
| Aligned lyrics | 1 | First call only* |
| Stems (basic) | 15 | 4 stems |
| Stems (full) | 75 | 24 stems |
*Aligned lyrics: First request costs 1 credit, subsequent requests for the same clip are free.
Other Models#
| Model | Credits per Call | Output | Status |
|---|
| Producer | 12 | 1 song | Active |
| Nuro | 10 | 1 song | Active |
Credit Consumption Order#
When you make an API call, credits are consumed in this order:1. Extra Credits (if available)
↓
2. Subscription Credits (if extra credits depleted)
This means your extra credits act as a buffer, protecting your monthly subscription credits.
Checking Your Balance#
API Request#
Response#
{
"code": 200,
"data": {
"credits": 500,
"extra_credits": 100
}
}
| Field | Description |
|---|
credits | Remaining subscription credits |
extra_credits | Remaining extra credits |
Insufficient Credits#
When you don't have enough credits, the API returns:{
"type": "forbidden",
"error": "The remain credits is not enough, you can buy more one time credits pack or subscribe to get more credits"
}
Tips for Managing Credits#
Optimize Usage#
1.
Use concat wisely: Concat costs only 2 credits vs 15 for extend
2.
Batch operations: Plan your generations to avoid wasted credits
3.
Test with description mode: Sometimes faster iteration than custom lyrics
Monitor Usage#
1.
Check balance regularly via API or dashboard
2.
Set up alerts for low credit balance
3.
Purchase extra credits before running out
Cost-Effective Workflows#
| Scenario | Recommended Approach | Total Credits |
|---|
| Create full song | Create (15) + Extend (15) + Concat (2) | 32 |
| Quick test | Create with description mode | 15 |
| Style exploration | Upsample tags (1) + Create (15) | 16 |
| Cover existing | Upload (2) + Cover (15) | 17 |
Subscription Plans#
| Plan Feature | Description |
|---|
| Monthly credits | Varies by plan |
| Rate limits | Higher tiers get more concurrency |
| Extra credits | Available for all paid plans |
FAQ#
Q: Do unused subscription credits roll over?
A: No, subscription credits reset monthly and do not carry over.Q: Do extra credits expire?
A: No, extra credits never expire as long as you have an active subscription.Q: Which credits are used first?
A: Extra credits are always consumed before subscription credits.Q: Can I use extra credits without a subscription?
A: yes.Q: Why was I charged 15 credits for one song?
A: Most generation operations produce 2 songs and cost 15 credits total.Modified at 2026-01-24 13:33:59