Skip to main content

Generate Lyrics

POST 
/api/v1/lyrics

Create lyrics for music using AI models without generating audio tracks.

Usage Guide​

  • This endpoint generates only lyrics content based on your prompt
  • Multiple lyrics variations will be returned for you to choose from
  • Generated lyrics typically include song structure markers (e.g., [Verse], [Chorus])

Developer Notes​

  1. Generated lyrics are retained for 15 days
  2. Callback has only one stage: complete (generation complete)
  3. Use this endpoint when you only need lyrics creation without music
  4. Results can be used as input for the Generate Music endpoint in custom mode

Request​

Responses​

Request successful

Callbacks​

POST 
{$request.body#/callBackUrl}

System will call this callback when lyrics generation is complete.

Callback Example​

{
  "code": 200,
  "msg": "All generated successfully.",
  "data": {
    "callbackType": "complete",
    "taskId": "11dc****8b0f",
    "lyricsData": [
      {
        "text": "[Verse]\n我穿越城市黑暗夜\n心中燃烧梦想的烈火",
        "title": "钢铁侠",
        "status": "complete",
        "errorMessage": ""
      },
      {
        "text": "[Verse]\n风在呼唤我名字\n钢铁盔甲闪得刺眼",
        "title": "钢铁侠",
        "status": "complete",
        "errorMessage": ""
      }
    ]
  }
}

Callbacks Responses​

Callback received successfully