查询任务列表

H3 视频任务 API · /api/v3

请求地址

GEThttps://fablun.com/api/v3/contents/generations/tasks

查询当前客户任务，按创建时间倒序。列表限额为同一账户共享 1 QPS。

查询参数	类型	默认 / 范围	说明
`page_num`	integer	1 / 1～500	页码。
`page_size`	integer	20 / 1～500	每页数量。
`filter.status`	string	可选	六种任务状态之一。
`filter.model`	string	可选	模型 ID。
`filter.task_ids`	string[]	可选 / 最多 500 个	重复传入同名查询参数。
`filter.service_tier`	string	可选	仅 default，其他值返回空列表。

请求与响应

cURL

curl --get 'https://fablun.com/api/v3/contents/generations/tasks' \
  -H "Authorization: Bearer $ARK_API_KEY" \
  --data-urlencode 'page_num=1' \
  --data-urlencode 'page_size=20' \
  --data-urlencode 'filter.status=succeeded'

JSON · 响应示例

{
  "total": 1,
  "items": [
    {
      "id": "cgt-0123456789abcdef0123456789abcdef",
      "model": "h3-pro",
      "status": "succeeded",
      "created_at": 1793600000,
      "updated_at": 1793600030,
      "content": {
        "video_url": "https://YOUR_RESULT_HOST/video.mp4?SIGNED_QUERY"
      },
      "seed": 42,
      "resolution": "480p",
      "duration": 5,
      "ratio": "16:9",
      "framespersecond": 24,
      "generate_audio": true,
      "service_tier": "default",
      "error": null
    }
  ]
}

响应字段

total 为符合筛选条件的任务总数；items 为当前页，单项结构与查询单个任务相同。