### Song Search - Bash Example

Source: https://context7.com/lvluoyue/api-doc/llms.txt

Performs a basic song search using a keyword and supports pagination with limit parameters. This is an endpoint from the V3 version of the API.

```bash
# Basic song search (V3)
curl "https://api.vkeys.cn/music/tencent/search/song?keyword=狐妖小红娘&page=1&limit=10"

```

--------------------------------

### Smart Box Search - Bash Example

Source: https://context7.com/lvluoyue/api-doc/llms.txt

Performs a smart box search across songs, singers, albums, MVs, and playlists using a keyword. This endpoint is part of the V3 release and returns structured data for each category found.

```bash
# Smart box search (V3)
curl "https://api.vkeys.cn/music/tencent/search/smartbox?keyword=洛天依"

# Response
{
    "code": 0,
    "message": "访问成功",
    "data": {
        "song": {
            "count": 4,
            "itemlist": [
                {
                    "id": "104797698",
                    "mid": "001mzBxY4UVcAH",
                    "name": "霜雪千年",
                    "singer": "洛天依/乐正绫"
                }
            ],
            "name": "单曲",
            "order": 0
        },
        "singer": {
            "count": 1,
            "itemlist": [
                {
                    "id": "61386",
                    "mid": "003ktdcg3E4kaG",
                    "name": "洛天依",
                    "pic": "http://y.gtimg.cn/music/photo_new/T001R150x150M000003ktdcg3E4kaG_7.jpg"
                }
            ],
            "name": "歌手",
            "order": 1
        },
        "album": {
            "count": 2,
            "itemlist": [
                {
                    "id": "1283240",
                    "mid": "001gQ5oZ3ZIbAw",
                    "name": "洛天依作品集",
                    "pic": "http://y.gtimg.cn/music/photo_new/T002R180x180M000001gQ5oZ3ZIbAw_2.jpg",
                    "singer": "洛天依"
                }
            ],
            "name": "专辑",
            "order": 2
        },
        "mv": {
            "count": 2,
            "itemlist": [
                {
                    "id": "1394231",
                    "mid": "001ldqdG4b0HfK",
                    "name": "【全职高手】达拉崩吧",
                    "singer": "洛天依",
                    "vid": "n00253s8ixk"
                }
            ],
            "name": "MV",
            "order": 3
        }
    },
    "time": "2025-04-07 08:05:48",
    "pid": 17908,
    "tips": "欢迎使用落月API-V3"
}
```

--------------------------------

### MV Information

Source: https://context7.com/lvluoyue/api-doc/llms.txt

Get detailed music video metadata including resolution options. This endpoint is V3 only and currently in development.

```APIDOC
## GET /music/tencent/mv/info

### Description
Retrieves detailed metadata for a music video, including available video quality options.

### Method
GET

### Endpoint
`/music/tencent/mv/info`

### Parameters
#### Query Parameters
- **vid** (string) - Required - The unique video identifier for the music video.

### Request Example
```bash
curl "https://api.vkeys.cn/music/tencent/mv/info?vid=s0022035zvf"
```

### Response
#### Success Response (200)
- **vid** (string) - The unique video identifier.
- **mvID** (integer) - The unique music video ID.
- **mvName** (string) - The name of the music video.
- **mvPic** (string) - The URL of the music video thumbnail.
- **publishDate** (string) - The publication date of the music video.
- **duration** (integer) - The duration of the music video in seconds.
- **playCount** (integer) - The number of times the music video has been played.
- **singerName** (string) - The name of the artist.
- **director** (string) - The director of the music video.
- **videoInfo** (array) - Information about available video qualities (may be empty).

#### Response Example
```json
{
    "code": 0,
    "message": "访问成功",
    "data": {
        "vid": "s0022035zvf",
        "mvID": 1068730,
        "mvName": "追光使者",
        "mvPic": "http://y.gtimg.cn/music/photo_new/T015R640x360M101003r1thD0srXkQ.jpg",
        "publishDate": "2017-01-04",
        "duration": 195,
        "playCount": 1785486,
        "singerName": "洛天依",
        "director": "",
        "videoInfo": []
    },
    "time": "2025-04-08 14:29:43",
    "pid": 11444,
    "tips": "欢迎使用落月API-V3"
}
```
```

