获取任务列表

GET /v1/tasks

返回当前账号通过 /v1/tasks 创建的任务，按 created 倒序。

请求头

Authorization Bearer YOUR_API_KEY 必填

账号 API Key，所有请求必填。

仅返回 API Key 所在账号的任务——请求头完整规则见统一异步接口介绍。

查询参数

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

# 发起请求，返回 JSON 结果
# 把 YOUR_API_KEY 换成你的账号 API Key
curl -X GET "https://api.hiapi.ai/v1/tasks?page=1&size=20" \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

# 发起请求，返回 JSON 结果
# 把 YOUR_API_KEY 换成你的账号 API Key
resp = requests.get(
    "https://api.hiapi.ai/v1/tasks?page=1&size=20",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)
print(resp.json())  # 打印返回的 JSON

// 发起请求，返回 JSON 结果
// 把 YOUR_API_KEY 换成你的账号 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()); // 打印返回的 JSON

page int 可选

页码，>= 1。

默认 1

size int 可选

每页条数，1 ≤ size ≤ 100。

默认 10

page / size 超出范围会被服务端归一化为默认值。

使用建议

列表接口适合控制台展示、对账与批量补漏；查询单个任务的实时状态请用获取任务详情，等待终态用回调。
全量遍历：响应中的 total 为总条数，按 page 递增拉取，直到 page * size >= total。
列表按 created 倒序，新任务始终在第一页；遍历期间有新任务创建时，翻页可能出现重复项，请按 taskId 去重。

响应

{
  "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
      }
    ]
  }
}