Protoface Pika 2.2 · Text to Video

Three fields

prompt, duration, size. That's the creative surface of Pika 2.2's text-to-video, and it's the most minimal video node in this pack after Hailuo. For a first paid video generation it's a decent place to start precisely because there's nothing to get wrong: no reference sockets, no first/last frame pairing, no seed, no quality tier.

What you're buying is a short clip from text - Pika's strengths being motion and vibe over documentary realism. Use it for social-length content, B-roll, a visual punchline. Don't expect it to hold a photoreal face together for five seconds; that's what the pricier nodes in this pack are for.

And no, it doesn't run on your GPU. There's no weight download, no local inference, nothing to quantize. The node is an HTTP client that uploads your text, waits on a job, and hands back a native VIDEO. That's why it works on a 6GB laptop and why it costs money every queue.

Inputs and outputs

prompt is the shot. Pika likes momentum in the wording - "a paper boat bobbing down a rain gutter, camera tracking low and fast" beats an inventory of nouns.

duration is a picker with 5 as the default; take a listed value rather than assuming you can type an arbitrary number.

size is the pixel size, defaulting to 1280*720. Small warning: this pack's size field means pixels on Pika nodes and aspect ratio on some others (MAI, for one). Read the tooltip - this one is dimensions.

generation_id is the identity of the paid job, not a random seed. Fixed = reuse or resume on requeue; incremented = a fresh, freshly-charged generation. Since there's no seed field at all, you can't reproduce a specific clip - if one comes out well, save it.

request_scope is written per node by the frontend. Headless callers must provide a stable unique value themselves; the adapter refuses to submit without it.

Outputs are the pack's standard trio: video (VIDEO, list), files (PROTOFACE_FILE, list - originals for Protoface Save File), and run id (string; support handle and the key to Protoface Resume Run). Wire video into Save Video or Video Combine and you're done.

Install

cd ComfyUI/custom_nodes
git clone --branch v0.1.0 --depth 1 https://github.com/protoface-ai/protoface-comfyui.git protoface
python -m pip install -r protoface/requirements.txt

ComfyUI 0.41.0+, Python 3.10+; deps httpx, jsonschema, Pillow, av>=14. Manager: search Protoface → protoface-nodes → restart → reload the tab. Then click Protoface lower-right and enter your key.

The key is held in server memory only and cleared on restart - the docs are explicit about it, and it's the single most common "it worked yesterday" on this pack. For a persistent server, put the key in a private file and set PROTOFACE_API_KEY_FILE before launching ComfyUI.

Where people get bitten

The other thing the docs are explicit about: this extension bills your Protoface account directly, independent of Comfy Partner Nodes and Comfy credits. If you assumed your Com credits would cover it, you'll find out at the wrong moment.

Recovery, one more time, because it's where money leaks: a timeout or a closed tab doesn't kill the job. Keep generation_id, requeue or resume by run id. Incrementing the ID to retry pays twice. Interrupting is a best-effort cancel with no refund promise. Keep ~/.cache/protoface-comfyui - deleting it throws away the deduplication record.