AI Music API
HomeGet API key
HomeGet API key
    • Introduction
    • Credits Usage Guide
    • AI Music API FAQ & Troubleshooting
    • Special Scenarios
    • Error handling
    • Webhook Integration Guide
    • sonic
      • Sonic Instructions
      • create / extend / cover music
        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
      • concat music
        POST
      • stems basic
        POST
      • stems full
        POST
      • remaster
        POST
      • replace section
        POST
      • add vocal
        POST
      • add instrumental
        POST
      • upload music
        POST
      • create voice
        POST
      • get music
        GET
    • riffusion(Deprecated)
      • Riffusion instructions
      • create music (with lyrics)
      • create music (with description)
      • cover music
      • extend music
      • replace music section
      • swap music sound
      • swap music vocals
      • upload
      • get music
    • producer
      • Producer Instructions
      • Complete Request Example
      • create music
      • upload
      • download
      • get task / poll result
    • nuro
      • Nuro Instruction
      • Error handling
      • create vocal music
      • create instrument music
      • get music
    • lyrics generation
      • Make Lyrics
    • get-credits
      GET

    Credits Usage Guide

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

    Advanced models (v4.5, v4.5+, v5, v5.5) consume 14 credits per generation for Create music, Cover music, Mashup, and Sample, and for description mode (custom_mode=false, any model). Standard/older models (v3.5, v4, v4.5-all) remain at the credits shown below. Basic stems now cost 20 credits.
    OperationCreditsOutput
    Create music10 (14 advanced)2 songs
    Extend music102 songs
    Cover music10 (14 advanced)2 songs
    Remaster102 songs
    Replace section102 songs
    Add vocals102 songs
    Add instrumental102 songs
    Persona music102 songs
    Concat music21 song
    Upload music21 clip_id
    Upload + Extend102 songs
    Upload + Cover10 (14 advanced)2 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)204 stems
    Stems (full)5024 stems
    *Aligned lyrics: First request costs 1 credit, subsequent requests for the same clip are free.

    Other Models#

    ModelCredits per CallOutputStatus
    Producer101 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 10 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 (10) + Extend (10) + Concat (2)22
    Quick testCreate with description mode14
    Style explorationUpsample tags (1) + Create (10)11
    Cover existingUpload (2) + Cover (10)12

    Subscription Plans#

    Visit aimusicapi.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 10 credits for one song?
    A: Most generation operations produce 2 songs and cost 10 credits total.
    Modified at 2026-07-26 01:08:52
    Previous
    Introduction
    Next
    AI Music API FAQ & Troubleshooting
    Built with