List tasks

H3 video task API · /api/v3

Endpoint

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

List the current account's tasks, newest first. The listing limit is 1 QPS shared by the account.

Query parameter	Type	Default / range	Description
`page_num`	integer	1 / 1～500	Page number.
`page_size`	integer	20 / 1～500	Items per page.
`filter.status`	string	Optional	One of the six task states.
`filter.model`	string	Optional	Model ID.
`filter.task_ids`	string[]	Optional / up to 500	Repeat the same query parameter name for each value.
`filter.service_tier`	string	Optional	Only default; other values return an empty list.

Request and response

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 · Response example

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

Response fields

total is the total matching count;items is the current page, with each item using the single-task response structure.