OpenKatana · Build recipe:
OpenKatana_build_recipe creates an editable starting-point timeline for a short-form video using one of OpenKatana’s eight built-in editing styles. Rather than requiring you to arrange every cut and effect manually, it applies a coordinated recipe to your selected media: beat_cut_punch follows a music beat grid with punch-ins and impact or riser cues; xerox_ink creates a photocopy-inspired look with accented keying, rhythmic hard cuts, and grain; mono_noir combines a noir studio look with slow push-ins, letterboxing, and a final white dip; cutout_collage introduces two-panel compositions before showing their clips full-frame; speed_ramp_freeze combines normal speed, slow motion, a freeze, and a white flash; facelock_strobe combines face-locked camera movement with a strobe burst; timed_type places typewriter-style phrases over clean shots; and glitch_hits adds glitch transitions and beat-related RGB splitting. These recipes give you a consistent creative direction while leaving the edit available for review and adjustment. The generated timeline is a draft, not an automatically saved edit or a finished video render.
OpenKatana · Build recipe Input Parameters:
project_id
A required STRING identifying the OpenKatana project in which the recipe-building operation runs. Use the identifier of the project containing the media you want to edit so that the operation can resolve the selected assets in the appropriate project context. This is an identifier, not the project’s display name unless your project system explicitly uses that name as its identifier. The supplied node interface does not specify a default value, allowed identifier format, or minimum or maximum length.
arguments
A required STRING carrying the recipe-building arguments as a JSON object. The exposed node has no separate controls for recipe selection, media selection, or canvas settings, so those settings belong inside this text rather than in additional node inputs. The underlying API accepts the required fields family and asset_ids, plus optional fields music_asset_id, text, font_family, font_file, seconds, width, height, and fps. The supported family values are beat_cut_punch, xerox_ink, mono_noir, cutout_collage, speed_ramp_freeze, facelock_strobe, timed_type, and glitch_hits; asset_ids is a list of media asset identifiers. For example, {"family":"mono_noir","asset_ids":["clip_01"],"seconds":6,"width":1080,"height":1920,"fps":30} requests a six-second portrait draft using the noir recipe. The underlying API defaults are None for music, text, and both font settings; 6 for seconds; 1080 for width; 1920 for height; and 30 for fps. These are API defaults for fields inside the JSON object, not a documented default value for the STRING input itself. The supplied interface does not specify a default string, length limits, or numeric validation ranges for this operation.
after
An optional STRING accepted by the node wrapper. In the supplied execution code, this value is not forwarded into the recipe arguments, passed to the tool invocation, or otherwise inspected, so it has no demonstrated effect on the recipe’s appearance or timing. The interface does not document a required string format, allowed options, or length limits. Its execution-method default is None when omitted; leave it unconnected unless your surrounding workflow has an established reason to supply it.
OpenKatana · Build recipe Output Parameters:
result_json
A STRING containing the JSON-formatted response produced by the OpenKatana tool invocation. This is the node’s only output, so it is where you inspect the recipe-building response and any returned draft-edit information. A timeline describes editing decisions—such as canvas settings, shot placement, effects, and audio arrangements—rather than containing rendered video pixels. Treat this output as structured text for inspection or further processing, not as a video file or a ComfyUI image batch. The supplied code shows that the tool response is passed through a response-formatting helper, but does not show the exact response envelope or guarantee specific top-level JSON keys; inspect the returned content before designing downstream parsing around particular field names. Recipe generation does not automatically save the resulting edit.
OpenKatana · Build recipe Usage Tips:
- Start with a small, valid JSON object containing
familyandasset_ids. For example, use{"family":"xerox_ink","asset_ids":["clip_01","clip_02"]}, replacing the example identifiers with assets imported into your project. - Keep the project identifier in
project_idand place recipe settings insidearguments. The node exposes only these two required inputs and the optionalafterinput; settings such asfpsare not separate node sockets. - For a portrait short-form draft, the underlying defaults already provide a 1080 × 1920 canvas at 30 fps for a requested six seconds. Set
width,height,fps, andsecondsexplicitly in the JSON when you want a different format. - Choose
beat_cut_punchwhen music should drive the cutting rhythm, and supplymusic_asset_idreferencing imported audio. Its implementation requires music and audio analysis, and limits the planning duration to the shorter of the analyzed music duration and the requested duration. - Use
xerox_inkfor a photocopy-style treatment that can also work without music analysis. When analysis is available, its cut interval is calculated as four beats; otherwise, it uses an approximately 0.8-second interval. - Choose
timed_typewhen text is central to your edit, and providetextin the JSON. The API also acceptsfont_familyandfont_file, but the supplied excerpts do not establish font-selection precedence or the expected text-splitting rules. - Prepare a clip face track before choosing
facelock_strobe. The recipe is explicitly described as needing one; selecting footage that merely contains a face does not establish that tracking data is available. - Review the draft before saving or rendering it. Check shot choices, timing, text readability, and the intensity of flashes, strobes, and glitch effects, especially when the result will be viewed by an audience sensitive to flashing imagery.
OpenKatana · Build recipe Common Errors and Solutions:
beat_cut_punch needs music (an imported audio asset) to find the beat grid
- Explanation: This exact error is raised when the beat-cut recipe does not have both music and the analysis needed to establish its beat grid.
- Solution: Import an audio asset into the project and provide its identifier as
music_asset_idinsidearguments. If the error persists, check that the audio is accessible and that the tool can obtain its analysis, or choose another recipe.
unexpected inputs: ...
- Explanation: The node explicitly raises this error if execution receives extra named fields that are not in its declared typed inputs. Adding recipe settings as separate execution fields can trigger this check.
- Solution: Use only the exposed inputs
project_id,arguments, and optionallyafter. Put settings such asfamily,asset_ids, andsecondsinside the JSON string supplied toarguments.
Invalid JSON in arguments
- Explanation: This is a descriptive troubleshooting label, not a confirmed exact error message from the supplied code. The argument-processing step needs a readable JSON object; single-quoted strings, trailing commas, or missing quotation marks can prevent processing before the recipe is built.
- Solution: Use double quotes around JSON keys and string values, and supply asset identifiers in an array. Start with
{"family":"mono_noir","asset_ids":["clip_01"]}and add other settings only after that succeeds.
Missing required recipe arguments
- Explanation: The underlying API requires
familyandasset_idsin addition to the project identifier supplied by the node. Omitting either leaves the operation without a required recipe choice or media selection. The exact resulting error text is not shown in the supplied context. - Solution: Include both keys inside
arguments. Use a supported recipe name and a list of identifiers for the imported media you want to use.
Unsupported recipe family
- Explanation: The documented recipe builder supports eight specific family names. A misspelling, different capitalization, or a recipe name from another OpenKatana planning feature is not a documented option for this operation. The exact validation message is not provided.
- Solution: Copy one of the supported values exactly:
beat_cut_punch,xerox_ink,mono_noir,cutout_collage,speed_ramp_freeze,facelock_strobe,timed_type, orglitch_hits.
Project or asset cannot be resolved
- Explanation: This describes a possible project or media lookup failure; the supplied excerpts do not show its exact error message. Incorrect identifiers, references to another project’s assets, or using a file path where an imported asset identifier is expected can prevent the operation from accessing the intended media.
- Solution: Verify
project_idand copy asset identifiers from the project’s imported assets. Use video or image assets forasset_idsand an imported audio asset formusic_asset_id.
Face track unavailable for facelock_strobe
- Explanation: The recipe documentation explicitly states that this family needs a clip face track. The supplied code does not show the exact failure message or how missing tracking data is reported.
- Solution: Use a clip with face-tracking data already available through your OpenKatana workflow, or select a recipe that does not depend on face tracking.