--------------------------------

### API Response Example

Source: https://context7.com/lvluoyue/api-doc/llms.txt

A standard API response structure from Lvluoyue, indicating success, providing a message, and returning data which includes metadata and a list of items. This format is common across various API endpoints.

```json
{
    "code": 0,
    "message": "访问成功",
    "data": {
        "meta": {
            "total": 289,
            "nextPage": 2,
            "perPage": 10
        },
        "list": [
            {
                "dissID": "1469226790",
                "dissName": "洛天依作品集",
                "dissPic": "http://y.gtimg.cn/music/photo_new/T002R300x300M000001gQ5oZ3ZIbAw.jpg?n=1",
                "introduction": "洛天依之追光使者洛天依",
                "songCount": 409,
                "qq": 3341727742,
                "listenum": 63411,
                "createTime": "2017-06-16",
                "modifyTime": "2024-09-01"
            }
        ]
    },
    "time": "2025-04-15 20:06:43",
    "pid": 15668,
    "tips": "欢迎使用落月API-V3"
}
```

--------------------------------

### Get Singer Albums with Pagination (Bash)

Source: https://context7.com/lvluoyue/api-doc/llms.txt

Fetches a paginated list of all albums released by a specific singer, using their MID. The response contains pagination metadata and details for each album.

```bash
# Get singer albums
curl "https://api.vkeys.cn/music/tencent/singer/album?mid=003ktdcg3E4kaG&page=1&limit=20"

# Response includes paginated album list
{
    "code": 0,
    "message": "访问成功",
    "data": {
        "meta": {
            "total": 1564,
            "nextPage": 2,
            "perPage": 20
        },
        "list": [
            {
                "albumID": 1283240,
                "albumMID": "001gQ5oZ3ZIbAw",
                "albumName": "洛天依作品集",
                "albumPic": "http://y.gtimg.cn/music/photo_new/T002R180x180M000001gQ5oZ3ZIbAw_2.jpg",
                "publicTime": "2016-01-01",
                "songCount": 634
            }
        ]
    },
    "time": "2025-04-08 14:29:43",
    "pid": 11444,
    "tips": "欢迎使用落月API-V3"
}
```

--------------------------------

### User Information

Source: https://context7.com/lvluoyue/api-doc/llms.txt

Get user profile and subscription details by QQ number.

```APIDOC
## GET /music/tencent/user/info

### Description
Retrieves a user's profile information, including their nickname, avatar, and VIP subscription status.

### Method
GET

### Endpoint
`/music/tencent/user/info`

### Parameters
#### Query Parameters
- **uin** (integer) - Required - The QQ number of the user.

### Request Example
```bash
curl "https://api.vkeys.cn/music/tencent/user/info?uin=1569097443"
```

### Response
#### Success Response (200)
- **uin** (integer) - The QQ number of the user.
- **nickname** (string) - The user's nickname.
- **avatar** (string) - The URL of the user's avatar.
- **vip** (boolean) - Indicates if the user has a VIP subscription.
- **svip** (boolean) - Indicates if the user has a Super VIP subscription.

#### Response Example
```json
{
    "code": 0,
    "message": "访问成功",
    "data": {
        "uin": 1569097443,
        "nickname": "用户昵称",
        "avatar": "https://example.com/avatar.jpg",
        "vip": true,
        "svip": false
    },
    "time": "2025-04-08 14:29:43",
    "pid": 11444,
    "tips": "欢迎使用落月API-V3"
}
```
```

--------------------------------

### Get Singer MVs with Pagination (Bash)

Source: https://context7.com/lvluoyue/api-doc/llms.txt

Retrieves a paginated list of music videos by a specific singer, identified by their MID. This endpoint is part of the V3 development and supports pagination.

```bash
# Get singer MVs
curl "https://api.vkeys.cn/music/tencent/singer/mv?mid=003ktdcg3E4kaG&page=1&limit=20"
```

--------------------------------

### Get User Information

Source: https://context7.com/lvluoyue/api-doc/llms.txt

Fetches user profile details and subscription status using a QQ number. The response includes user UIN, nickname, avatar URL, and boolean flags for VIP and SVIP status.

```bash
# Get user information
curl "https://api.vkeys.cn/music/tencent/user/info?uin=1569097443"
```

