Nodes/ComfyUI-load-lora-from-url/BytePlus Video Generation
ComfyUI Node

BytePlus Video Generation

Text/image-to-video through ByteDance's cloud API

By bollerdominik·Created about a year ago·Updated 22 days ago· 2
BytePlus Video Generation
  • image
  • video
  • task_id
  • video_url
api_key
modelep-20260423190508-bhljb
textmy text
duration10
seed-1
camera_fixedfalse
image_url
generate_audiotrue
ratioadaptive
resolution480p
watermarkfalse
poll_interval_seconds5.0
timeout_seconds900

BytePlus is ByteDance's international cloud arm - the global-facing brand for what's Volcano Engine domestically - and its Ark platform hosts ByteDance's video generation models behind a paid API. This node is a thin wrapper around that API: it submits a text (and optionally image) prompt as a video generation job, polls until the job finishes, and hands you back the finished clip. No local model, no VRAM requirement of your own - the compute happens on BytePlus's side and you pay per generation.

The one field worth flagging before anything else: model defaults to ep-20260423190508-bhljb. That's not a placeholder like "gpt-4" is on other API nodes - it's the shape of a real BytePlus/Volcano Ark inference endpoint ID (the ep- prefix is the platform's own convention). Ark doesn't let you pass a plain model name; you create an endpoint tied to a specific model version in your own account console first, and pass that ID here. The value shipped as the default looks like it came straight from the author's own account during development. Replace it with your own endpoint ID before running this node, or expect it to fail against a model you don't have access to.

The fields that matter

  • api_key and model (your BytePlus Ark endpoint ID) - required, and the model field is the trap described above.
  • text - your prompt.
  • duration (1–60 seconds) and resolution (480p/720p) - the basic generation parameters. Longer duration and higher resolution both cost more and take longer to render on BytePlus's side.
  • image or image_url (optional) - supply either to drive image-to-video instead of pure text-to-video.
  • generate_audio (default on) and camera_fixed - whether the output includes generated audio, and whether the camera should stay locked rather than move.
  • ratio - seven aspect ratio options including adaptive, which follows your input image's aspect ratio when one is supplied.
  • watermark - whether BytePlus stamps the output; off by default.
  • poll_interval_seconds (default 5) and timeout_seconds (default 900, up to 7200) - this is a submit-then-poll API under the hood, not a synchronous call. The node checks in every poll_interval_seconds and gives up after timeout_seconds. Video generation jobs on remote APIs commonly take minutes rather than seconds, which is why the default timeout is a full 15 minutes and can be pushed to 2 hours for longer or higher-resolution requests.

Outputs: video (the finished clip), task_id (the BytePlus job ID, useful if you need to look the job up on their dashboard or debug a failure), and video_url (a direct link to the hosted result, separate from the downloaded video output).

Installing it

Search ComfyUI-load-lora-from-url in ComfyUI Manager, or:

cd ComfyUI/custom_nodes
git clone https://github.com/bollerdominik/ComfyUI-load-lora-from-url

No local model to download - you need a BytePlus account with billing set up, an Ark inference endpoint created for the video model you want, and its endpoint ID and API key in hand.

Where people get burned

  • Using the default model value as-is. It's someone else's endpoint ID, not a generic model name. If your workflow errors immediately with an auth or not-found error, this is the first thing to check.
  • A timeout too short for the job. Longer or higher-resolution generations can genuinely take longer than 900 seconds. If runs are timing out rather than failing outright, raise timeout_seconds before assuming something's broken.
  • Forgetting this bills per call. Unlike the local loaders elsewhere in this pack, every run of this node costs real money on your BytePlus account - worth confirming duration and resolution before queuing a batch of test runs.
Categoryimage/video

Inputs (14)

NameTypeDefaultDescription
api_keySTRING
modelSTRINGep-20260423190508-bhljb
textSTRINGmy text
durationINT101–60
seedINT-1-1–4294967295
camera_fixedBOOLEANfalse
imageoptIMAGE
image_urloptSTRING
generate_audiooptBOOLEANtrue
ratiooptCOMBOadaptive7 options: adaptive, 16:9, 9:16, 1:1, 4:3, 3:4, +1
resolutionoptCOMBO480p2 options: 480p, 720p
watermarkoptBOOLEANfalse
poll_interval_secondsoptFLOAT5.01–60
timeout_secondsoptINT90030–7200

Outputs (3)

NameTypeDescription
videoVIDEO
task_idSTRING
video_urlSTRING