Sign in

v1

latestOpenAPI 3.0.02026-07-26355125.0 KB

Generate Lyrics

post/api/v1/lyrics

Request body

promptstring required

Detailed description of the desired lyrics content.

  • Be specific about themes, moods, styles, and song structure you want.
  • The more detailed your prompt, the more closely the generated lyrics will match your vision.
  • The maximum characters limit is 200 characters.
callBackUrlstring uri required

The URL to receive lyrics generation results when complete.

  • Required.
  • Unlike music generation, lyrics callback has only one stage: complete (generation finished).
  • For detailed callback format and implementation guide, see Lyrics Generation Callbacks
  • Alternatively, you can use the get lyrics generation details endpoint to poll task status

Example request

{
  "prompt": "A song about peaceful night in the city",
  "callBackUrl": "https://api.example.com/callback"
}

Response

Request successful

code200 | 400 | 401 | 404 | 405 | 413 | 429 | 430 | 455 | 500

Status Codes

  • ✅ 200 - Request successful
  • ⚠️ 400 - Invalid parameters
  • ⚠️ 401 - Unauthorized access
  • ⚠️ 404 - Invalid request method or path
  • ⚠️ 405 - Rate limit exceeded
  • ⚠️ 413 - Theme or prompt too long
  • ⚠️ 429 - Insufficient credits
  • ⚠️ 430 - Your call frequency is too high. Please try again later.
  • ⚠️ 455 - System maintenance
  • ❌ 500 - Server error
msgstring

Error message when code != 200

Example response

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "5c79****be8e"
  }
}