IAMCCS CineInfo V2V SCAIL
Let a shot plan drive your motion-transfer run
- cine_linx
- source_images
- source_audio
- pose_video_mask_image
- reference_image_mask_image
- fps
- generation_width
- generation_height
- positive_prompt
- negative_prompt
- output_prefix
- pose_video
- reference_image
- pose_video_mask_image
- reference_image_mask_image
- source_audio
- source_video_info
- replacement_mode
- backend_profile
- report
IAMCCS CineInfo V2V SCAIL is the "read my shot plan, give me a SCAIL run" node in the IAMCCS V2V shotboard pipeline. SCAIL, if you haven't met it, is Z.ai's motion-transfer model on a Wan 2.1 base - the one that dropped the stick-figure pose skeleton entirely and just throws reference image + driving video + masks at the model. That's why this node exists: SCAIL wants a small, specific set of inputs, and this node makes sure each shot of a multi-shot scene delivers exactly that set.
Fair warning before you go any deeper: this is an orchestration node. It takes a cine_linx (the IAMCCS plan bus) and unpacks it into SCAIL-ready values. Standalone, it's a passthrough that prints a report. It earns its keep inside the author's Shotboard V2V workflows - the ones distributed through the pack and the Patreon.
How it works
The source code is almost boring in a good way. It reads the cine_linx payload, loads the planner media (source video, reference image, audio), then does two smart things:
- It fabricates masks when you don't supply them. SCAIL-2 works with support masks for the driving pose and the reference. If you leave
pose_video_mask_imageandreference_image_mask_imagedisconnected, this node hands you a full-white mask so the pipeline doesn't crash. You're expected to swap in real masks (SAM 3.1 tracking output, in the author's setup) for actual quality. - It picks the backend profile -
scail2_single_personby default, orscail2_multi_person_identityif the plan says so - and exposes it asbackend_profileso downstream switches know which branch you're on.
The backend templates in the code show what this is wrapping: SAM3 tracking previews, colored identity masks, a 16 FPS pass then a 32 FPS upscaled final. The CineInfo node is just the front door.
The inputs and outputs that matter
Required: cine_linx. That's it.
Optional overrides: source_images, source_audio, plus pose_video_mask_image and reference_image_mask_image - the two masks above.
The outputs you'll actually grab:
pose_videoandreference_image- SCAIL's two core inputs.pose_video_mask_image/reference_image_mask_image- drive and reference support masks.replacement_mode(BOOLEAN) - whether this shot replaces the identity in the driving video (true) or keeps it.fps,generation_width,generation_height,positive_prompt,negative_prompt- the per-shot values for your latent and sampler.backend_profileandreport- which SCAIL variant this run is, and a summary line.
Install and requirements
It's one node in IAMCCS-nodes - install the whole pack:
cd ComfyUI/custom_nodes
git clone https://github.com/IAMCCS/IAMCCS-nodes.git
or Manager → search IAMCCS. README requirements: ComfyUI ≥ 0.3.0, Python ≥ 3.12, Torch ≥ 2.8. The SCAIL backend itself wants the SCAIL-2 model, a CLIP vision model, VAE, and (in the author's full pipeline) SAM 3.1 for mask tracking. That's a big stack; if you're only here for SCAIL-2, the vanilla ComfyUI core workflow is the lighter entry point and this node adds little unless you're committing to the shotboard pipeline.
Where people get burned
- The masks default to white. You'll get motion transfer that looks like the reference is stamped over the whole frame. Generate real masks (SAM3 tracking) or don't blame the node when single-person replacement bleeds everywhere.
- SCAIL is heavy. The KB and community both note generation cost is the wall - it's the strongest open motion-transfer model but mid-range GPUs sweat. This node doesn't change that math.
replacement_modesemantics. The plan'sbackend_settingsdecides it; if you're hand-driving this node without a plan, check the output before assuming what it does.- Duplicated pack folder breaks registration - the requirements doc calls it the top install mistake. One
IAMCCS-nodes, no copies. - Pre-release one-author tooling, zero search impressions as of writing. If a Shotboard workflow references it and you don't have the full pipeline, you'll see a wall of "missing node" errors - grab the whole pack, not just this class.
Inputs (5)
| Name | Type | Default | Description |
|---|---|---|---|
| cine_linx | IAMCCS_SUPERNODE_LINX | — | |
| source_imagesopt | IMAGE | — | |
| source_audioopt | AUDIO | — | |
| pose_video_mask_imageopt | IMAGE | — | |
| reference_image_mask_imageopt | IMAGE | — |
Outputs (15)
| Name | Type | Description |
|---|---|---|
| fps | FLOAT | — |
| generation_width | INT | — |
| generation_height | INT | — |
| positive_prompt | STRING | — |
| negative_prompt | STRING | — |
| output_prefix | STRING | — |
| pose_video | IMAGE | — |
| reference_image | IMAGE | — |
| pose_video_mask_image | IMAGE | — |
| reference_image_mask_image | IMAGE | — |
| source_audio | AUDIO | — |
| source_video_info | VHS_VIDEOINFO | — |
| replacement_mode | BOOLEAN | — |
| backend_profile | STRING | — |
| report | STRING | — |