Nodes/Seedance 2.0 BytePlus/๐ŸŒฑ Seedance 2.0 Preview Video Reference
ComfyUI Node

๐ŸŒฑ Seedance 2.0 Preview Video Reference

The inspector that shows what's actually inside your video_ref

By nnnnkatsuยทCreated 3 months agoยทUpdated about a month agoยท 1
๐ŸŒฑ Seedance 2.0 Preview Video Reference
  • video_ref
    โ—„video_urlโ–บ
    โ—„s3_keyโ–บ

    This node has no output ports, downloads nothing, and previews nothing. That's not a bug - it's a debugging tool. Seedance 2.0 Preview Video Reference is a terminal inspector: you connect a video_ref to it, run the graph, and it prints the URL and the S3 key that the reference actually carries, right there on the node.

    You'll want it the first time a reference-video workflow quietly fails. The SEEDANCE2_VIDEO_REF connection type is a structured object - it holds the pre-signed URL plus optional S3 metadata (bucket, key, region, credentials) that the Omni node uses for post-generation cleanup. When something goes wrong, the failure is usually "the URL expired," "the key is wrong," or "the ref never got the S3 metadata it was supposed to." This node shows you which one it is, without you digging through logs.

    How it works

    The video_ref input takes the structured reference from Seedance 2.0 S3 Upload Reference Video, Seedance 2.0 S3 Browse Reference Videos, Seedance 2.0 Video Reference URL, or Seedance 2.0 Generation History Browser. When the node runs it unwraps the object and displays two things:

    • video_url - the URL it resolved (a public link, S3 pre-signed URL, or asset:// ID).
    • s3_key - the object key inside S3, if the ref carried S3 metadata at all.

    There are also two plain STRING widgets (video_url and s3_key) you can type into directly, which is handy for pasting a known value to check against - but in normal use you'll feed it a video_ref and read the result. Per the README, it deliberately does not download or play the video; it shows you the reference, not the content. That's Seedance 2.0 Preview Video URL's job.

    A couple of practical reads:

    • Empty s3_key doesn't mean broken. A ref built from Video Reference URL or the history browser is just a URL with no S3 metadata. The key field will be blank, and that's expected.
    • The moment the displayed URL expires, that's your answer. S3 pre-signed URLs default to 300 seconds in this pack. If the inspector shows an old X-Amz-Expires timestamp, regenerate the ref rather than re-running the graph.

    Install

    Same as the rest of the pack: ComfyUI Manager โ†’ Install via Git URL โ†’ https://github.com/nnnnkatsu/seedance2-comfyui-byteplus, restart. It's an output node with no return values, so it doesn't need boto3 even when you're inspecting S3 refs - it's purely reading the object in front of it.

    One honest caveat: as a debugging aid it's excellent; as a permanent fixture in a workflow it's dead weight. Stick it in when a reference workflow misbehaves, read the URL, then delete it before you queue anything you're paying for - every run of this node costs you a few seconds but doesn't cost you any credits, so it's a safe thing to leave in while you debug.

    Category๐ŸŒฑ Seedance 2.0

    Inputs (3)

    NameTypeDefaultDescription
    video_refSEEDANCE2_VIDEO_REFโ€”
    video_urlSTRINGโ€”
    s3_keySTRINGโ€”

    Outputs (0)

    No outputs