Nodes/comfyui-byokey/BYOKey Vidu Text to Video
ComfyUI Node

BYOKey Vidu Text to Video

9, nine-sixteenths, or square, take your pick

By MeteorAndy·Created 4 months ago·Updated 3 months ago· 0
BYOKey Vidu Text to Video
    • output
    api_key
    base_urlhttps://api.vidu.com/ent/v2
    modelviduq1
    prompt
    duration5
    seed0
    aspect_ratio16:9
    resolution1080p
    movement_amplitudeauto
    poll_interval5
    max_wait600

    The text-to-video half of Vidu's two-node set. Where the image-to-video sibling takes a frame and animates it, this one builds the whole shot from your prompt on the viduq1 model. It's still deliberately minimal - 1080p only, five-second clips only - but it adds the one thing the i2v version can't: your choice of aspect ratio, at 16:9, 9:16, or 1:1. Pick the format your target platform wants and the rest of the node gets out of your way.

    How it works. The standard submit-then-poll pattern this pack is built on: POST to api.vidu.com/ent/v2 (the default base_url, overridable for a relay) with your Vidu key, poll every poll_interval seconds until the clip is ready, download the mp4, and wrap it in ComfyUI's native VIDEO type.

    The inputs that matter:

    • prompt - the whole creative input. Vidu handles plain descriptive language well, but it rewards a bit of specificity about motion and camera. It's optional in the schema, though a node that runs with an empty prompt is a node that's rolling dice.
    • aspect_ratio - 16:9, 9:16, or 1:1. Decide this first; you can't cheaply recrop a generated clip.
    • movement_amplitude - auto, small, medium, large. Same knob as the i2v version: how much motion happens in the frame. It's the distinctive Vidu control, and worth experimenting with - small and large produce very different feels from the same prompt.
    • duration - fixed at 5 seconds. Not configurable today; that's the current model contract.
    • seed - 0 for random; honored if you set one.
    • resolution - 1080p, the only choice. The tooltip notes supported values may vary by model and duration, but today it's one.
    • poll_interval / max_wait - the usual babysitters.

    Output: one output (VIDEO) socket.

    Install. Shared pack, one clone:

    cd ComfyUI/custom_nodes
    git clone https://github.com/MeteorAndy/comfyui-byokey.git
    # restart ComfyUI; it's under api/byokey/video
    

    No model downloads, no extra dependencies - ComfyUI's bundled torch, aiohttp, PIL, numpy and av cover it.

    Gotchas. The fixed five-second duration is the thing people trip on; it's the API's current limit, not a misconfiguration. And the usual fresh-pack hygiene: it's new, no community consensus behind it, so give the source a once-over before handing it a key.

    Categoryapi/byokey/video

    Inputs (11)

    NameTypeDefaultDescription
    api_keySTRING
    base_urlSTRINGhttps://api.vidu.com/ent/v2
    modelCOMBOviduq11 options: viduq1
    promptSTRINGA textual description for video generation
    durationoptINT55–5Duration of the output video in seconds (fixed at 5)
    seedoptINT00–2147483647Seed for video generation (0 for random)
    aspect_ratiooptCOMBO16:9The aspect ratio of the output video
    resolutionoptCOMBO1080pSupported values may vary by model & duration
    movement_amplitudeoptCOMBOautoThe movement amplitude of objects in the frame
    poll_intervaloptINT51–60
    max_waitoptINT60030–3600

    Outputs (1)

    NameTypeDescription
    outputVIDEO