Skip to main content

​
Endpoint

POST /api/v1/tasks
Returns a paginated list of tasks created by your AppKey, ordered by creation time (newest first).

​
Request body

FieldTypeRequiredDescription
pageintegerNoPage number. Default 1.
page_sizeintegerNoItems per page. Default 20, max 100.
statusintegerNoFilter by status. -1 = all (default). See status codes below.

​
Status filter values

ValueStatus
-1All statuses (default)
0Queuing
1Processing
2Completed
3Failed

​
Response

{
  "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
  }
}
FieldTypeDescription
itemsarrayTask summary objects for this page
totalintegerTotal number of tasks matching the filter
pageintegerCurrent page number

​
Item fields

FieldTypeDescription
idstringTask ID
statusstringTask status string
created_atintegerUnix timestamp (ms)
errorstringPresent only on failed tasks
This endpoint returns task summaries only — no results. Call Get Task with a specific task ID to retrieve music results.

​
Example

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
  }'