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.

[add] tripo3.0 (#10663)

seed93d02d0e5744f2
diff --git a/comfy_api_nodes/apis/tripo_api.py b/comfy_api_nodes/apis/tripo_api.py
index 713260e2a..ffaaa7dc1 100644
--- a/comfy_api_nodes/apis/tripo_api.py
+++ b/comfy_api_nodes/apis/tripo_api.py
@@ -5,11 +5,17 @@ from typing import Optional, List, Dict, Any, Union
from pydantic import BaseModel, Field, RootModel
class TripoModelVersion(str, Enum):
+ v3_0_20250812 = 'v3.0-20250812'
v2_5_20250123 = 'v2.5-20250123'
v2_0_20240919 = 'v2.0-20240919'
v1_4_20240625 = 'v1.4-20240625'
+class TripoGeometryQuality(str, Enum):
+ standard = 'standard'
+ detailed = 'detailed'
+
+
class TripoTextureQuality(str, Enum):
standard = 'standard'
detailed = 'detailed'
@@ -61,14 +67,20 @@ class TripoSpec(str, Enum):
class TripoAnimation(str, Enum):
IDLE = "preset:idle"
WALK = "preset:walk"
+ RUN = "preset:run"
+ DIVE = "preset:dive"
CLIMB = "preset:climb"
JUMP = "preset:jump"
- RUN = "preset:run"
SLASH = "preset:slash"
SHOOT = "preset:shoot"
HURT = "preset:hurt"
FALL = "preset:fall"
TURN = "preset:turn"
+ QUADRUPED_WALK = "preset:quadruped:walk"
+ HEXAPOD_WALK = "preset:hexapod:walk"
+ OCTOPOD_WALK = "preset:octopod:walk"
+ SERPENTINE_MARCH = "preset:serpentine:march"
+ AQUATIC_MARCH = "preset:aquatic:march"
class TripoStylizeStyle(str, Enum):
LEGO = "lego"
@@ -105,6 +117,11 @@ class TripoTaskStatus(str, Enum):
BANNED = "banned"
EXPIRED = "expired"
+class TripoFbxPreset(str, Enum):
+ BLENDER = "blender"
+ MIXAMO = "mixamo"
+ _3DSMAX = "3dsmax"
+
class TripoFileTokenReference(BaseModel):
type: Optional[str] = Field(None, description='The type of the reference')
file_token: str
@@ -142,6 +159,7 @@ class TripoTextToModelRequest(BaseModel):
model_seed: Optional[int] = Field(None, description='The seed for the model')
texture_seed: Optional[int] = Field(None, description='The seed for the texture')
texture_quality: Optional[TripoTextureQuality] = TripoTextureQuality.standard
+ geometry_quality: Optional[TripoGeometryQuality] = TripoGeometryQuality.standard
style: Optional[TripoStyle] = None
auto_size: Optional[bool] = Field(False, description='Whether to auto-size the model')
quad: Optional[bool] = Field(False, description='Whether to apply quad to the generated model')
@@ -156,6 +174,7 @@ class TripoImageToModelRequest(BaseModel):
model_seed: Optional[int] = Field(None, description='The seed for the model')
texture_seed: Optional[int] = Field(None, description='The seed for the texture')
texture_quality: Optional[TripoTextureQuality] = TripoTextureQuality.standard
+ geometry_quality: Optional[TripoGeometryQuality] = TripoGeometryQuality.standard
texture_alignment: Optional[TripoTextureAlignment] = Field(TripoTextureAlignment.ORIGINAL_IMAGE, description='The texture alignment method')
style: Optional[TripoStyle] = Field(None, description='The style to apply to the generated model')
auto_size: Optional[bool] = Field(False, description='Whether to auto-size the model')
@@ -173,6 +192,7 @@ class TripoMultiviewToModelRequest(BaseModel):
model_seed: Optional[int] = Field(None, description='The seed for the model')
texture_seed: Optional[int] = Field(None, description='The seed for the texture')
texture_quality: Optional[TripoTextureQuality] = TripoTextureQuality.standard
+ geometry_quality: Optional[TripoGeometryQuality] = TripoGeometryQuality.standard
texture_alignment: Optional[TripoTextureAlignment] = TripoTextureAlignment.ORIGINAL_IMAGE
auto_size: Optional[bool] = Field(False, description='Whether to auto-size the model')
orientation: Optional[TripoOrientation] = Field(TripoOrientation.DEFAULT, description='The orientation for the model')
@@ -219,14 +239,24 @@ class TripoConvertModelRequest(BaseModel):
type: TripoTaskType = Field(TripoTaskType.CONVERT_MODEL, description='Type of task')
format: TripoConvertFormat = Field(..., description='The format to convert to')
original_model_task_id: str = Field(..., description='The task ID of the original model')
- quad: Optional[bool] = Field(False, description='Whether to apply quad to the model')
- force_symmetry: Optional[bool] = Field(False, description='Whether to force symmetry')
- face_limit: Optional[int] = Field(10000, description='The number of faces to limit the conversion to')
- flatten_bottom: Optional[bool] = Field(False, description='Whether to flatten the bottom of the model')
- flatten_bottom_threshold: Optional[float] = Field(0.01, description='The threshold for flattening the bottom')
- texture_size: Optional[int] = Field(4096, description='The size of the texture')
+ quad: Optional[bool] = Field(None, description='Whether to apply quad to the model')
+ force_symmetry: Optional[bool] = Field(None, description='Whether to force symmetry')
+ face_limit: Optional[int] = Field(None, description='The number of faces to limit the conversion to')
+ flatten_bottom: Optional[bool] = Field(None, description='Whether to flatten the bottom of the model')
+ flatten_bottom_threshold: Optional[float] = Field(None, description='The threshold for flattening the bottom')
+ texture_size: Optional[int] = Field(None, description='The size of the texture')
texture_format: Optional[TripoTextureFormat] = Field(TripoTextureFormat.JPEG, description='The format of the texture')
- pivot_to_center_bottom: Optional[bool] = Field(False, description='Whether to pivot to the center bottom')
+ pivot_to_center_bottom: Optional[bool] = Field(None, description='Whether to pivot to the center bottom')
+ scale_factor: Optional[float] = Field(None, description='The scale factor for the model')
+ with_animation: Optional[bool] = Field(None, description='Whether to include animations')
+ pack_uv: Optional[bool] = Field(None, description='Whether to pack the UVs')
+ bake: Optional[bool] = Field(None, description='Whether to bake the model')
+ part_names: Optional[List[str]] = Field(None, description='The names of the parts to include')
+ fbx_preset: Optional[TripoFbxPreset] = Field(None, description='The preset for the FBX export')
+ export_vertex_colors: Optional[bool] = Field(None, description='Whether to export the vertex colors')
+ export_orientation: Optional[TripoOrientation] = Field(None, description='The orientation for the export')
+ animate_in_place: Optional[bool] = Field(None, description='Whether to animate in place')
+
class TripoTaskRequest(RootModel):
root: Union[
diff --git a/comfy_api_nodes/nodes_tripo.py b/comfy_api_nodes/nodes_tripo.py
index 697100ff2..bd3c24fb3 100644
--- a/comfy_api_nodes/nodes_tripo.py
+++ b/comfy_api_nodes/nodes_tripo.py
@@ -102,8 +102,9 @@ class TripoTextToModelNode(IO.ComfyNode):
IO.Int.Input("model_seed", default=42, optional=True),
IO.Int.Input("texture_seed", default=42, optional=True),
IO.Combo.Input("texture_quality", default="standard", options=["standard", "detailed"], optional=True),
- IO.Int.Input("face_limit", default=-1, min=-1, max=500000, optional=True),
+ IO.Int.Input("face_limit", default=-1, min=-1, max=2000000, optional=True),
IO.Boolean.Input("quad", default=False, optional=True),
+ IO.Combo.Input("geometry_quality", default="standard", options=["standard", "detailed"], optional=True),
],
outputs=[
IO.String.Output(display_name="model_file"),
@@ -131,6 +132,7 @@ class TripoTextToModelNode(IO.ComfyNode):
model_seed: Optional[int] = None,
texture_seed: Optional[int] = None,
texture_quality: Optional[str] = None,
+ geometry_quality: Optional[str] = None,
face_limit: Optional[int] = None,
quad: Optional[bool] = None,
) -> IO.NodeOutput:
@@ -154,6 +156,7 @@ class TripoTextToModelNode(IO.ComfyNode):
texture_seed=texture_seed,
texture_quality=texture_quality,
face_limit=face_limit,
+ geometry_quality=geometry_quality,
auto_size=True,
quad=quad,
),
@@ -194,6 +197,7 @@ class TripoImageToModelNode(IO.ComfyNode):
),
IO.Int.Input("face_limit", default=-1, min=-1, max=500000, optional=True),
IO.Boolean.Input("quad", default=False, optional=True),
+ IO.Combo.Input("geometry_quality", default="standard", options=["standard", "detailed"], optional=True),
],
outputs=[
IO.String.Output(display_name="model_file"),
@@ -220,6 +224,7 @@ class TripoImageToModelNode(IO.ComfyNode):
orientation=None,
texture_seed: Optional[int] = None,
texture_quality: Optional[str] = None,
+ geometry_quality: Optional[str] = None,
texture_alignment: Optional[str] = None,
face_limit: Optional[int] = None,
quad: Optional[bool] = None,
@@ -246,6 +251,7 @@ class TripoImageToModelNode(IO.ComfyNode):
pbr=pbr,
model_seed=model_seed,
orientation=orientation,
+ geometry_quality=geometry_quality,
texture_alignment=texture_alignment,
texture_seed=texture_seed,
texture_quality=texture_quality,
@@ -295,6 +301,7 @@ class TripoMultiviewToModelNode(IO.ComfyNode):
),
IO.Int.Input("face_limit", default=-1, min=-1, max=500000, optional=True),
IO.Boolean.Input("quad", default=False, optional=True),
+ IO.Combo.Input("geometry_quality", default="standard", options=["standard", "detailed"], optional=True),
],
outputs=[
IO.String.Output(display_name="model_file"),
@@ -323,6 +330,7 @@ class TripoMultiviewToModelNode(IO.ComfyNode):
model_seed: Optional[int] = None,
texture_seed: Optional[int] = None,
texture_quality: Optional[str] = None,
+ geometry_quality: Optional[str] = None,
texture_alignment: Optional[str] = None,
face_limit: Optional[int] = None,
quad: Optional[bool] = None,
@@ -359,6 +367,7 @@ class TripoMultiviewToModelNode(IO.ComfyNode):
model_seed=model_seed,
texture_seed=texture_seed,
texture_quality=texture_quality,
+ geometry_quality=geometry_quality,
texture_alignment=texture_alignment,
face_limit=face_limit,
quad=quad,
@@ -508,6 +517,8 @@ class TripoRetargetNode(IO.ComfyNode):
options=[
"preset:idle",
"preset:walk",
+ "preset:run",
+ "preset:dive",
"preset:climb",
"preset:jump",
"preset:slash",
@@ -515,6 +526,11 @@ class TripoRetargetNode(IO.ComfyNode):
"preset:hurt",
"preset:fall",
"preset:turn",
+ "preset:quadruped:walk",
+ "preset:hexapod:walk",
+ "preset:octopod:walk",
+ "preset:serpentine:march",
+ "preset:aquatic:march"
],
),
],
@@ -563,7 +579,7 @@ class TripoConversionNode(IO.ComfyNode):
"face_limit",
default=-1,
min=-1,
- max=500000,
+ max=2000000,
optional=True,
),
IO.Int.Input(
@@ -579,6 +595,40 @@ class TripoConversionNode(IO.ComfyNode):
default="JPEG",
optional=True,
),
+ IO.Boolean.Input("force_symmetry", default=False, optional=True),
+ IO.Boolean.Input("flatten_bottom", default=False, optional=True),
+ IO.Float.Input(
+ "flatten_bottom_threshold",
+ default=0.0,
+ min=0.0,
+ max=1.0,
+ optional=True,
+ ),
+ IO.Boolean.Input("pivot_to_center_bottom", default=False, optional=True),
+ IO.Float.Input(
+ "scale_factor",
+ default=1.0,
+ min=0.0,
+ optional=True,
+ ),
+ IO.Boolean.Input("with_animation", default=False, optional=True),
+ IO.Boolean.Input("pack_uv", default=False, optional=True),
+ IO.Boolean.Input("bake", default=False, optional=True),
+ IO.String.Input("part_names", default="", optional=True), # comma-separated list
+ IO.Combo.Input(
+ "fbx_preset",
+ options=["blender", "mixamo", "3dsmax"],
+ default="blender",
+ optional=True,
+ ),
+ IO.Boolean.Input("export_vertex_colors", default=False, optional=True),
+ IO.Combo.Input(
+ "export_orientation",
+ options=["align_image", "default"],
+ default="default",
+ optional=True,
+ ),
+ IO.Boolean.Input("animate_in_place", default=False, optional=True),
],
outputs=[],
hidden=[
@@ -604,12 +654,31 @@ class TripoConversionNode(IO.ComfyNode):
original_model_task_id,
format: str,
quad: bool,
+ force_symmetry: bool,
face_limit: int,
+ flatten_bottom: bool,
+ flatten_bottom_threshold: float,
texture_size: int,
texture_format: str,
+ pivot_to_center_bottom: bool,
+ scale_factor: float,
+ with_animation: bool,
+ pack_uv: bool,
+ bake: bool,
+ part_names: str,
+ fbx_preset: str,
+ export_vertex_colors: bool,
+ export_orientation: str,
+ animate_in_place: bool,
) -> IO.NodeOutput:
if not original_model_task_id:
raise RuntimeError("original_model_task_id is required")
+
+ # Parse part_names from comma-separated string to list
+ part_names_list = None
+ if part_names and part_names.strip():
+ part_names_list = [name.strip() for name in part_names.split(',') if name.strip()]
+
response = await sync_op(
cls,
endpoint=ApiEndpoint(path="/proxy/tripo/v2/openapi/task", method="POST"),
@@ -618,9 +687,22 @@ class TripoConversionNode(IO.ComfyNode):
original_model_task_id=original_model_task_id,
format=format,
quad=quad if quad else None,
+ force_symmetry=force_symmetry if force_symmetry else None,
face_limit=face_limit if face_limit != -1 else None,
+ flatten_bottom=flatten_bottom if flatten_bottom else None,
+ flatten_bottom_threshold=flatten_bottom_threshold if flatten_bottom_threshold != 0.0 else None,
texture_size=texture_size if texture_size != 4096 else None,
texture_format=texture_format if texture_format != "JPEG" else None,
+ pivot_to_center_bottom=pivot_to_center_bottom if pivot_to_center_bottom else None,
+ scale_factor=scale_factor if scale_factor != 1.0 else None,
+ with_animation=with_animation if with_animation else None,
+ pack_uv=pack_uv if pack_uv else None,
+ bake=bake if bake else None,
+ part_names=part_names_list,
+ fbx_preset=fbx_preset if fbx_preset != "blender" else None,
+ export_vertex_colors=export_vertex_colors if export_vertex_colors else None,
+ export_orientation=export_orientation if export_orientation != "default" else None,
+ animate_in_place=animate_in_place if animate_in_place else None,
),
)
return await poll_until_finished(cls, response, average_duration=30)