Generate lyrics
generate_lyricsWrite song lyrics from a description, without generating audio. Useful as a first step before generate_music with custom=true, so the user can approve the words before paying for audio. Asynchronous — poll with get_task.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| prompt | Yes | Description of the lyrics to write, e.g. 'a love song about meeting someone at a coffee shop'. | |
| provider | No | Music backend: 'suno' (default) or 'producer'. | |
| lyrics_model | No | Lyrics model: classic or remi. | |
| wait_seconds | No | Poll server-side for up to this many seconds (max 240). Lyrics usually finish in under 30 seconds. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| raw | No | Full result payload when completed — clip IDs, lyrics text and per-clip metadata. Clip IDs from here are what extend_music takes. | |
| note | Yes | What to do next. | |
| status | Yes | One of: queued, in_progress, completed, failed. | |
| task_id | Yes | Pass this to get_task together with platform to check progress. | |
| platform | Yes | 'suno' or 'producer'. Pass to get_task. | |
| audio_urls | No | Finished audio URLs, when the task completed within wait_seconds. |