Save 4 hours! We auto-setup your workflow! Free!

Drop your workflow.json — we handle every dependency, custom node, and model. Just open the link and run.

Auto-Setup Workflow Json (Free) Now!
ComfyUI > Nodes > OpenKatana > OpenKatana · Synthesize score

ComfyUI Node: OpenKatana · Synthesize score

Class Name

OpenKatana_synthesize_score

Category
OpenKatana/Tools
Author
rk0neki (Account age: 235days)
Extension
OpenKatana
Latest Updated
2026-11-05
Github Stars
0.05K

How to Install OpenKatana

Install this extension via the ComfyUI Manager by searching for OpenKatana
  • 1. Click the Manager button in the main menu
  • 2. Select Custom Nodes Manager button
  • 3. Enter OpenKatana in the search bar
After installation, click the Restart button to restart ComfyUI. Then, manually refresh your browser to clear the cache and access the updated list of nodes.

Visit ComfyUI Online for ready-to-use ComfyUI environment

  • Free trial available
  • 16GB VRAM to 80GB VRAM GPU machines
  • 400+ preloaded models/nodes
  • Freedom to upload custom models/nodes
  • 200+ ready-to-run workflows
  • 100% private workspace with up to 200GB storage
  • Dedicated Support

Run ComfyUI Online

OpenKatana · Synthesize score Description

Synthesizes deterministic stereo audio from structured note events using oscillators and noise.

OpenKatana · Synthesize score:

OpenKatana_synthesize_score creates original synthesized audio from explicitly defined note events, using oscillator and noise synthesis rather than an AI music-generation model. It is useful for building controlled sound cues, simple musical passages, and repeatable audio elements for creative projects. Instead of interpreting a natural-language music prompt, it follows a structured score that specifies when sounds occur and how they are arranged. Its deterministic design makes it especially useful when you need consistent results across repeated renders: the supplied test confirms that an identical noise score with the same random seed produces identical audio hashes. The tested implementation also produces stereo audio, supports directional placement of sounds, and keeps the generated signal within a bounded level.

OpenKatana · Synthesize score Input Parameters:

project_id

A required STRING that identifies the project context for the tool call. The node passes this value to its argument-preparation layer before invoking the synthesis tool, so you should supply the identifier associated with the project you intend to work in. The provided source does not show how project identifiers are created, validated, or connected to output locations; it therefore does not establish any naming rules or guarantee that a project will be created automatically. No default value, minimum or maximum string length, or list of allowed values is shown in the authoritative interface.

arguments

A required STRING containing the tool arguments that the node’s argument-processing layer prepares for execution. The underlying synthesis function accepts a score document and an output destination, but the supplied node source does not reveal the complete serialized argument structure or how the destination is resolved. Within the score document, the supported top-level fields shown are duration, sample_rate, seed, and notes. The total duration is measured in seconds and must be between 0.05 and 180; no duration default is shown. The sample rate must be an integer between 8000 and 96000, with a default of 48000, and determines how many audio samples represent each second. The seed must be an integer between 0 and 4294967295, with a default of 0, and provides repeatable randomness for sounds such as noise. The notes value must be a list containing 1 to 10000 note events, with no default shown. A tested note uses at, duration, waveform, pan, and gain, but the full note-field schema, supported oscillator options, and parameter ranges are not supplied. These are fields inside the score data, not additional node sockets. No default string value or string-length limits are shown for arguments; use the tool’s established argument format rather than assuming that the score document alone is the complete request.

after

An optional STRING accepted by the node, with a Python execution default of None when omitted. Although the execution method accepts this parameter, the displayed method body does not explicitly read it or pass it to the tool invocation. The supplied source therefore does not establish a dependency, scheduling, or synthesis effect for this value. No interface-level text default, allowed options, or minimum and maximum lengths are shown. Leave it unconnected unless your surrounding OpenKatana workflow documents a specific use for it.

OpenKatana · Synthesize score Output Parameters:

result_json

A STRING containing the response returned through the node’s response-formatting layer after the synthesis tool is invoked. Treat it as a serialized tool response rather than an audio waveform socket: inspect or parse its JSON content to find the returned information before passing values into later workflow steps. The underlying synthesis function is confirmed by tests to return an audio entry pointing to the generated audio file and a sha256 entry containing a content hash, which can help you verify whether two renders are identical. However, the implementation of the node’s response formatter is not provided, so the exact placement of these entries within result_json, any additional metadata, and the representation of failures cannot be guaranteed from the supplied context.

