TemPolor API Platform
API DocumentsTemPolor API PlatformCreate Music
API DocumentsTemPolor API PlatformCreate Music
Discord
  1. Song
  • 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. Song

Query Task Status

POST
/open-apis/v1/song/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/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
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
songs
array [object {14}] 
required
List of item information
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]"
          }
        ]
      }
    ]
  }
}
Previous
Callback Interface
Next
Instrumental Generation