Lyrics generation and editing

Use write_full_song to write complete lyrics from a theme and style, or use edit to edit or continue existing lyrics. The structured lyrics in the response can be used directly with the music generation API.

The lyrics request body does not contain a model field.

POST/v1/lyrics_generation

Use write_full_song to create complete lyrics, or edit to edit and continue existing lyrics. This request body does not contain a model field.

Authorization

bearerAuth

AuthorizationBearer <token>

Use Bearer your-api-key in the Authorization Header.

In: header

Request Body

application/json

Lyrics creation or editing parameters.

TypeScript Definitions

Use the request body type in TypeScript.

mode*string

write_full_song creates complete lyrics; edit edits or continues existing lyrics.

Value in

"write_full_song"
"edit"

prompt?string

Theme, style, or editing instruction. When empty, content may be generated randomly.

Lengthlength <= 2000

lyrics?string

Existing lyrics used in edit mode.

Lengthlength <= 3500

title?string

Specified song title. When provided, the returned result keeps this title.

Response Body

`application/json`

curl -X POST "https://example.com/v1/lyrics_generation" \  -H "Content-Type: application/json" \  -d '{    "mode": "write_full_song",    "prompt": "An upbeat love song about a summer seaside"  }'

{
  "song_title": "A Promise in the Summer Breeze",
  "style_tags": "Mandopop, Summer Vibe, Romance, Lighthearted",
  "lyrics": "[Intro]\nSunlight shimmers across the sea\n\n[Verse]\nThe sea breeze gently brushes your hair\n...",
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}

Authorization

Request Body

Response Body

200application/json

401application/json

`application/json`

`application/json`