Song Generation

POST

{{base_url}}/open-apis/v1/song/generate

Supports user-uploaded custom music descriptions and lyrics to generate songs. For testing the callback_url, you can configure a callback at https://webhook.site.
For details on implementing the callback_url, refer to the Music Generation Callback API.

Supports cover melody generation from a reference audio; more cover capabilities are rolling out soon.
3.The music download URL is valid for 72 hours,stream url is valid for 30 minutes

Request

Header Params

Body Params application/json

Example

{
    "prompt": "Dream Pop, shimmering synths, soft electronic beats, melancholic, dreamy, moderate tempo, ethereal female vocals, warm analog production",
    "model": "TemPolor v4.6",
    "lyrics": "[Intro: Bright fingerpicked acoustic guitar][Verse 1]...[Chorus]...[Bridge]...[Outro: Guitar fades with gentle harmonic chime]",
    "callback_url": "https://**************/callback"
}

Request Code Samples

Shell

JavaScript

Java

PHP

Python

curl --location --globoff 'https://api.tempolor.com/open-apis/v1/song/generate' \
--header 'Authorization: Tempo-********************************-3w' \
--header 'Content-Type: application/json; charset=utf-8' \
--data '{
    "prompt": "Dream Pop, shimmering synths, soft electronic beats, melancholic, dreamy, moderate tempo, ethereal female vocals, warm analog production",
    "model": "TemPolor v4.6",
    "lyrics": "[Intro: Bright fingerpicked acoustic guitar][Verse 1]...[Chorus]...[Bridge]...[Outro: Guitar fades with gentle harmonic chime]",
    "callback_url": "https://**************/callback"
}'

Responses

🟢200OK

application/json

Bodyapplication/json

Example

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

Modified at 2026-06-24 07:56:28

Error Code

Callback Interface