跳转到主要内容

​
接口

POST /api/v1/tasks
返回当前 AppKey 创建的任务分页列表，按创建时间倒序排列（最新的在前）。

​
请求参数

字段类型是否必填说明
pageinteger否页码，默认 1。
page_sizeinteger否每页条数，默认 20，最大 100。
statusinteger否按状态筛选。-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
  }
}
字段类型说明
itemsarray当前页的任务摘要列表
totalinteger符合筛选条件的任务总数
pageinteger当前页码

​
任务对象字段

字段类型说明
idstring任务 ID
statusstring任务状态字符串
created_atintegerUnix 时间戳（毫秒）
errorstring仅在 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
  }'