Get API Key Get API
Docs

Generate lyrics

- Generate lyrics text based on a theme.

  • Async task: submitting returns a task_id; poll GET /v1/music/tasks/:task_id for the result
Note

This endpoint has no version dimension: do not pass version — if passed, it is discarded and does not affect billing.

Request example

curl -X POST https://api.openveer.com/v1/music/generations/lyrics \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{
    "model": "suno",
    "prompt": "A heartfelt ballad about a reunion"
  }'

Response example

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01K8SGYNNNVBQTXNR4MM964S7K"
    }
  ]
}

Authorizations

Authorization string

All endpoints require authentication using a Bearer Token

Get an API Key:

Visit the API Key management page to get your API Key

Add the following to the request headers when using it:

Authorization: Bearer YOUR_API_KEY

Body

model string

Audio model. Currently pass suno (defaults to suno if omitted).

prompt string

What description do you want for the lyrics you wish to generate, after removing leading and trailing spaces it cannot be empty.

lyrics_model string

lyrics model: classic / remi. Not provided will use the service default setting.

Note

Get Result: After submission, poll GET /v1/music/tasks/{task_id}. Prioritize reading result.lyrics[]'s text, title, and tags; also compatible with result.text, string-form result.lyrics, and historical array structure.

Response

code integer

Response status code

data array
Returned data array
status string

Task status

  * submitted - Submitted
task_id string

Unique task identifier (used to poll GET /v1/music/tasks/{task_id} for the result)

This documentation is built and hosted on Mintlify, a developer documentation platform.