---
title: "创建歌单"
method: POST
path: "/playlists"
tags: ["歌单管理"]
---

# 创建歌单

`POST /playlists`

创建一个新的歌单

## Request body

- ModelsPlaylist
  - `cover_url` string — 封面图片 URL
  - `created_at` string — 创建时间
  - `description` string — 歌单描述
  - `id` integer — 歌单 ID
  - `labels` string[] — 歌单标签，如 ["built_in"]
  - `name` string — 歌单名称
  - `song_count` integer — 歌曲数量
  - `type` 'normal' | 'radio' — 歌单类型：normal/radio
  - `updated_at` string — 最后更新时间

## Response `201`

创建成功

- ModelsPlaylist
  - `cover_url` string — 封面图片 URL
  - `created_at` string — 创建时间
  - `description` string — 歌单描述
  - `id` integer — 歌单 ID
  - `labels` string[] — 歌单标签，如 ["built_in"]
  - `name` string — 歌单名称
  - `song_count` integer — 歌曲数量
  - `type` 'normal' | 'radio' — 歌单类型：normal/radio
  - `updated_at` string — 最后更新时间

## Other responses

- `400` — 请求数据错误
- `500` — 创建失败

---

[API](https://skmtc.net/songloft-org/apis/songloft-api.md) · [All operations](https://skmtc.net/songloft-org/apis/songloft-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/songloft-org/songloft-api/versions/6781c074532c/schema)