任务状态查询 - 天谱乐开放平台

请求参数

Header 参数

Authorization

string

API密钥

必需

示例值:

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

Content-Type

string

必需

示例值:

application/json; charset=utf-8

Body 参数application/json

item_ids

array[string]

必需

需要查询的任务itemId列表，最大10。

示例

{
    "item_ids": [
        "123"
    ]
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST '/open-apis/v1/instrumental/query' \
--header 'Authorization: Tempo-********************************-3w' \
--header 'Content-Type: application/json; charset=utf-8' \
--data-raw '{
    "item_ids": [
        "123"
    ]
}'

返回响应

🟢200成功

application/json

Body

status

integer

响应状态码

必需

message

string

响应结果说明

必需

request_id

string

必需

本次请求的唯一ID、可用于联系客服排查问题等

data

object

具体的返回结果

必需

instrumentals

array [object {12}]

必需

示例

{
    "status": 200000,
    "message": "success",
    "request_id": "1165b1fc-e56d-4b55-a5d9-dbae434cd47d",
    "data": {
        "instrumentals": [
            {
                "item_id": "123",
                "status": "succeeded",
                "audio_hi_status": "sub_succeeded",
                "model": "TemPolor i3.5",
                "title": "Neon Pulse Groove",
                "prompt": "Genre: Electronic Dance Music (EDM), House, Techno  Style: Instrumental, Beat-driven, Club-oriented  Mood: Energetic, Vibrant, Hypnotic  Tempo: Typically ranges from 120 to 130 BPM (Beats Per Minute)  Structure: Build-ups, Drops, Breakdowns  Instruments/Sounds: Synthesizers, Drum Machines, Basslines, Hi-hats, Pads  Purpose: Ideal for clubs, parties, workout sessions, or background ambiance  Vibe: Uplifting, Groovy, Futuristic",
                "duration": 266,
                "created_at": 1747276813,
                "finished_at": 1747277627,
                "audio_url": "https://****",
                "audio_hi_url": "https://****",
                "style": "electronic,house,techno"
            }
        ]
    }
}