---
title: "可用额度（免费）/ Credit balance (free)"
method: GET
path: "/v1/me/credits"
tags: ["Account"]
---

# 可用额度（免费）/ Credit balance (free)

`GET /v1/me/credits`

## Request

- Base URL: `https://api.musicsforyou.com`
- URL: `https://api.musicsforyou.com/v1/me/credits`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://www.musicsforyou.com/oauth/authorize`, token URL `https://api.musicsforyou.com/oauth/token`, scopes: `music`)
  - none

API / MCP 生成只消耗 `extraCredits`（预付额度）。购买：https://www.musicsforyou.com/developers

API and MCP generations draw from `extraCredits` only. Buy more at https://www.musicsforyou.com/developers.

## Response `200`

OK

- CreditsResponse
  - `success` true, required
  - `plan` 'guest' | 'free' | 'pro' | 'vip' | 'admin', required
  - `remaining` integer, required: 当前可用生成次数（API 只能用 extraCredits）/ Generations available; API calls draw from extraCredits only
  - `monthlyCount` integer
  - `monthlyLimit` integer, nullable
  - `extraCredits` integer, required: 预付额度 / Prepaid credits usable by API and MCP
  - `planExpiresAt` string, date-time, nullable
  - `todayCount` integer
  - `totalCount` integer
  - `trial` object, nullable
    - `credits` integer
    - `grantedAt` string, date-time
  - `requiresLogin` boolean, required

---

[API](https://skmtc.dev/musicsforyou/apis/taoyuan-music-api.md) · [All operations](https://skmtc.dev/musicsforyou/apis/taoyuan-music-api/llms.txt) · [OpenAPI document](https://skmtc.dev/musicsforyou/apis/taoyuan-music-api/revisions/65b8919a4d82?raw)