接口
POST /api/v1/tasks
请求参数
| 字段 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
page | integer | 否 | 页码，默认 1。 |
page_size | integer | 否 | 每页条数，默认 20，最大 100。 |
status | integer | 否 | 按状态筛选。-1 = 全部（默认）。见下方状态值。 |
状态筛选值
| 值 | 状态 |
|---|---|
-1 | 全部（默认） |
0 | 排队中 |
1 | 处理中 |
2 | 已完成 |
3 | 已失败 |
响应
{
"code": 0,
"message": "ok",
"request_id": "req-1710000000000",
"data": {
"items": [
{
"id": "64f3a1b2c8d9e0f1a2b3c4d5",
"status": "completed",
"created_at": 1710000000000
},
{
"id": "64f3a1b2c8d9e0f1a2b3c4d6",
"status": "processing",
"created_at": 1709999900000
}
],
"total": 42,
"page": 1
}
}
| 字段 | 类型 | 说明 |
|---|---|---|
items | array | 当前页的任务摘要列表 |
total | integer | 符合筛选条件的任务总数 |
page | integer | 当前页码 |
任务对象字段
| 字段 | 类型 | 说明 |
|---|---|---|
id | string | 任务 ID |
status | string | 任务状态字符串 |
created_at | integer | Unix 时间戳（毫秒） |
error | string | 仅在 failed 任务中存在 |
本接口仅返回任务摘要，不包含
results。需要查询音乐结果时，请用指定任务 ID 调用 获取任务 接口。示例
curl -X POST https://api.example.com/api/v1/tasks \
-H "Authorization: Bearer sk-mm-your-key" \
-H "Content-Type: application/json" \
-d '{
"page": 1,
"page_size": 20,
"status": -1
}'