MusicAPI
HomeDocs
HomeDocs
  1. Docs
  • Introduction
  • Credits Usage Guide
  • Music API FAQ & Troubleshooting
  • Special Scenarios
  • Error handling
  • Webhook Integration Guide
  • sonic
    • Sonic Instructions
    • create / extend / cover / remaster / add vocals / add instrumental
      POST
    • upload and extend music
      POST
    • upload and cover music
      POST
    • create persona
      POST
    • sample
      POST
    • mashup
      POST
    • get BPM
      POST
    • get VOX
      POST
    • get wav
      POST
    • get midi
      POST
    • get lyrics timeline
      POST
    • upsample tags
      POST
    • stems basic
      POST
    • stems full
      POST
    • replace section
      POST
    • upload music
      POST
    • get music
      GET
  • riffusion(Deprecated)
    • Riffusion instructions
    • create music (with lyrics)
      POST
    • create music (with description)
      POST
    • cover music
      POST
    • extend music
      POST
    • replace music section
      POST
    • swap music sound
      POST
    • swap music vocals
      POST
    • upload
      POST
    • get music
      GET
  • producer
    • Producer instructions
    • Complete Request Examples
    • create music
    • upload
    • download
    • get music
  • studio(Unavailable)
    • Studio Instructions
    • description mode (Use case1)
    • extend mode (Use case2)
    • custom mode (Use case3)
    • instrumental mode (Use case4)
    • get music
  • lyrics generation
    • Make Lyrics
  • nuro
    • Nuro Instruction
    • Error handling
    • create vocal music
    • create instrument music
    • get music
  • get-credits
    GET
  • Schemas
    • 记录不存在
    • 参数不正确
HomeDocs
HomeDocs
  1. Docs

Credits Usage Guide

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.
FeatureDescription
ResetMonthly on billing date
Rollover❌ Unused credits do not carry over
PriorityUsed after extra credits are depleted

2. Extra Credits#

One-time purchasable credits for additional usage.
FeatureDescription
Expiration✅ Never expire
PriorityConsumed before subscription credits
RequirementActive subscription required to use
PurchaseAvailable in credit packs from dashboard

Credits Cost by Operation#

Sonic Model#

OperationCreditsOutput
Create music152 songs
Extend music152 songs
Cover music152 songs
Persona music152 songs
Concat music21 song
Upload music21 clip_id
Upload + Extend152 songs
Upload + Cover152 songs
Create persona11 persona
Get BPM1BPM data
Get VOX1Vocal audio
Upsample tags1Enhanced tags
Get WAV1WAV file
Get MIDI1MIDI data
Aligned lyrics1First call only*
Stems (basic)154 stems
Stems (full)7524 stems
*Aligned lyrics: First request costs 1 credit, subsequent requests for the same clip are free.

Other Models#

ModelCredits per CallOutputStatus
Producer121 songActive
Nuro101 songActive

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
  }
}
FieldDescription
creditsRemaining subscription credits
extra_creditsRemaining 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"
}
HTTP Status Code: 403

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#

ScenarioRecommended ApproachTotal Credits
Create full songCreate (15) + Extend (15) + Concat (2)32
Quick testCreate with description mode15
Style explorationUpsample tags (1) + Create (15)16
Cover existingUpload (2) + Cover (15)17

Subscription Plans#

Visit musicapi.ai/pricing to view available plans and credit allocations.
Plan FeatureDescription
Monthly creditsVaries by plan
Rate limitsHigher tiers get more concurrency
Extra creditsAvailable 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
Previous
Introduction
Next
Music API FAQ & Troubleshooting
Built with