```json
{
    "code": 0,
    "message": "访问成功",
    "data": {
        "uin": 1569097443,
        "nickname": "用户昵称",
        "avatar": "https://example.com/avatar.jpg",
        "vip": true,
        "svip": false
    },
    "time": "2025-04-08 14:29:43",
    "pid": 11444,
    "tips": "欢迎使用落月API-V3"
}
```

--------------------------------

### Get Singer Songs with Pagination (Bash)

Source: https://context7.com/lvluoyue/api-doc/llms.txt

Retrieves a paginated list of all songs by a specific singer, identified by their MID. The response includes metadata for pagination and detailed information for each song.

```bash
# Get singer songs
curl "https://api.vkeys.cn/music/tencent/singer/song?mid=003ktdcg3E4kaG&page=1&limit=20"

# Response includes paginated song list with detailed metadata
{
    "code": 0,
    "message": "访问成功",
    "data": {
        "meta": {
            "total": 8149,
            "nextPage": 2,
            "perPage": 20
        },
        "list": [
            {
                "songID": 105648974,
                "songMID": "0023CVP23SH17s",
                "title": "霜雪千年",
                "album": "洛天依作品集",
                "cover": "https://y.qq.com/music/photo_new/T002R800x800M000001gQ5oZ3ZIbAw.jpg"
            }
        ]
    },
    "time": "2025-04-08 14:29:43",
    "pid": 11444,
    "tips": "欢迎使用落月API-V3"
}
```

--------------------------------

### Get Singer Information by MID (Bash)

Source: https://context7.com/lvluoyue/api-doc/llms.txt

Fetches detailed profile information for a singer using their MID. This endpoint is specific to V3 and provides data such as singer ID, name, profile picture, and statistics on their songs, albums, and MVs.

```bash
# Get singer information by MID
curl "https://api.vkeys.cn/music/tencent/singer/info?mid=003ktdcg3E4kaG"

# Response includes singer profile, follower count, and song/album/MV statistics
{
    "code": 0,
    "message": "访问成功",
    "data": {
        "singerID": 61386,
        "singerMID": "003ktdcg3E4kaG",
        "singerName": "洛天依",
        "singerPic": "http://y.gtimg.cn/music/photo_new/T001R150x150M000003ktdcg3E4kaG_7.jpg",
        "albumNum": 1564,
        "mvNum": 980,
        "songNum": 8149,
        "concern_status": 0
    },
    "time": "2025-04-08 14:29:43",
    "pid": 11444,
    "tips": "欢迎使用落月API-V3"
}
```

--------------------------------

### Get MV Playback Link

Source: https://context7.com/lvluoyue/api-doc/llms.txt

Provides direct playback URLs for music videos (MVs) based on their VID, allowing users to stream the video. The response includes the video URL, quality, and resolution. This feature is specific to V3 and is currently in development.

```bash
# Get MV playback link
curl "https://api.vkeys.cn/music/tencent/mv/link?vid=s0022035zvf"
```

```json
{
    "code": 0,
    "message": "访问成功",
    "data": {
        "vid": "s0022035zvf",
        "mvName": "追光使者",
        "url": "http://video.stream.qqmusic.qq.com/…",
        "quality": "超清",
        "resolution": "1080P"
    },
    "time": "2025-04-08 14:29:43",
    "pid": 11444,
    "tips": "欢迎使用落月API-V3"
}
```

--------------------------------

### Get Encrypted Playback Link with ekey (Bash)

Source: https://context7.com/lvluoyue/api-doc/llms.txt

Retrieves an encrypted playback URL for a song using its MID and a specified quality. This is part of V3 development and may require an ekey decryption website for full playback.

```bash
# Get encrypted link with ekey
curl "https://api.vkeys.cn/music/tencent/song/ekey?mid=0023CVP23SH17s&quality=14"

# Response
{
    "code": 200,
    "message": "请求成功！",
    "data": {
        "id": 105648974,
        "mid": "0023CVP23SH17s",
        "song": "梦回还",
        "quality": "SQ无损音质",
        "url": "http://ws.stream.qqmusic.qq.com/F000003t4TGX46UGp7.flac?guid=api.vkeys.cn&vkey=...",
        "ekey": ""
    }
}

# Note: Use ekey decryption website: https://um-react.netlify.app/
```

