- Get Started
- API Reference
- General Information
- Song
- Instrumental
- Lyrics
- Audio Track Splitting
- Account
- Others
Query Task Status
POST
/open-apis/v1/song/query
Request
Header Params
Authorization
string
required
Example:
Tempo-********************************-3w
Content-Type
string
required
Example:
application/json; charset=utf-8
Body Params application/json
item_ids
array[string]
required
Example
{
"item_ids": [
"123"
]
}
Request samples
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/open-apis/v1/song/query' \
--header 'Authorization: Tempo-********************************-3w' \
--header 'Content-Type: application/json; charset=utf-8' \
--data-raw '{
"item_ids": [
"123"
]
}'
Responses
🟢200OK
application/json
Body
status
integer
required
message
string
required
request_id
string
required
data
object
required
songs
array [object {14}]
required
Example
{
"status": 200000,
"message": "success",
"request_id": "4b185c6f-ed37-4b7d-af15-691be79996fc",
"data": {
"songs": [
{
"item_id": "123",
"status": "succeeded",
"audio_hi_status": "sub_succeeded",
"lyrics_sections_status": "sub_succeeded",
"event": null,
"model": "TemPolor v3",
"title": "Owl's Moonlit Waltz",
"style": "Pop",
"prompt": "A Song About an Owl’s Moonlit Dance in Happy Style",
"duration": 96,
"created_at": 1747207597,
"finished_at": 1747207721,
"audio_url": "https://******",
"audio_hi_url": "https://*****",
"lyrics_sections": [
{
"start": 0.76,
"end": 0.78,
"text": "[intro]"
},
{
"start": 0.9,
"end": 0.92,
"text": "\n[verse]"
},
{
"start": 16.761,
"end": 19.75,
"text": "Under silver beams it flies"
},
{
"start": 20.361,
"end": 23.97,
"text": "Graceful wings that paint the skies"
},
{
"start": 24.502,
"end": 28.612,
"text": "Whispers soft beneath the trees"
},
{
"start": 28.662,
"end": 32.102,
"text": "Night unfolds with gentle breeze"
},
{
"start": 32.462,
"end": 32.482,
"text": "\n[chorus]"
},
{
"start": 33.342,
"end": 36.97,
"text": "Moonlight guides the silent flight"
},
{
"start": 37.622,
"end": 41.123,
"text": "Owls dance in pure delight"
},
{
"start": 41.623,
"end": 45.57,
"text": "Stars above with shining eyes"
},
{
"start": 45.863,
"end": 49.343,
"text": "Joy unfolds before sunrise"
},
{
"start": 49.823,
"end": 49.843,
"text": "\n[chorus]"
},
{
"start": 50.043,
"end": 53.21,
"text": "Moonlight guides the silent flight"
},
{
"start": 53.843,
"end": 57.48,
"text": "Owls dance in pure delight"
},
{
"start": 58.304,
"end": 61.004,
"text": "Stars above with shining eyes"
},
{
"start": 61.024,
"end": 61.964,
"text": "Joy unfolds before sunrise"
},
{
"start": 61.984,
"end": 62.004,
"text": "\n[verse]"
},
{
"start": 62.024,
"end": 63.294,
"text": "Echoes laugh through shadowed glade"
},
{
"start": 63.344,
"end": 64.244,
"text": "Every step a note is played"
},
{
"start": 64.264,
"end": 65.244,
"text": "Twilight wraps the forest deep"
},
{
"start": 65.264,
"end": 66.644,
"text": "Hearts awake from quiet sleep"
},
{
"start": 66.684,
"end": 66.704,
"text": "\n[chorus]"
},
{
"start": 66.744,
"end": 70.324,
"text": "Moonlight guides the silent flight"
},
{
"start": 71.045,
"end": 74.61,
"text": "Owls dance in pure delight"
},
{
"start": 75.025,
"end": 78.765,
"text": "Stars above with shining eyes"
},
{
"start": 79.305,
"end": 82.405,
"text": "Joy unfolds before sunrise"
},
{
"start": 92.366,
"end": 96.026,
"text": "\n[inst]"
}
]
}
]
}
}