---
title: "Generate Lyrics"
method: POST
path: "/api/v1/lyrics"
---

# Generate Lyrics

`POST /api/v1/lyrics`

## Request body

- object
  - `prompt` string, 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.
  - `callBackUrl` string, 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](https://docs.sunoapi.org/suno-api/generate-lyrics-callbacks) - Alternatively, you can use the get lyrics generation details endpoint to poll task status

## Response `200`

Request successful

- object
  - `code` 200 | 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
  - `msg` string — Error message when code != 200
  - `data` object
    - `taskId` string — Task ID for tracking task status

## Other responses

- `500` — Server error

---

[API](https://skmtc.net/sunoapi/apis/file-upload-api.md) · [All operations](https://skmtc.net/sunoapi/apis/file-upload-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sunoapi/file-upload-api/versions/22d45ee33a4a/schema)