v1

latestOpenAPI 3.1.02026-07-26793302.3 KB

Generate lyrics

post/suno/submit/lyrics

Request body

promptstring required

Topic, theme, or description for lyrics generation. Can be a simple phrase, story concept, or specific instructions about what you want the lyrics to convey.

  • Example: "[Verse]\nA song about summer love and beach sunsets"
  • Example: "Write a romantic song about missing someone"
notify_hookstring required

Webhook URL for receiving lyrics generation completion notifications. When provided, the system sends a POST request with task results to this URL.

  • Must be a valid HTTP/HTTPS URL
  • Suitable for async processing and automated workflows

Response

Successful Response

codestring required

Business status code

datastring required

Response data

messagestring required

Message