TemPolor API Platform
API DocumentsTemPolor API PlatformCreate Music
API DocumentsTemPolor API PlatformCreate Music
Discord
  1. Lyrics
  • Get Started
    • Overview
    • Quickstart
    • Model and Pricing
  • API Reference
    • General Information
      • Certification Methods
      • Error Code
    • Song
      • Voice ID option table
      • Song Generation
        POST
      • Song Extension
        POST
      • Callback Interface
        POST
      • Query Task Status
        POST
    • Instrumental
      • Instrumental Generation
        POST
      • Instrumental Extension
        POST
      • Callback Interface
        POST
      • Query Task Status
        POST
    • Lyrics
      • Lyrics Generation
        POST
      • Callback Interface
        POST
      • Query Task Status
        POST
    • Audio Track Splitting
      • Create Task
        POST
      • Callback Interface
        POST
      • Query Task Status
        POST
    • Account
      • Query Information
        POST
  • Others
    • Feature List
  1. Lyrics

Query Task Status

POST
/open-apis/v1/lyrics/query
Enter item ID to query corresponding information.

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
item_ids
array[string]
required
List of task itemIDs to query, maximum 10.
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/lyrics/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
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
lyrics
array [object {4}] 
required
List of item information
Example
{
    "status": 200000,
    "message": "success",
    "request_id": "dae5cadf-71c9-4f83-b26d-8d9800367c7d",
    "data": {
        "lyrics": [
            {
                "item_id": "123",
                "status": "succeeded",
                "title": "Moonlight Whisper",
                "lyric": "[Intro]\n\n[Verse]\nThe moonlight passes through layers of clouds, gently falling on your hair\nThe streets at night are empty, only me and my shadow in long loneliness\nThoughts wander like the wind, waiting for enlightenment every moment\nUnder the starry sky, our unsaid words are hidden, so quiet it touches the heart\n\n[Verse]\nThe street corner lights reflect memories, like an unfinished movie\nThe moon hangs in the sky like an eye, witnessing the alternation of loneliness and dreams\nThe wind blows through the streets of memory, that gentle touch still in my heart\nTime passes silently, leaving everything to the fading night\n\n[Inst]\n\n[Chorus]\nThe moon is the poetry of the night, softly telling silent vows\nThe lonely brilliance illuminates the distance, the dream's appearance clear\nIn this silent moment, I quietly let my thoughts fly to the sky\nLet them drift with the starlight, merging into the boundless dark night\n\n[Chorus]\nTurning to look at the sky, it still quietly guards our secrets\nThe flowing moonlight is a gentle guide through the deep dark night\nThere is no distance between you and me, only the intertwined time of heartbeats\nLet this emotion gently echo in the wind\n\n[Inst]"
            }
        ]
    }
}
Previous
Callback Interface
Next
Create Task