Skip to content

Video Query Tasks

Node name
BytePlus Video Query Tasks
Node ID
BytePlusVideoQueryTasks
Find it
Double-click the canvas and search for “Video Query Tasks”, or browse BytePlus ModelArk
Keys needed
ModelArk API key
Runs when
It is an output node: it runs on its own, whenever the workflow is queued.

Lists the video generation tasks of your ModelArk account as JSON, newest first. Filter by status, model or task ID to check on a task that is still running, to see why one failed, or to find a task whose ID you lost.

It starts no generation, so it creates no new video. It is an output node: it runs on its own, with nothing connected to its outputs.

The Video Query Tasks node with page_num 1, page_size 10, status all, service_tier default, an empty task_ids field, model_version all and a seed
The default setup lists the 10 newest tasks of all models in the default service tier.
InputTypeDefaultWhat it does
page_numinteger1Range: 1–500
page_sizeinteger10Range: 1–500
statuschoiceallChoices: all, succeeded, failed, running, queued, cancelled, expired
service_tierchoicedefaultChoices: default, flex
task_idstext
model_versionchoiceallChoices: all, seedance-1-0-pro, seedance-1-0-pro-fast, dreamina-seedance-2-0, dreamina-seedance-2-0-fast, dreamina-seedance-2-0-mini, dreamina-seedance-2-5, dreamina-seedance-2-5-premium, seedance-1-5-pro
seedinteger0Range: 0–2147483647
  • Task IDs: put one ID per line in task_ids to look up those tasks. Leave it empty to list by status and model_version.
  • Where to find a task ID: a single-video run prints a Task ID line in the ComfyUI console. A Seedance 2.5 Draft run also outputs draft_task_id. With non_blocking on, the video node returns the pending IDs in its response output.
  • Service tier: tasks are listed per tier. Set service_tier to flex to see tasks you started with enable_offline_inference.
  • Model: model_version uses model names such as dreamina-seedance-2-5, not the labels on the video nodes. It also lists the retired seedance-1-5-pro, so you can still find its old tasks.
  • Seed: seed has no effect on the result. It only makes ComfyUI run the node again when the value changes: with control after generate on randomize (the default) it changes after every run, so the list is fetched anew each time.
OutputTypeWhat it holds
task_list_jsontext
total_tasksinteger
  • task_list_json is a JSON list with one entry per task. Times are shown as YYYY-MM-DD HH:MM:SS in the time zone of the ComfyUI machine.
  • total_tasks is the total that ModelArk reports for your filters.
  • If the request fails, task_list_json holds {"error": ...} with the reason and total_tasks is 0.
  • ModelArk keeps tasks for 7 days, so older tasks no longer appear.
  • Use page_num and page_size (each 1 to 500) to walk through a long list.
  • Looking up task IDs that all do not exist stops the node with a “No task found” error. If only some are missing, the node lists the ones it found and writes “Not found” with the missing IDs to the console.
  • A task that was still running when you interrupted a video node cannot be cancelled and is billed. Look it up here with the ID from the node’s message. See Interrupts and cancelling.
  • If a video node reports that a succeeded (and billed) task’s video could not be downloaded, the video stays available for 24 hours. Look the task up here, or in the ModelArk console, to get it.
Message What to do
No BytePlus API key is set Add the key in Settings → BytePlus. See API keys.
No task found for Check the task ID. It is the Task ID line in the console or the draft_task_id output of a Seedance 2.5 Draft run. Tasks older than 7 days are gone.
Invalid API Key (401) The key and region do not match. Pick the key’s region in Settings → BytePlus. This text appears inside the error field of task_list_json.