🌱 Seedance 2.0 Generation History Browser

If Retrieve Task Result is the "I know the exact ID" tool, Seedance 2.0 Generation History Browser is the "show me everything" tool. It lists your recent BytePlus tasks in a browsable list - status, created time, details - lets you click one, previews it, and hands you the video URL plus a video_ref so you can reuse the result without re-rendering. It's the closest thing this pack has to a gallery of everything you've made.

The source is clever about not depending on any single mechanism: source defaults to api_then_local, which tries BytePlus's task-listing API first and falls back to the task IDs this pack has recorded locally on your machine. You can force either path with api or local. If the API is down, doesn't like your key, or the task predates this pack, local history still has you covered.

The inputs that matter

• source - api_then_local (default), api, or local.
• selected_index - which row in the list is selected (1–999).
• max_items - how many tasks to show (default 20, up to 200).
• selected_task_id - a stable task ID set by the browser list; if populated it wins over selected_index. This is what makes re-runs stable: run once to populate the list, click a row, run again and the node remembers the selection.
• download_preview - default true: downloads the selected video for inline preview.
• api_key - only needed for the API source; local history works without it.

Outputs

video_url, video_ref (the structured SEEDANCE2_VIDEO_REF - this is what you can wire straight into Omni Reference to reuse a clip as reference material), first_frame, request_id, status, and task_json.

How it works, and the expiry trap

Run it once and it populates a list. Click a row, run it again, and it retrieves that task to refresh the preview and outputs. The node tries BytePlus task listing first and falls back to local IDs recorded by the pack.

The trap is spelled out in the README and it's the pack's recurring theme: BytePlus task data and output URLs are short-lived, usually around 24 hours. Expired tasks show up red in the browser, and here's the honest part - selecting an expired task outputs nothing. No video_url, no video_ref, no task_json; the preview area just shows an expired marker. So the browser is a great same-day overview and a poor long-term archive. Anything you might want next week needs Save Video now.

One nice detail: since it emits video_ref, the history browser doubles as a way to grab an old clip and feed it back into Omni Reference as a reference video - a genuinely useful loop for iterating on motion or style.

Install: ComfyUI Manager → Install via Git URL → https://github.com/nnnnkatsu/seedance2-comfyui-byteplus, restart.