List tasks

GET /v1/contents/generations/tasks returns your team’s Seedance tasks, newest first, in the native { total, items[] } envelope. Each item is the same normalized task object returned by Retrieve a task.

Scope: read
Auth: X-Api-Key: al_live_… or Authorization: Bearer al_live_…

This list is served entirely from your Aurous records, scoped to your team — it is never proxied to the provider (whose list is account-wide and would cross team boundaries).

cURL

curl -G https://api.aurous-labs.com/v1/contents/generations/tasks \
  -H "X-Api-Key: al_live_…" \
  --data-urlencode "page_num=1" \
  --data-urlencode "page_size=20" \
  --data-urlencode "filter.status=succeeded" \
  --data-urlencode "filter.model=seedance-2.0"

Query parameters

Parameter	Type	Notes
`page_num`	integer `1`–`500`	1-based page index. Clamped to range.
`page_size`	integer `1`–`500`	Items per page. Clamped to range.
`filter.status`	string	Filter by status. Accepts the provider vocabulary, including `expired`.
`filter.task_ids`	string (repeatable)	Return only these task ids. Repeat the key to pass several.
`filter.model`	string	Filter by model — accepts a model id or an alias (`seedance-2.0`, `…-fast`, `…-mini`).

The dotted parameter names (filter.status, filter.task_ids, filter.model) are flat query keys, not nested objects — pass them literally. To filter by several ids, repeat filter.task_ids:

curl -G https://api.aurous-labs.com/v1/contents/generations/tasks \
  -H "X-Api-Key: al_live_…" \
  --data-urlencode "filter.task_ids=vid_01J9Z3K7Q0XY2ABCDEFGHJKMNP" \
  --data-urlencode "filter.task_ids=vid_02KA7B4C9DXY3EFGHJKMNPQRST"

Response

{
  "total": 128,
  "items": [
    { "id": "vid_01J9Z3K7Q0XY2ABCDEFGHJKMNP", "model": "seedance-2.0", "status": "succeeded", "content": { "video_url": "https://…" }, "…": "…" },
    { "id": "vid_02KA7B4C9DXY3EFGHJKMNPQRST", "model": "seedance-2.0-mini", "status": "running", "…": "…" }
  ]
}

total — the count matching your filters across all pages.
items[] — normalized task objects, same shape as Retrieve a task.

List superset (delta vs. native). The native Seedance list has a 7-day history window. The Aurous list has no 7-day cutoff — your full task history stays listable. As with retrieve, the video_url inside older items still expires 24 hours after generation.

Deleted tasks (see Cancel or delete) are hidden from this list.

Get started

Guides

Concepts

API Reference

Resources

Query parameters

Response

​Query parameters

​Response

Query parameters

Response