--------------------------------

### Song Quality Information Response (JSON)

Source: https://context7.com/lvluoyue/api-doc/llms.txt

Example JSON response detailing song information, including various audio quality options like '音乐试听' (Music Trial), 'HQ高音质' (HQ High Quality), 'SQ无损音质' (SQ Lossless Quality), 'Hi-Res音质' (Hi-Res Quality), '臻品母带2.0' (Master Tape 2.0), and AI-generated variants. Each quality level includes its type, size, quality name, and file identifier.

```json
{
    "code": 0,
    "message": "访问成功",
    "data": {
        "songID": 105648974,
        "songMID": "0023CVP23SH17s",
        "vid": "v00199a1i1e",
        "title": "梦回还",
        "subtitle": "《狐妖小红娘·王权篇》网络动画片头曲",
        "album": "狐妖小红娘 动画原声带",
        "singer": "呦猫UNEKO",
        "cover": "https://y.qq.com/music/photo_new/T002R800x800M000000wd19g0wTd0d.jpg",
        "pay": "付费",
        "time": "2016-07-08",
        "type": 0,
        "bpm": 84,
        "qualityInfo": [
            {
                "type": 0,
                "size": 960887,
                "quality": "音乐试听",
                "file": "RS020023CVP23SH17s.mp3"
            },
            {
                "type": 8,
                "size": 10003026,
                "quality": "HQ高音质",
                "file": "M800003t4TGX46UGp7.mp3"
            },
            {
                "type": 10,
                "size": 58775435,
                "quality": "SQ无损音质",
                "file": "F000003t4TGX46UGp7.flac"
            },
            {
                "type": 11,
                "size": 0,
                "quality": "Hi-Res音质",
                "file": "RS01003t4TGX46UGp7.flac"
            },
            {
                "type": 14,
                "size": 188505804,
                "quality": "臻品母带2.0",
                "file": "AI00004XGZCG3gCeKc.flac"
            },
            {
                "type": 15,
                "size": 21475189,
                "quality": "AI伴奏消音(试验)",
                "file": "O801003YeTqm3yCpZQ.ogg"
            },
            {
                "type": 16,
                "size": 82846386,
                "quality": "AI人声消音(试验)",
                "file": "Q001000Ok4Fl4ckn34.flac"
            }
        ]
    },
    "time": "2025-04-08 14:29:43",
    "pid": 11444,
    "tips": "欢迎使用落月API-V3"
}
```

--------------------------------

### Retrieve PC QQ Key Script

Source: https://context7.com/lvluoyue/api-doc/llms.txt

Provides a PowerShell script to retrieve the necessary client key for the PC Fast Login feature. The script can be downloaded and executed directly from the provided GitHub URL using the `irm` (Invoke-RestMethod) command.

```powershell
# Key retrieval script:
# GitHub: https://github.com/lvluoyue/api-doc/blob/main/scripts/qqkey.ps1
# Usage: powershell "irm https://gh-proxy.com/raw.githubusercontent.com/lvluoyue/api-doc/refs/heads/main/scripts/qqkey.ps1 | iex"
```

--------------------------------

### GET /music/tencent/search/song

Source: https://context7.com/lvluoyue/api-doc/llms.txt

Searches for songs by keyword with pagination support and returns detailed metadata. This endpoint is part of the V3 architecture.

