Retrieve an ACE Music account

November 14, 2026 (November 16, 2026)

Table of contents

  1. Request Headers
  2. Responses
  3. Model
  4. Examples
  5. Try It

Read one connected account together with what ACE Music reports for it right now: the plan, the billing cycle, the credits left, what each request costs in credits, and the models the account can use with their text limits. Use it to check the balance before a run on ACE Music v1 or v1.1, which cost 4 credits a request.

A paused account (its stored password was refused) answers with the stored fields and its error, without asking ACE Music. When only ACE Music’s live part fails for a moment, the stored fields come back with liveError.

https://api.useapi.net/v1/acemusic/accounts/email

  • email is the email of a connected account, URL-encoded in the path.
Request Headers
Authorization: Bearer {API token}
Responses
  • 200 OK

    {
      "email": "example@example.com",
      "user_id": "1216554433",
      "plan": "free",
      "maxJobs": 4,
      "added": "2026-11-14T19:17:18.288Z",
      "health": "OK",
      "plan_name": "Free",
      "cycle": "monthly",
      "credits": 16,
      "costs": {
        "song": 4,
        "stems": {
          "0": 5,
          "2": 60
        },
        "video_minute": 1,
        "continue": 1
      },
      "models": [
        {
          "id": "acemusic-v1",
          "name": "ACE Music v1",
          "free": false,
          "limits": { "prompt": 2000, "style": 1000, "lyrics": 5000 }
        },
        {
          "id": "acemusic-v1.1",
          "name": "ACE Music v1.1 Preview",
          "free": false,
          "limits": { "prompt": 2000, "style": 1000, "lyrics": 5000 }
        },
        {
          "id": "ace-step-1.5-xl",
          "name": "ACE-Step v1.5 XL",
          "free": true,
          "limits": { "prompt": 2000, "style": 512, "lyrics": 2000 }
        }
      ],
      "online": true
    }
    
  • 400 Bad Request

    {
      "error": "Path parameter email (not-an-email) is not a valid email",
      "code": 400
    }
    
  • 401 Unauthorized

    Invalid API token.

    {
      "error": "useapi.net ⁝ Unauthorized",
      "code": 401
    }
    
  • 404 Not Found

    {
      "error": "Account example@example.com is not configured",
      "code": 404
    }
    
Model

The account as stored, with ACE Music’s live plan, credits left, credit prices and models.

The account with its live plan, credits and models, field by field
{ // TypeScript, all fields are optional
  email: string                 // the ACE Music account
  user_id: string                // ACE Music's own id of the account
  plan: string | null            // free | creator | artist, live
  maxJobs: number                // requests the account runs at the same time, 1 to 4
  added: string                  // ISO 8601
  updated?: string               // ISO 8601
  error?: string                 // paused: ACE Music refused the stored password, add the account again
  health: 'OK' | 'error'         // error: ACE Music refused the stored password, see error
  plan_name?: string | null      // Free | Creator | Artist. This and the fields below are ACE Music's live
                                 // answer: left out when liveError is set
  cycle?: string | null           // monthly or yearly billing
  credits?: number | null         // credits left. Free plans get 20 a day, Creator 1,000 and Artist 2,500 a month
  costs?: {                       // ACE Music's credit prices, live
    song: number                 // credits a request (two songs) costs on acemusic-v1 and acemusic-v1.1, 4
    stems: Record<string, number>   // credits a stem split with POST /music/stems costs, keyed by ACE Music's own number
                                    // for the split: "0" is mode vocals (vocal and instrumental), 5. "2" is mode all
                                    // (every stem), 60
    video_minute: number         // ACE Music's price for video in a prompt, not used by this API
    continue?: number            // ACE Music's price for continuing a song (a feature of acemusic.ai), not used by this API
  } | null
  models?: {                      // the models ACE Music offers, live
    id: string                   // the value for `model`
    name: string                 // the model's name on acemusic.ai
    free: boolean                // true: 0 credits
    limits: {                    // maximum characters of each text on this model
      prompt: number             // characters allowed in prompt (the song idea in your own words) on this model
      style: number              // characters allowed in style (genre, instruments, mood, tempo and vocals) on this model
      lyrics: number             // characters allowed in lyrics on this model, section tags included
    }
  }[]
  online?: boolean                // false when ACE Music reports itself offline
  offlineReason?: string         // ACE Music's reason when online is false
  liveError?: string             // the live part failed for a moment: only the stored fields are current
}
Examples
  • curl "https://api.useapi.net/v1/acemusic/accounts/example%40example.com" \
       -H "Authorization: Bearer …"
    
  • const token = "API token";
    const email = "example@example.com";
    const response = await fetch(`https://api.useapi.net/v1/acemusic/accounts/${encodeURIComponent(email)}`, {
      headers: { "Authorization": `Bearer ${token}` }
    });
    console.log(response.status, await response.json());
    
  • import requests
    from urllib.parse import quote
    
    token = "API token"
    email = "example@example.com"
    response = requests.get(f"https://api.useapi.net/v1/acemusic/accounts/{quote(email, safe='')}",
                            headers={"Authorization": f"Bearer {token}"})
    print(response.status_code, response.json())
    
Try It