OpenKatana · Synthesize score Usage Tips:

  • Start with a short score and very few note events. A small test makes it easier to check timing and file creation before building a longer sequence.

  • Keep the score’s total duration between 0.05 and 180 seconds, and keep every note within that timeline. The supplied test explicitly rejects a one-second note in a score lasting only 0.2 seconds.

  • Set an explicit seed when using noise and retain it while refining the score. The test confirms identical audio hashes for repeated synthesis of the same score with the same seed, making this useful for reproducible creative work.

  • Use the default sample_rate of 48000 when you do not have a different project requirement. Lower supported rates reduce the number of samples generated for the same duration, but also reduce the high-frequency detail the audio can represent.

  • For a minimal score-document reference, the tested configuration uses duration of 0.2, sample_rate of 8000, seed of 4, and one noise note with at of 0, duration of 0.2, waveform of noise, pan of -1, and gain of 1. This is an example of the score content, not a verified complete arguments string.

  • Use the tested pan value of -1 when you specifically need the example noise sound entirely in the left channel. Do not assume other pan ranges or waveform names without checking the full tool schema.

  • Inspect result_json after a successful run to locate the audio file reference. When checking repeatability, compare the returned audio hashes rather than output filenames, because the test obtains identical hashes while writing to different destinations.

OpenKatana · Synthesize score Common Errors and Solutions:

Supply 1..10000 note events

  • Explanation: This exact error is raised when the score’s notes value is not a list, is empty, or contains more than 10000 events.
  • Solution: Provide a list containing at least one note and no more than 10000. Start with one valid note, then add events gradually.

Score duration validation failure — exact message not supplied

  • Explanation: The synthesis function validates duration as a number between 0.05 and 180 seconds. A missing duration, a nonnumeric value, or an out-of-range value can fail this validation.
  • Solution: Supply a numeric total duration within the supported range. Use seconds rather than frames or milliseconds.

Sample rate validation failure — exact message not supplied

  • Explanation: The sample_rate setting must be an integer between 8000 and 96000. Text such as 48 kHz or a value outside that interval does not meet the documented numeric requirement.
  • Solution: Use an integer such as 48000, or omit this score field to use its default of 48000.

Seed validation failure — exact message not supplied

  • Explanation: The seed setting is checked as an integer from 0 through 4294967295. Negative numbers, fractional numbers, and values above the maximum do not satisfy that requirement.
  • Solution: Choose an integer within the allowed range, such as 4, or omit the field to use 0. Reuse the same seed when you want repeatable noise generation.

Note duration exceeds the score timeline — exact message not supplied

  • Explanation: The supplied test confirms that a note lasting one second inside a 0.2-second score raises ContractError. The exact error text and full note-validation implementation are not included.
  • Solution: Shorten the note or increase the score duration within the 180-second limit. Check each note’s start time and duration so that its end fits inside the total score.

unexpected inputs: ...

  • Explanation: The node explicitly raises a TypeError with this message prefix if extra execution fields are supplied that are not recognized by its typed input definition.
  • Solution: Use only the documented node inputs: project_id, arguments, and optional after. Keep score settings inside the correctly structured tool arguments instead of adding them as extra node inputs.

Argument parsing or tool-call failure — exact message not supplied

  • Explanation: The node processes arguments before calling the synthesis tool, but the argument-parser implementation and complete request schema are not included. An incorrectly serialized request or an incorrect argument structure may prevent synthesis from starting.
  • Solution: Verify the tool’s expected request structure and serialization format. If your workflow uses JSON, check its syntax carefully and confirm how the score document and output destination must be supplied; the provided function signature alone does not establish the complete node request format.

OpenKatana · Synthesize score Related Nodes

Go back to the extension to check out more related nodes.
OpenKatana
RunComfy
Copyright 2025 RunComfy. All Rights Reserved.

RunComfy is the premier ComfyUI platform, offering ComfyUI online environment and services, along with ComfyUI workflows featuring stunning visuals. RunComfy also provides AI Models, enabling artists to harness the latest AI tools to create incredible art.

OpenKatana · Synthesize score