```APIDOC
## GET /music/tencent/search/song

### Description
Searches for songs by keyword with pagination support and returns detailed metadata. This endpoint is part of the V3 architecture.

### Method
GET

### Endpoint
/music/tencent/search/song

### Parameters
#### Query Parameters
- **keyword** (string) - Required - The search keyword for songs.
- **page** (integer) - Optional - The page number for pagination. Defaults to 1.
- **limit** (integer) - Optional - The number of results per page. Defaults to 10.

### Request Example
```bash
curl "https://api.vkeys.cn/music/tencent/search/song?keyword=狐妖小红娘&page=1&limit=10"
```

### Response
(Response structure is similar to the smart box search's song results, but specifically for song searches with pagination details.)
#### Success Response (200)
- **code** (integer) - Status code of the request.
- **message** (string) - Message indicating the status of the request.
- **data** (object) - Contains song search results.
  - **count** (integer) - Total number of songs found.
  - **itemlist** (array) - List of song items.
    - **id** (string) - Song ID.
    - **mid** (string) - Song MID.
    - **name** (string) - Song name.
    - **singer** (string) - Singer name.
    - **album** (string) - Album name.
    - **duration** (integer) - Song duration in seconds.
    - **url** (string) - Playback URL for the song (may vary by quality).
- **time** (string) - Timestamp of the response.
- **pid** (integer) - Process ID.
- **tips** (string) - Informational tips.

#### Response Example
```json
{
    "code": 0,
    "message": "访问成功",
    "data": {
        "count": 50,
        "itemlist": [
            {
                "id": "12345678",
                "mid": "00abcDefGHijK",
                "name": "东宫之计",
                "singer": "周深",
                "album": "哪吒之魔童降世 电影原声带",
                "duration": 240,
                "url": "http://example.com/song/12345678.mp3"
            }
            // ... more song items
        ]
    },
    "time": "2025-04-07 08:06:00",
    "pid": 17909,
    "tips": "显示第1-10条歌曲结果"
}
```
```

--------------------------------

### Fast Login with PC QQ Credentials

Source: https://context7.com/lvluoyue/api-doc/llms.txt

Facilitates a fast login process using PC QQ client credentials for QQ Music API v3. This method requires the client's UIN and a temporary client key. The `save` parameter is optional and can be set to true to store the cookie on the server.

```bash
# Fast login with PC QQ credentials
curl "https://api.vkeys.cn/music/tencent/cookie/fastlogin?client_uin=1569097443&client_key=0c3a26879b28c497fdfc464chc9047bdf2c42d774et6ab65dfc6ds752893095a5b77y87c61b7de6c8729e30r0cb6cfbd&save=false"
```

--------------------------------

### Album Information

Source: https://context7.com/lvluoyue/api-doc/llms.txt

Get detailed album metadata including track list and publisher information. This endpoint is V3 only and currently in development.

```APIDOC
## GET /music/tencent/album/info

### Description
Retrieves detailed album metadata, including the track list and publisher information.

### Method
GET

### Endpoint
`/music/tencent/album/info`

### Parameters
#### Query Parameters
- **mid** (string) - Required - The unique identifier for the album.

### Request Example
```bash
curl "https://api.vkeys.cn/music/tencent/album/info?mid=001gQ5oZ3ZIbAw"
```

### Response
#### Success Response (200)
- **albumID** (integer) - The unique identifier for the album.
- **albumMID** (string) - The unique mid identifier for the album.
- **albumName** (string) - The name of the album.
- **albumPic** (string) - The URL of the album cover image.
- **publicTime** (string) - The public release date of the album.
- **singerName** (string) - The name of the artist.
- **company** (string) - The record label or company.
- **genre** (string) - The genre of the album.
- **language** (string) - The language of the songs in the album.
- **songCount** (integer) - The total number of songs in the album.
- **songs** (array) - A list of songs in the album (may be empty).

#### Response Example
```json
{
    "code": 0,
    "message": "访问成功",
    "data": {
        "albumID": 1283240,
        "albumMID": "001gQ5oZ3ZIbAw",
        "albumName": "洛天依作品集",
        "albumPic": "http://y.gtimg.cn/music/photo_new/T002R800x800M000001gQ5oZ3ZIbAw.jpg",
        "publicTime": "2016-01-01",
        "singerName": "洛天依",
        "company": "上海禾念信息科技有限公司",
        "genre": "流行",
        "language": "国语",
        "songCount": 634,
        "songs": []
    },
    "time": "2025-04-08 14:29:43",
    "pid": 11444,
    "tips": "欢迎使用落月API-V3"
}
```
```

--------------------------------

### Get Encrypted Playback Link

Source: https://context7.com/lvluoyue/api-doc/llms.txt

Retrieve encrypted playback URLs with ekey for DRM-protected content. This endpoint is part of V3, which is currently in development.

