---
title: "获取歌曲参与歌手"
method: GET
path: "/songs/{id}/artists"
tags: ["歌曲管理"]
---

# 获取歌曲参与歌手

`GET /songs/{id}/artists`

## Request

- Base URL: `https://localhost:58091/api/v1`
- URL: `https://localhost:58091/api/v1/songs/{id}/artists`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/songloft-org/apis/songloft-api/docs/songs/:id/artists/get.ts> (a function with typed inputs; its response is checked against the schema)

返回一首歌的全部参与歌手（含角色 artist/album_artist 与顺序）。多值歌手由此拆分展示，供前端编辑界面加载当前状态。

## Path parameters

- `id` integer, required

## Response `200`

参与歌手列表

- HandlersSongArtistsResponse
  - `artists` ModelsSongArtist[]
    - `artist` ModelsArtist
      - `created_at` string
      - `id` integer
      - `name` string
    - `position` integer: 同角色内的展示顺序
    - `role` string: artist | album_artist

## Other responses

- `400`: 无效的歌曲 ID
- `404`: 歌曲不存在

## Changes

- **2026-09-14** `8e117ed63d1a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/songloft-org/apis/songloft-api/changes/songs/:id/artists/get.md)

---

[API](https://skmtc.dev/songloft-org/apis/songloft-api.md) - [All operations](https://skmtc.dev/songloft-org/apis/songloft-api/llms.txt) - [OpenAPI document](https://skmtc.dev/songloft-org/apis/songloft-api/revisions/5b30bc01776a?raw)