---
title: "近 30 天用量（免费）/ Last 30 days usage (free)"
method: GET
path: "/v1/me/usage"
tags: ["Account"]
---

# 近 30 天用量（免费）/ Last 30 days usage (free)

`GET /v1/me/usage`

## Request

- Base URL: `https://api.musicsforyou.com`
- URL: `https://api.musicsforyou.com/v1/me/usage`
- 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`)

## Response `200`

OK

- UsageResponse
  - `success` true, required
  - `since` string, date-time, required
  - `bySource` object, required: 近 30 天按来源计数：web / api / agent / revise / replace
  - `apiCount30d` integer, required
  - `totalCount30d` integer, required
  - `extraCredits` integer, required
  - `plan` string, required

## Other responses

- `401`: 未登录或 Key 无效 / Not authenticated（LOGIN_REQUIRED、INVALID_API_KEY）

---

[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)