List Tasks

GET /v1/tasks

Returns the tasks the current account created via /v1/tasks, ordered by created descending.

Headers

Authorization Bearer YOUR_API_KEY required

Account API key. Required on every request.

Query parameters

GET https://api.hiapi.ai/v1/tasks?page=1&size=20

# Send the request and return the JSON result
# Replace YOUR_API_KEY with your account API key
curl -X GET "https://api.hiapi.ai/v1/tasks?page=1&size=20" \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

# Send the request and return the JSON result
# Replace YOUR_API_KEY with your account API key
resp = requests.get(
    "https://api.hiapi.ai/v1/tasks?page=1&size=20",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)
print(resp.json())  # Print the returned JSON

// Send the request and return the JSON result
// Replace YOUR_API_KEY with your account API key
const resp = await fetch("https://api.hiapi.ai/v1/tasks?page=1&size=20", {
  method: "GET",
  headers: { "Authorization": "Bearer YOUR_API_KEY" },
});
console.log(await resp.json()); // Print the returned JSON

page int optional

Page number, >= 1.

default 1

size int optional

Items per page, 1 ≤ size ≤ 100.

default 10

Out-of-range page / size are normalized to defaults server-side.

Response

{
  "code": 200,
  "message": "success",
  "data": {
    "page": 1,
    "size": 10,
    "total": 42,
    "tasks": [
      {
        "taskId": "tk-hiapi-...",
        "model": "happyhorse-1-0",
        "status": "success",
        "created": 1777282033,
        "completed": 1777282099,
        "output": [
          {
            "url": "https://cdn.hiapi.ai/tasks/.../result.mp4",
            "type": "video",
            "expireAt": 1777886899
          }
        ]
      },
      {
        "taskId": "tk-hiapi-...",
        "model": "happyhorse-1-0",
        "status": "archiving",
        "created": 1777282010,
        "completed": 0
      }
    ]
  }
}