---
title: "Create lyrics overlay (auto-generates sections from song lyrics)"
method: POST
path: "/v1/video-projects/{projectId}/lyrics"
tags: ["Video Projects"]
---

# Create lyrics overlay (auto-generates sections from song lyrics)

`POST /v1/video-projects/{projectId}/lyrics`

## 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/video-projects/{projectId}/lyrics`
- Auth: none declared

## Path parameters

- `projectId` string, required

## Request body

- CreateLyricsOverlayDto
  - `songId` string, required: Song ID to generate lyrics sections from

## Response `201`

- LyricsOverlayConfigDto
  - `lyricsOverlayConfigId` string, required: Lyrics overlay config ID
  - `songId` string, required: Song ID
  - `enabled` boolean, required: Whether lyrics are enabled
  - `style` string, required: Style: subtitle | karaoke
  - `position` string, required: Position: top | center | bottom
  - `sections` object[], required
    - `id` string, required
    - `text` string, required
    - `startTime` number, required
    - `endTime` number, required

---

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