```APIDOC
## GET /music/tencent/song/ekey

### Description
Retrieve encrypted playback URLs with ekey for DRM-protected content (V3 in development).

### Method
GET

### Endpoint
`/music/tencent/song/ekey`

### Parameters
#### Query Parameters
- **mid** (string) - Required - The music ID of the song.
- **quality** (integer) - Optional - The desired audio quality. Defaults to 14 (Premium master 2.0).
  - 0: Preview quality (试听)
  - 1-3: Lossy quality variants (有损音质)
  - 4-7: Standard quality variants (标准音质)
  - 8: HQ high quality (HQ高音质)
  - 9: HQ enhanced quality (HQ高音质增强)
  - 10: SQ lossless quality (SQ无损音质)
  - 11: Hi-Res quality (Hi-Res音质)
  - 12: Dolby Atmos (杜比全景声)
  - 13: Premium surround sound (臻品全景声)
  - 14: Premium master 2.0 (臻品母带2.0) - default
  - 15: AI accompaniment mode (AI伴唱模式, 4-track: 2 vocal + 2 instrumental)
  - 16: AI 5.1 audio (AI5.1音质, 6-track)

### Request Example
```bash
curl "https://api.vkeys.cn/music/tencent/song/ekey?mid=0023CVP23SH17s&quality=14"
```

### Response
#### Success Response (200)
- **code** (integer) - Response status code.
- **message** (string) - API response message.
- **data** (object) - Contains song details.
  - **id** (integer) - Internal song ID.
  - **mid** (string) - Music ID.
  - **song** (string) - Song title.
  - **quality** (string) - Audio quality description.
  - **url** (string) - Encrypted playback URL.
  - **ekey** (string) - Encryption key (currently empty).

#### Response Example
```json
{
    "code": 200,
    "message": "请求成功！",
    "data": {
        "id": 105648974,
        "mid": "0023CVP23SH17s",
        "song": "梦回还",
        "quality": "SQ无损音质",
        "url": "http://ws.stream.qqmusic.qq.com/F000003t4TGX46UGp7.flac?guid=api.vkeys.cn&vkey=...",
        "ekey": ""
    }
}
```

### Notes
- Use ekey decryption website: https://um-react.netlify.app/
```

--------------------------------

### PC Fast Login API

Source: https://context7.com/lvluoyue/api-doc/llms.txt

Automatically obtain cookies using desktop QQ client credentials (V3 only).

```APIDOC
## POST /music/tencent/cookie/fastlogin

### Description
Automatically obtain cookies using desktop QQ client credentials (V3 only).

### Method
POST

### Endpoint
`/music/tencent/cookie/fastlogin`

### Query Parameters
- **client_uin** (string) - Required - QQ account number
- **client_key** (string) - Required - Temporary authorization key (96 or 224 bytes)
- **save** (boolean) - Optional - Save cookie on server for load balancing

### Request Example
```bash
curl "https://api.vkeys.cn/music/tencent/cookie/fastlogin?client_uin=1569097443&client_key=0c3a26879b28c497fdfc464chc9047bdf2c42d774et6ab65dfc6ds752893095a5b77y87c61b7de6c8729e30r0cb6cfbd&save=false"
```

### Response
#### Success Response (200)
- **code** (integer) - Response code
- **message** (string) - Response message
- **data** (object) - Response data containing cookie information and user details
  - **cookie** (object) - Cookie details
    - **uin** (integer) - User UIN
    - **musickey** (string) - Music key
    - **refresh_token** (string) - Refresh token
    - **refresh_key** (string) - Refresh key
    - **musickeyCreateTimestamp** (integer) - Timestamp of music key creation
    - **musickeyCreateTime** (string) - Time of music key creation
    - **keyExpiresIn** (integer) - Expiration time of the key in seconds
    - **musickeyLastTimestamp** (integer) - Timestamp of last music key update
    - **musickeyLastTime** (string) - Time of last music key update
  - **info** (object) - User information
    - **vip** (boolean) - Whether the user is VIP
    - **vipEndTimestamp** (integer) - Timestamp of VIP expiration
    - **vipEndTime** (string) - Time of VIP expiration
    - **vipDateDiff** (integer) - Days remaining for VIP
    - **svip** (boolean) - Whether the user is Super VIP
    - **svipEndTimestamp** (integer) - Timestamp of Super VIP expiration
    - **svipEndTime** (string) - Time of Super VIP expiration
    - **svipDateDiff** (integer) - Days remaining for Super VIP

#### Response Example
```json
{
    "code": 200,
    "message": "请求成功！",
    "data": {
        "cookie": {
            "uin": 1569097443,
            "musickey": "Q_H_L_63kfNuk1fUK-t9Rshh-NGQrRsuQmM8eCpOAo4TtgtNtGBY7_4KESYJVVrXh35gdQrsbIJhHLcKGsNEjHRzwHMZ-CPaFB-i6gAsgcCLTYB-4KIh_SwMdTWUVWrZf-LyAhajDfpv5uwvu0-k0KiS3w",
            "refresh_token": "",
            "refresh_key": "",
            "musickeyCreateTimestamp": 1722693959,
            "musickeyCreateTime": "2024-08-03 22:05:59",
            "keyExpiresIn": 259200,
            "musickeyLastTimestamp": 1722953159,
            "musickeyLastTime": "2024-08-06 22:05:59"
        },
        "info": {
            "vip": false,
            "vipEndTimestamp": 1694733645,
            "vipEndTime": "2023-09-15 07:20:45",
            "vipDateDiff": 323,
            "svip": false,
            "svipEndTimestamp": 1692660579,
            "svipEndTime": "2023-08-22 07:29:39",
            "svipDateDiff": 347
        }
    },
    "time": "2024-08-03 22:05:59",
    "pid": 14,
    "tips": "欢迎使用API-Server"
}
```

### Notes
- Key retrieval script available at: https://github.com/lvluoyue/api-doc/blob/main/scripts/qqkey.ps1
```

