AI Music API
Home
Home
    • 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
      • 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 music
    • nuro
      • Nuro Instruction
      • Error handling
      • create vocal music
      • create instrument music
      • get music
    • lyrics generation
      • Make Lyrics
    • get-credits
      GET
    • Schemas
      • 记录不存在
      • 参数不正确
    Home
    Home

    Credits Usage Guide

    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#

    OperationCreditsOutput
    Create music102 songs
    Extend music102 songs
    Cover music102 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 + Cover102 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)104 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 mode10
    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-01-24 13:42:29
    Previous
    Introduction
    Next
    AI Music API FAQ & Troubleshooting
    Built with