查询任务

查询 Flow Music 异步任务的执行状态、进度和生成结果

请求示例

bash curl --request GET \ --url https://api.openveer.com/v1/music/tasks/task_01K8AYYM6R03TGZ3Q2P0TZVNPX?language=zh \ --header 'Authorization: Bearer <token>'

```python
import requests

task_id = "task_01K8AYYM6R03TGZ3Q2P0TZVNPX"
url = f"https://api.openveer.com/v1/music/tasks/{task_id}"

headers = {
"Authorization": "Bearer "
}

params = {
"language": "zh"
}

response = requests.get(url, headers=headers, params=params)

print(response.json())
```

``javascript const taskId = "task_01K8AYYM6R03TGZ3Q2P0TZVNPX"; const url =https://api.openveer.com/v1/music/tasks/${taskId}?language=zh`;

const headers = {
"Authorization": "Bearer "
};

fetch(url, {
method: "GET",
headers: headers
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error("Error:", error));
```

响应示例

json { "code": 200, "data": { "id": "task_01K8AYYM6R03TGZ3Q2P0TZVNPX", "status": "completed", "progress": 100, "created": 1783413241, "completed": 1783413352, "actual_time": 111, "cost": 0.06, "credits_cost": 0.6, "result": { "music": [ { "clip_id": "a41aade4-993e-4d28-b56f-d97e7ef7167c", "title": "My Song", "duration_seconds": "181.70666667", "audio_url": "https://cdn.apimart.ai/audio/flowmusic_a41aade4.m4a", "wav_url": "https://cdn.apimart.ai/audio/flowmusic_a41aade4.wav" } ] } } }

json { "error": { "message": "task not found", "type": "invalid_request", "param": "task_id", "code": "task_not_found" } }

json { "error": { "message": "当前分组容量饱和，请稍后重试", "type": "rate_limit_error", "param": "", "code": "rate_limit_error" } }

鉴权

路径参数

查询参数

响应字段

结果结构

音乐类任务

生成音乐、音乐延伸、片段替换、Cover 改编、词曲分离、上传音频、下载音频和视频渲染通常返回 result.music 数组。

{
  "result": {
    "music": [
      {
        "clip_id": "a41aade4-993e-4d28-b56f-d97e7ef7167c",
        "audio_url": "https://cdn.apimart.ai/audio/flowmusic_a41aade4.m4a",
        "wav_url": "https://cdn.apimart.ai/audio/flowmusic_a41aade4.wav",
        "video_url": "https://cdn.apimart.ai/video/flowmusic_a41aade4.mp4",
        "file_url": "https://cdn.apimart.ai/audio/flowmusic_a41aade4_stems.zip"
      }
    ]
  }
}

歌词任务

生成歌词返回 result.lyrics 数组。

{
  "result": {
    "lyrics": [
      {
        "title": "Bleached",
        "lyrics": "[Intro]\n(Check)\n(One two)\n..."
      }
    ]
  }
}

使用说明