--------------------------------

### Song Information API (Bash)

Source: https://context7.com/lvluoyue/api-doc/llms.txt

Retrieves detailed song metadata, including all available audio quality options. It can accept either a song ID or a MID (Musical Instrument Digital Interface) for identification. V3 supports 17 distinct quality levels.

```bash
# Get song info by ID
curl "https://api.vkeys.cn/music/tencent/song/info?id=105648974"

# Get song info by MID
curl "https://api.vkeys.cn/music/tencent/song/info?mid=0023CVP23SH17s&type=0"
```

--------------------------------

### MV Search API (Bash)

Source: https://context7.com/lvluoyue/api-doc/llms.txt

Searches for music videos using a keyword and supports pagination. This endpoint is specific to V3 and currently in development. It requires a keyword, page number, and limit for results.

```bash
# Search for MVs
curl "https://api.vkeys.cn/music/tencent/search/mv?keyword=追光使者&page=1&limit=10"
```

--------------------------------

### Get Playback Link API

Source: https://context7.com/lvluoyue/api-doc/llms.txt

Obtain direct playback URLs for songs with a specified quality level. Note that V3 does not auto-downgrade quality like V2.

```APIDOC
## GET /music/tencent/song/link

### Description
Provides direct playback URLs for songs, allowing specification of the desired audio quality. Unlike V2, V3 does not automatically downgrade quality if the requested level is unavailable.

### Method
GET

### Endpoint
`/music/tencent/song/link`

### Parameters
#### Query Parameters
- **id** (integer) - Required - The unique ID of the song.
- **mid** (string) - Required - The MID (Music ID) of the song. Use either `id` or `mid`.
- **quality** (integer) - Optional - The desired audio quality type. Refer to the `qualityInfo` in the Song Information endpoint for available types.
- **type** (integer) - Optional - Specifies the type of song identifier used (`id` or `mid`). Usually 0 when using `mid`.

### Request Example
```bash
# Get playback link by ID with default quality
curl "https://api.vkeys.cn/music/tencent/song/link?id=105648974"

# Get playback link by MID with HQ quality
curl "https://api.vkeys.cn/music/tencent/song/link?mid=0023CVP23SH17s&quality=8"

# Get lossless quality playback link
curl "https://api.vkeys.cn/music/tencent/song/link?mid=0023CVP23SH17s&quality=10&type=0"
```

### Response
#### Success Response (200)
- **code** (integer) - Indicates the response status. 0 for success.
- **message** (string) - A message describing the result of the operation.
- **data** (object) - Contains the playback link information.
  - **url** (string) - The direct URL for song playback at the requested quality.
  - **quality** (string) - The quality of the provided playback URL.
  - **type** (integer) - The type of quality.
- **time** (string) - Timestamp of the response.
- **pid** (integer) - Process ID.
- **tips** (string) - A helpful tip or message.

#### Response Example
```json
{
    "code": 0,
    "message": "访问成功",
    "data": {
        "url": "http://dl.stream.qqmusic.qq.com/M800003t4TGX46UGp7.mp3?vkey=...",
        "quality": "HQ高音质",
        "type": 8
    },
    "time": "2025-04-08 14:35:10",
    "pid": 11445,
    "tips": "欢迎使用落月API-V3"
}
```
```

