Skip to content

The most powerful and modular diffusion model GUI, api and backend with a graph/nodes interface. The fastest local inference engine in the world.

update node tooltips and validation (#8036)

Christian Byrneae60b150e577
diff --git a/comfy_api_nodes/nodes_ideogram.py b/comfy_api_nodes/nodes_ideogram.py
index 45c021f4a..0a16d74bf 100644
--- a/comfy_api_nodes/nodes_ideogram.py
+++ b/comfy_api_nodes/nodes_ideogram.py
@@ -234,9 +234,7 @@ def download_and_process_images(image_urls):
class IdeogramV1(ComfyNodeABC):
"""
- Generates images synchronously using the Ideogram V1 model.
-
- Images links are available for a limited period of time; if you would like to keep the image, you must download it.
+ Generates images using the Ideogram V1 model.
"""
def __init__(self):
@@ -365,9 +363,7 @@ class IdeogramV1(ComfyNodeABC):
class IdeogramV2(ComfyNodeABC):
"""
- Generates images synchronously using the Ideogram V2 model.
-
- Images links are available for a limited period of time; if you would like to keep the image, you must download it.
+ Generates images using the Ideogram V2 model.
"""
def __init__(self):
@@ -536,10 +532,7 @@ class IdeogramV2(ComfyNodeABC):
class IdeogramV3(ComfyNodeABC):
"""
- Generates images synchronously using the Ideogram V3 model.
-
- Supports both regular image generation from text prompts and image editing with mask.
- Images links are available for a limited period of time; if you would like to keep the image, you must download it.
+ Generates images using the Ideogram V3 model. Supports both regular image generation from text prompts and image editing with mask.
"""
def __init__(self):
diff --git a/comfy_api_nodes/nodes_kling.py b/comfy_api_nodes/nodes_kling.py
index 9aa8df58b..c8d1704c1 100644
--- a/comfy_api_nodes/nodes_kling.py
+++ b/comfy_api_nodes/nodes_kling.py
@@ -184,6 +184,33 @@ def validate_image_result_response(response) -> None:
raise KlingApiError(error_msg)
+def validate_input_image(image: torch.Tensor) -> None:
+ """
+ Validates the input image adheres to the expectations of the Kling API:
+ - The image resolution should not be less than 300*300px
+ - The aspect ratio of the image should be between 1:2.5 ~ 2.5:1
+
+ See: https://app.klingai.com/global/dev/document-api/apiReference/model/imageToVideo
+ """
+ if len(image.shape) == 4:
+ height, width = image.shape[1], image.shape[2]
+ elif len(image.shape) == 3:
+ height, width = image.shape[0], image.shape[1]
+ else:
+ raise ValueError("Invalid image tensor shape.")
+
+ # Ensure minimum resolution is met
+ if height < 300:
+ raise ValueError("Image height must be at least 300px")
+ if width < 300:
+ raise ValueError("Image width must be at least 300px")
+
+ # Ensure aspect ratio is within acceptable range
+ aspect_ratio = width / height
+ if aspect_ratio < 1 / 2.5 or aspect_ratio > 2.5:
+ raise ValueError("Image aspect ratio must be between 1:2.5 and 2.5:1")
+
+
def get_camera_control_input_config(
tooltip: str, default: float = 0.0
) -> tuple[IO, InputTypeOptions]:
@@ -530,7 +557,10 @@ class KlingImage2VideoNode(KlingNodeBase):
return {
"required": {
"start_frame": model_field_to_node_input(
- IO.IMAGE, KlingImage2VideoRequest, "image"
+ IO.IMAGE,
+ KlingImage2VideoRequest,
+ "image",
+ tooltip="The reference image used to generate the video.",
),
"prompt": model_field_to_node_input(
IO.STRING, KlingImage2VideoRequest, "prompt", multiline=True
@@ -607,9 +637,10 @@ class KlingImage2VideoNode(KlingNodeBase):
auth_token: Optional[str] = None,
) -> tuple[VideoFromFile]:
validate_prompts(prompt, negative_prompt, MAX_PROMPT_LENGTH_I2V)
+ validate_input_image(start_frame)
if camera_control is not None:
- # Camera control type for image 2 video is always simple
+ # Camera control type for image 2 video is always `simple`
camera_control.type = KlingCameraControlType.simple
initial_operation = SynchronousOperation(