---
title: "POST /v1/songs/v2s"
method: POST
path: "/v1/songs/v2s"
tags: ["Songs"]
---

# POST /v1/songs/v2s

`POST /v1/songs/v2s`

## Request

- Base URL: `https://api.neume.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.neume.io/v1/songs/v2s`
- Auth: none declared

## Request body

- GenerateV2sDto
  - `prompt` string, required
  - `tracks` 'drums' | 'bass' | 'guitar' | 'keyboard' | 'percussion' | 'strings' | 'synth' | 'fx' | 'brass' | 'woodwinds', required
  - `bpm` number
  - `keyscale` string
  - `outputMode` 'stems' | 'mixed'

## Response `201`

- GetSongDto
  - `songId` string, required: Song ID
  - `title` 'LIKE' | 'DISLIKE': User's reaction to the song
  - `stems` StemDto[], required: Stems
    - `songStemId` string, required: Stem ID
    - `stemType` string, required: Stem type
  - `image` string, required: Song image URL
  - `isInstrumental` boolean, required: Whether the song is instrumental
  - `isExplicit` boolean, required: If the song uses explicit language
  - `originalPrompt` string, required: Prompt used to generate the song
  - `description` string, required: Description
  - `lyrics` string, required: Song lyrics
  - `user` SongUser, required
    - `userId` string, required: User ID
    - `publicName` string, required: User public name
    - `firstName` string, required: User first name
    - `lastName` string, required: User last name
  - `lyricLines` SongLyricLine[], required: Lines of the lyrics with timestamp
    - `startTime` number, required: Start time of the line
    - `endTime` number, required: End time of the line
    - `content` string, required: Content of the line
    - `words` SongLyricLine[], required: Words of the line
  - `visibility` string, required: Song visibility status
  - `status` string, required: Song status
  - `ownership` string, required: Who owns the song
  - `kind` string, required: The kind of song
  - `playCount` number, required: Number of times the song has been played
  - `createdAt` string, date-time, required: Song creation date

---

[API](https://skmtc.dev/neume/apis/neume-api.md) · [All operations](https://skmtc.dev/neume/apis/neume-api/llms.txt) · [OpenAPI document](https://skmtc.dev/neume/apis/neume-api/revisions/ddfaa546b0be?raw)