Lyrics Generation

POST

/open-apis/v1/lyrics/generate

Enter keywords to generate lyrics.

Request

Header Params

Authorization

string

required

API Key

Example:

Tempo-********************************-3w

Content-Type

string

required

Example:

application/json; charset=utf-8

Body Params application/json

prompt

string

required

Prompt text for lyrics generation

song_model

string | null

optional

Upload the name of the adapted Song model

TemPolor v3

TemPolor v3.5

callback_url

string

required

Callback URL for when the task is successfully generated. This needs to be developed by the partner. It will be called to notify upon task completion.

Example

{
    "prompt": "Genre: Electronic Dance Music (EDM), House, Techno  Style: Instrumental, Beat-driven, Club-oriented  Mood: Energetic, Vibrant, Hypnotic ",
    "song_model": "TemPolor v3.5",
    "callback_url": "https://**************/callback"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/open-apis/v1/lyrics/generate' \
--header 'Authorization: Tempo-********************************-3w' \
--header 'Content-Type: application/json; charset=utf-8' \
--data-raw '{
    "prompt": "Genre: Electronic Dance Music (EDM), House, Techno  Style: Instrumental, Beat-driven, Club-oriented  Mood: Energetic, Vibrant, Hypnotic ",
    "song_model": "TemPolor v3.5",
    "callback_url": "https://**************/callback"
}'

Responses

🟢200OK

application/json

Body

status

integer

required

Response status code

message

string

required

Description of the response result

request_id

string

required

The unique ID for this request, can be used to contact customer service for troubleshooting, etc.

data

object

required

Specific return results

item_ids

array[string]

required

List of item IDs generated by the submitted task

Example

{
    "status": 200000,
    "message": "success",
    "request_id": "b072a68c-4c1b-41be-bdd1-0a0309754de7",
    "data": {
        "item_ids": [
            "123"
        ]
    }
}

Query Task Status

Callback Interface