---
title: "列出 API Key（需网站登录，Key 不能管理 Key）/ List keys (website session only)"
method: GET
path: "/v1/api-keys"
tags: ["Keys"]
---

# 列出 API Key（需网站登录，Key 不能管理 Key）/ List keys (website session only)

`GET /v1/api-keys`

## Request

- Base URL: `https://api.musicsforyou.com`
- URL: `https://api.musicsforyou.com/v1/api-keys`
- Auth: 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

- ApiKeysResponse
  - `success` true, required
  - `keys` ApiKey[], required
    - `id` string, required
    - `name` string, required
    - `prefix` string, required: 例如 ty_live_ab12cd… / Masked prefix
    - `lastUsedAt` string, date-time, nullable, required
    - `createdAt` string, date-time, required
    - `webhookUrl` string, uri, nullable: 完成回调地址 / Completion webhook URL

## Other responses

- `401`: 未登录或 Key 无效 / Not authenticated（LOGIN_REQUIRED、INVALID_API_KEY）
- `403`: API Key 不能管理 API Key / Keys cannot manage keys

---

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