From 70254ae9459e782dbe242df9f255212a4e70d63e Mon Sep 17 00:00:00 2001 From: Alexander Piskun <13381981+bigcat88@users.noreply.github.com> Date: Mon, 24 Aug 2026 20:48:48 +0400 Subject: [PATCH] [Partner Nodes] feat(Meshy): add Meshy-7 support (#15807) Signed-off-by: Alexander Piskun --- comfy_api_nodes/apis/meshy.py | 14 ++- comfy_api_nodes/nodes_meshy.py | 217 +++++++++++++++++++++++++++++---- 2 files changed, 207 insertions(+), 24 deletions(-) diff --git a/comfy_api_nodes/apis/meshy.py b/comfy_api_nodes/apis/meshy.py index 7d72e6e91..fe9dcb55d 100644 --- a/comfy_api_nodes/apis/meshy.py +++ b/comfy_api_nodes/apis/meshy.py @@ -14,6 +14,7 @@ class InputShouldRemesh(TypedDict): class InputShouldTexture(TypedDict): should_texture: str enable_pbr: bool + texture_resolution: str texture_prompt: str texture_image: Input.Image | None @@ -25,7 +26,7 @@ class MeshyTaskResponse(BaseModel): class MeshyTextToModelRequest(BaseModel): mode: str = Field("preview") prompt: str = Field(..., max_length=600) - art_style: str = Field(..., description="'realistic' or 'sculpture'") + art_style: str = Field(...) ai_model: str = Field(...) topology: str | None = Field(..., description="'quad' or 'triangle'") target_polycount: int | None = Field(..., ge=100, le=300000) @@ -35,6 +36,7 @@ class MeshyTextToModelRequest(BaseModel): ) symmetry_mode: str = Field(..., description="'auto', 'off' or 'on'") pose_mode: str = Field(...) + ultra_mode: bool = Field(False) seed: int = Field(...) moderation: bool = Field(False) @@ -43,6 +45,7 @@ class MeshyRefineTask(BaseModel): mode: str = Field("refine") preview_task_id: str = Field(...) enable_pbr: bool | None = Field(...) + texture_resolution: str = Field(...) texture_prompt: str | None = Field(...) texture_image_url: str | None = Field(...) ai_model: str = Field(...) @@ -61,7 +64,9 @@ class MeshyImageToModelRequest(BaseModel): ) should_texture: bool = Field(...) enable_pbr: bool | None = Field(...) + texture_resolution: str | None = Field(None) pose_mode: str = Field(...) + ultra_mode: bool = Field(False) texture_prompt: str | None = Field(None, max_length=600) texture_image_url: str | None = Field(None) seed: int = Field(...) @@ -80,6 +85,7 @@ class MeshyMultiImageToModelRequest(BaseModel): ) should_texture: bool = Field(...) enable_pbr: bool | None = Field(...) + texture_resolution: str | None = Field(None) pose_mode: str = Field(...) texture_prompt: str | None = Field(None, max_length=600) texture_image_url: str | None = Field(None) @@ -103,8 +109,10 @@ class MeshyTextureRequest(BaseModel): ai_model: str = Field(...) enable_original_uv: bool = Field(...) enable_pbr: bool = Field(...) - text_style_prompt: str | None = Field(...) - image_style_url: str | None = Field(...) + texture_resolution: str = Field(...) + text_style_prompt: str | None = Field(None) + image_style_url: str | None = Field(None) + multiview_image_urls: list[str] | None = Field(None) class MeshyModelsUrls(BaseModel): diff --git a/comfy_api_nodes/nodes_meshy.py b/comfy_api_nodes/nodes_meshy.py index 3a24f1095..f4624c26f 100644 --- a/comfy_api_nodes/nodes_meshy.py +++ b/comfy_api_nodes/nodes_meshy.py @@ -35,9 +35,9 @@ class MeshyTextToModelNode(IO.ComfyNode): display_name="Meshy: Text to Model", category="partner/3d/Meshy", inputs=[ - IO.Combo.Input("model", options=["latest"]), + IO.Combo.Input("model", options=["meshy-7", "meshy-6", "latest"]), IO.String.Input("prompt", multiline=True, default=""), - IO.Combo.Input("style", options=["realistic", "sculpture"]), + IO.Combo.Input("style", options=["realistic"]), IO.DynamicCombo.Input( "should_remesh", options=[ @@ -75,6 +75,11 @@ class MeshyTextToModelNode(IO.ComfyNode): tooltip="Seed controls whether the node should re-run; " "results are non-deterministic regardless of seed.", ), + IO.Boolean.Input( + "ultra_mode", + default=False, + tooltip="Run an extra refinement pass for higher-fidelity geometry with finer surface detail.", + ), ], outputs=[ IO.String.Output(display_name="model_file"), # for backward compatibility only @@ -90,7 +95,13 @@ class MeshyTextToModelNode(IO.ComfyNode): is_api_node=True, is_output_node=True, price_badge=IO.PriceBadge( - expr="""{"type":"usd","usd":0.8}""", + depends_on=IO.PriceBadgeDepends(widgets=["model", "ultra_mode"]), + expr=""" + ( + $credits := 20 + ((widgets.ultra_mode and widgets.model in ["meshy-7", "latest"]) ? 5 : 0); + {"type":"usd","usd": $round($credits * 0.0572, 4)} + ) + """, ), ) @@ -104,8 +115,11 @@ class MeshyTextToModelNode(IO.ComfyNode): symmetry_mode: str, pose_mode: str, seed: int, + ultra_mode: bool, ) -> IO.NodeOutput: validate_string(prompt, field_name="prompt", min_length=1, max_length=600) + if ultra_mode and model not in ("meshy-7", "latest"): + raise ValueError("ultra_mode requires the meshy-7 or latest model") response = await sync_op( cls, ApiEndpoint(path="/proxy/meshy/openapi/v2/text-to-3d", method="POST"), @@ -119,6 +133,7 @@ class MeshyTextToModelNode(IO.ComfyNode): should_remesh=should_remesh["should_remesh"] == "true", symmetry_mode=symmetry_mode, pose_mode=pose_mode.lower(), + ultra_mode=ultra_mode, seed=seed, ), ) @@ -148,14 +163,12 @@ class MeshyRefineNode(IO.ComfyNode): category="partner/3d/Meshy", description="Refine a previously created draft model.", inputs=[ - IO.Combo.Input("model", options=["latest"]), + IO.Combo.Input("model", options=["meshy-7", "meshy-6", "latest"]), IO.Custom("MESHY_TASK_ID").Input("meshy_task_id"), IO.Boolean.Input( "enable_pbr", default=False, - tooltip="Generate PBR Maps (metallic, roughness, normal) in addition to the base color. " - "Note: this should be set to false when using Sculpture style, " - "as Sculpture style generates its own set of PBR maps.", + tooltip="Generate PBR Maps (metallic, roughness, normal) in addition to the base color.", advanced=True, ), IO.String.Input( @@ -170,6 +183,11 @@ class MeshyRefineNode(IO.ComfyNode): tooltip="Only one of 'texture_image' or 'texture_prompt' may be used at the same time.", optional=True, ), + IO.Combo.Input( + "texture_resolution", + options=["2k", "4k", "8k"], + tooltip="Base color texture resolution. Higher resolutions capture more surface detail.", + ), ], outputs=[ IO.String.Output(display_name="model_file"), # for backward compatibility only @@ -185,7 +203,13 @@ class MeshyRefineNode(IO.ComfyNode): is_api_node=True, is_output_node=True, price_badge=IO.PriceBadge( - expr="""{"type":"usd","usd":0.4}""", + depends_on=IO.PriceBadgeDepends(widgets=["texture_resolution"]), + expr=""" + ( + $credits := widgets.texture_resolution = "8k" ? 15 : 10; + {"type":"usd","usd": $round($credits * 0.0572, 4)} + ) + """, ), ) @@ -196,6 +220,7 @@ class MeshyRefineNode(IO.ComfyNode): meshy_task_id: str, enable_pbr: bool, texture_prompt: str, + texture_resolution: str, texture_image: Input.Image | None = None, ) -> IO.NodeOutput: if texture_prompt and texture_image is not None: @@ -212,6 +237,7 @@ class MeshyRefineNode(IO.ComfyNode): data=MeshyRefineTask( preview_task_id=meshy_task_id, enable_pbr=enable_pbr, + texture_resolution=texture_resolution, texture_prompt=texture_prompt if texture_prompt else None, texture_image_url=texture_image_url, ai_model=model, @@ -242,7 +268,7 @@ class MeshyImageToModelNode(IO.ComfyNode): display_name="Meshy: Image to Model", category="partner/3d/Meshy", inputs=[ - IO.Combo.Input("model", options=["latest"]), + IO.Combo.Input("model", options=["meshy-7", "meshy-6", "latest"]), IO.Image.Input("image"), IO.DynamicCombo.Input( "should_remesh", @@ -290,6 +316,12 @@ class MeshyImageToModelNode(IO.ComfyNode): "may be used at the same time.", optional=True, ), + IO.Combo.Input( + "texture_resolution", + options=["2k", "4k", "8k"], + tooltip="Base color texture resolution. " + "Higher resolutions capture more surface detail.", + ), ], ), IO.DynamicCombo.Option("false", []), @@ -313,6 +345,11 @@ class MeshyImageToModelNode(IO.ComfyNode): tooltip="Seed controls whether the node should re-run; " "results are non-deterministic regardless of seed.", ), + IO.Boolean.Input( + "ultra_mode", + default=False, + tooltip="Run an extra refinement pass for higher-fidelity geometry with finer surface detail.", + ), ], outputs=[ IO.String.Output(display_name="model_file"), # for backward compatibility only @@ -328,11 +365,17 @@ class MeshyImageToModelNode(IO.ComfyNode): is_api_node=True, is_output_node=True, price_badge=IO.PriceBadge( - depends_on=IO.PriceBadgeDepends(widgets=["should_texture"]), + depends_on=IO.PriceBadgeDepends( + widgets=["model", "should_texture", "should_texture.texture_resolution", "ultra_mode"], + ), expr=""" ( - $prices := {"true": 1.2, "false": 0.8}; - {"type":"usd","usd": $lookup($prices, widgets.should_texture)} + $textured := widgets.should_texture = "true"; + $resolution := $textured ? $lookup(widgets, "should_texture.texture_resolution") : "2k"; + $credits := ($textured ? 30 : 20) + + ($resolution = "8k" ? 5 : 0) + + ((widgets.ultra_mode and widgets.model in ["meshy-7", "latest"]) ? 5 : 0); + {"type":"usd","usd": $round($credits * 0.0572, 4)} ) """, ), @@ -348,7 +391,10 @@ class MeshyImageToModelNode(IO.ComfyNode): should_texture: InputShouldTexture, pose_mode: str, seed: int, + ultra_mode: bool, ) -> IO.NodeOutput: + if ultra_mode and model not in ("meshy-7", "latest"): + raise ValueError("ultra_mode requires the meshy-7 or latest model") texture = should_texture["should_texture"] == "true" texture_image_url = texture_prompt = None if texture: @@ -376,7 +422,9 @@ class MeshyImageToModelNode(IO.ComfyNode): should_remesh=should_remesh["should_remesh"] == "true", should_texture=texture, enable_pbr=should_texture.get("enable_pbr", None), + texture_resolution=should_texture.get("texture_resolution", None), pose_mode=pose_mode.lower(), + ultra_mode=ultra_mode, texture_prompt=texture_prompt, texture_image_url=texture_image_url, seed=seed, @@ -407,7 +455,7 @@ class MeshyMultiImageToModelNode(IO.ComfyNode): display_name="Meshy: Multi-Image to Model", category="partner/3d/Meshy", inputs=[ - IO.Combo.Input("model", options=["latest"]), + IO.Combo.Input("model", options=["meshy-7", "meshy-6", "latest"]), IO.Autogrow.Input( "images", template=IO.Autogrow.TemplatePrefix(IO.Image.Input("image"), prefix="image", min=2, max=4), @@ -458,6 +506,12 @@ class MeshyMultiImageToModelNode(IO.ComfyNode): "may be used at the same time.", optional=True, ), + IO.Combo.Input( + "texture_resolution", + options=["2k", "4k", "8k"], + tooltip="Base color texture resolution. " + "Higher resolutions capture more surface detail.", + ), ], ), IO.DynamicCombo.Option("false", []), @@ -496,11 +550,15 @@ class MeshyMultiImageToModelNode(IO.ComfyNode): is_api_node=True, is_output_node=True, price_badge=IO.PriceBadge( - depends_on=IO.PriceBadgeDepends(widgets=["should_texture"]), + depends_on=IO.PriceBadgeDepends( + widgets=["should_texture", "should_texture.texture_resolution"], + ), expr=""" ( - $prices := {"true": 0.6, "false": 0.2}; - {"type":"usd","usd": $lookup($prices, widgets.should_texture)} + $textured := widgets.should_texture = "true"; + $resolution := $textured ? $lookup(widgets, "should_texture.texture_resolution") : "2k"; + $credits := ($textured ? 30 : 20) + ($resolution = "8k" ? 5 : 0); + {"type":"usd","usd": $round($credits * 0.0572, 4)} ) """, ), @@ -546,6 +604,7 @@ class MeshyMultiImageToModelNode(IO.ComfyNode): should_remesh=should_remesh["should_remesh"] == "true", should_texture=texture, enable_pbr=should_texture.get("enable_pbr", None), + texture_resolution=should_texture.get("texture_resolution", None), pose_mode=pose_mode.lower(), texture_prompt=texture_prompt, texture_image_url=texture_image_url, @@ -609,7 +668,7 @@ class MeshyRigModelNode(IO.ComfyNode): is_api_node=True, is_output_node=True, price_badge=IO.PriceBadge( - expr="""{"type":"usd","usd":0.2}""", + expr="""{"type":"usd","usd": 0.286}""", ), ) @@ -681,7 +740,7 @@ class MeshyAnimateModelNode(IO.ComfyNode): is_api_node=True, is_output_node=True, price_badge=IO.PriceBadge( - expr="""{"type":"usd","usd":0.12}""", + expr="""{"type":"usd","usd": 0.1716}""", ), ) @@ -724,7 +783,7 @@ class MeshyTextureNode(IO.ComfyNode): display_name="Meshy: Texture Model", category="partner/3d/Meshy", inputs=[ - IO.Combo.Input("model", options=["latest"]), + IO.Combo.Input("model", options=["meshy-7", "meshy-6", "latest"]), IO.Custom("MESHY_TASK_ID").Input("meshy_task_id"), IO.Boolean.Input( "enable_original_uv", @@ -748,10 +807,15 @@ class MeshyTextureNode(IO.ComfyNode): tooltip="A 2d image to guide the texturing process. " "Can not be used at the same time with 'text_style_prompt'.", ), + IO.Combo.Input( + "texture_resolution", + options=["2k", "4k", "8k"], + tooltip="Base color texture resolution. Higher resolutions capture more surface detail.", + ), ], outputs=[ IO.String.Output(display_name="model_file"), # for backward compatibility only - IO.Custom("MODEL_TASK_ID").Output(display_name="meshy_task_id"), + IO.Custom("MESHY_TASK_ID").Output(display_name="meshy_task_id"), IO.File3DGLB.Output(display_name="GLB"), IO.File3DFBX.Output(display_name="FBX"), ], @@ -763,7 +827,13 @@ class MeshyTextureNode(IO.ComfyNode): is_api_node=True, is_output_node=True, price_badge=IO.PriceBadge( - expr="""{"type":"usd","usd":0.4}""", + depends_on=IO.PriceBadgeDepends(widgets=["texture_resolution"]), + expr=""" + ( + $credits := widgets.texture_resolution = "8k" ? 15 : 10; + {"type":"usd","usd": $round($credits * 0.0572, 4)} + ) + """, ), ) @@ -775,6 +845,7 @@ class MeshyTextureNode(IO.ComfyNode): enable_original_uv: bool, pbr: bool, text_style_prompt: str, + texture_resolution: str, image_style: Input.Image | None = None, ) -> IO.NodeOutput: if text_style_prompt and image_style is not None: @@ -793,6 +864,7 @@ class MeshyTextureNode(IO.ComfyNode): ai_model=model, enable_original_uv=enable_original_uv, enable_pbr=pbr, + texture_resolution=texture_resolution, text_style_prompt=text_style_prompt if text_style_prompt else None, image_style_url=image_style_url, ), @@ -813,6 +885,108 @@ class MeshyTextureNode(IO.ComfyNode): ) +class MeshyTextureMultiViewNode(IO.ComfyNode): + + @classmethod + def define_schema(cls): + return IO.Schema( + node_id="MeshyTextureMultiViewNode", + display_name="Meshy: Texture Model (Multi-View)", + category="partner/3d/Meshy", + description="Texture a previously created model using 1 to 4 reference views of the same object.", + inputs=[ + IO.Combo.Input("model", options=["meshy-7"]), + IO.Custom("MESHY_TASK_ID").Input("meshy_task_id"), + IO.Autogrow.Input( + "multiview_images", + template=IO.Autogrow.TemplatePrefix(IO.Image.Input("image"), prefix="image", min=1, max=4), + tooltip="Reference views of the same object. The first image is the primary (front) view; " + "the order of the remaining views does not matter.", + ), + IO.Boolean.Input( + "enable_original_uv", + default=True, + tooltip="Use the original UV of the model instead of generating new UVs. " + "When enabled, Meshy preserves existing textures from the uploaded model. " + "If the model has no original UV, the quality of the output might not be as good.", + advanced=True, + ), + IO.Boolean.Input("pbr", default=False, advanced=True), + IO.Combo.Input( + "texture_resolution", + options=["2k", "4k", "8k"], + tooltip="Base color texture resolution. Higher resolutions capture more surface detail.", + ), + ], + outputs=[ + IO.String.Output(display_name="model_file"), # for backward compatibility only + IO.Custom("MESHY_TASK_ID").Output(display_name="meshy_task_id"), + IO.File3DGLB.Output(display_name="GLB"), + IO.File3DFBX.Output(display_name="FBX"), + ], + hidden=[ + IO.Hidden.auth_token_comfy_org, + IO.Hidden.api_key_comfy_org, + IO.Hidden.unique_id, + ], + is_api_node=True, + is_output_node=True, + price_badge=IO.PriceBadge( + depends_on=IO.PriceBadgeDepends(widgets=["texture_resolution"]), + expr=""" + ( + $credits := widgets.texture_resolution = "8k" ? 15 : 10; + {"type":"usd","usd": $round($credits * 0.0572, 4)} + ) + """, + ), + ) + + @classmethod + async def execute( + cls, + model: str, + meshy_task_id: str, + multiview_images: IO.Autogrow.Type, + enable_original_uv: bool, + pbr: bool, + texture_resolution: str, + ) -> IO.NodeOutput: + reference_views = list(multiview_images.values()) + view_count = sum(v.shape[0] if len(v.shape) > 3 else 1 for v in reference_views) + if not 1 <= view_count <= 4: + raise ValueError("multiview_images must contain 1 to 4 images") + response = await sync_op( + cls, + endpoint=ApiEndpoint(path="/proxy/meshy/openapi/v1/retexture", method="POST"), + response_model=MeshyTaskResponse, + data=MeshyTextureRequest( + input_task_id=meshy_task_id, + ai_model=model, + enable_original_uv=enable_original_uv, + enable_pbr=pbr, + texture_resolution=texture_resolution, + multiview_image_urls=await upload_images_to_comfyapi( + cls, reference_views, max_images=4, wait_label="Uploading reference views" + ), + ), + ) + task_id = response.result + result = await poll_op( + cls, + ApiEndpoint(path=f"/proxy/meshy/openapi/v1/retexture/{task_id}"), + response_model=MeshyModelResult, + status_extractor=lambda r: r.status, + progress_extractor=lambda r: r.progress, + ) + return IO.NodeOutput( + f"{task_id}.glb", + task_id, + await download_url_to_file_3d(result.model_urls.glb, "glb", task_id=task_id), + await download_url_to_file_3d(result.model_urls.fbx, "fbx", task_id=task_id), + ) + + class MeshyExtension(ComfyExtension): @override async def get_node_list(self) -> list[type[IO.ComfyNode]]: @@ -824,6 +998,7 @@ class MeshyExtension(ComfyExtension): MeshyRigModelNode, MeshyAnimateModelNode, MeshyTextureNode, + MeshyTextureMultiViewNode, ]