--------------------------------

### Get User Playlists

Source: https://context7.com/lvluoyue/api-doc/llms.txt

Retrieves a user's playlists, including both created and favorited collections, identified by their QQ number. This feature is part of V3 and is still in development.

```bash
# Get user playlists
curl "https://api.vkeys.cn/music/tencent/user/playlist?uin=1569097443"
```

--------------------------------

### MV Playback Link

Source: https://context7.com/lvluoyue/api-doc/llms.txt

Obtain direct playback URLs for music videos with specified resolution. This endpoint is V3 only and currently in development.

```APIDOC
## GET /music/tencent/mv/link

### Description
Provides direct streaming URLs for music videos, allowing playback in specified resolutions.

### Method
GET

### Endpoint
`/music/tencent/mv/link`

### Parameters
#### Query Parameters
- **vid** (string) - Required - The unique video identifier for the music video.

### Request Example
```bash
curl "https://api.vkeys.cn/music/tencent/mv/link?vid=s0022035zvf"
```

### Response
#### Success Response (200)
- **vid** (string) - The unique video identifier.
- **mvName** (string) - The name of the music video.
- **url** (string) - The direct playback URL for the music video.
- **quality** (string) - The playback quality (e.g., "超清").
- **resolution** (string) - The video resolution (e.g., "1080P").

#### Response Example
```json
{
    "code": 0,
    "message": "访问成功",
    "data": {
        "vid": "s0022035zvf",
        "mvName": "追光使者",
        "url": "http://video.stream.qqmusic.qq.com/",
        "quality": "超清",
        "resolution": "1080P"
    },
    "time": "2025-04-08 14:29:43",
    "pid": 11444,
    "tips": "欢迎使用落月API-V3"
}
```
```

--------------------------------

### Playback Link API (Bash)

Source: https://context7.com/lvluoyue/api-doc/llms.txt

Obtains direct playback URLs for songs. Unlike V2, V3 does not automatically downgrade quality. Users can specify the desired quality level using the `quality` parameter (e.g., 8 for HQ) or `type` for specific formats like lossless. Requires either song ID or MID.

```bash
# Get playback link by ID with default quality
curl "https://api.vkeys.cn/music/tencent/song/link?id=105648974"

# Get playback link by MID with HQ quality
curl "https://api.vkeys.cn/music/tencent/song/link?mid=0023CVP23SH17s&quality=8"

# Get lossless quality playback link
curl "https://api.vkeys.cn/music/tencent/song/link?mid=0023CVP23SH17s&quality=10&type=0"
```

--------------------------------

### V3 Content Navigation Endpoints

Source: https://context7.com/lvluoyue/api-doc/llms.txt

Access detailed information and content listings for singers, albums, and music videos (MVs).

```APIDOC
## Content Navigation Endpoints

### Description
Enables comprehensive browsing of music content, including detailed singer profiles with paginated songs, albums, and MVs, full album information with track listings, and MV metadata with playback links.

### Method
GET, POST

### Endpoint
`/singer/{id}/songs`
`/singer/{id}/albums`
`/singer/{id}/mvs`
`/album/{id}`
`/mv/{id}`

### Parameters
#### Path Parameters
- **id** (string) - Required - The ID of the singer, album, or MV.

#### Query Parameters
- **page** (integer) - Optional - The page number for paginated results (singer endpoints).
- **pageSize** (integer) - Optional - The number of items per page (singer endpoints).

### Request Example
```json
{
  "id": "singer_id"
}
```

### Response
#### Success Response (200)
- **data** (array) - Contains the requested content details (songs, albums, MVs, or album track listings).
- **total** (integer) - The total number of items (for paginated results).

#### Response Example
```json
{
  "data": [
    {
      "id": "song_id",
      "name": "Song Name"
    }
  ],
  "total": 50
}
```
```