---
canonical_url: "https://docs.composio.dev/toolkits/tripo3d"
markdown_url: "https://docs.composio.dev/toolkits/tripo3d.md"
product: "platform"
version: null
last_updated: null
---

# Tripo3D

Tripo3D provides AI-powered 3D model and image generation, model processing, mesh operations, animation, file upload, task tracking, and account usage APIs.

- **Category:** media generation
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 23
- **Triggers:** 0
- **Slug:** `TRIPO3D`
- **Version:** 20261014_00

## Tools

### Check Model Riggability

**Slug:** `TRIPO3D_CHECK_MODEL_RIGGABILITY`

Submit an asynchronous check that determines whether a GLB model can be rigged and recommends a rig type. Returns a bare UUID task ID; query it with GET_TASK or GET_TASKS. The live-tested check consumed no credits.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `input` | string | Yes | Source GLB bare task UUID, Tripo file token, or public URL; the model may be at most 150 MB. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Complete Mesh

**Slug:** `TRIPO3D_COMPLETE_MESH`

Submit a credit-consuming asynchronous task to complete selected segmented parts or cap open boundaries. Requires a successful segmentation bare task UUID and returns a new bare task UUID for GET_TASK or GET_TASKS.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `input` | string | Yes | Bare UUID of a successful SEGMENT_MESH task. Other model references are not accepted by this workflow. |
| `model` | string | No | Mesh-completion model version; v1.0-20250506 is live-tested. |
| `part_names` | array | No | Optional segmented part names to complete. |
| `completion_mode` | string ("ai_completion" | "quick_cap") | No | Use AI completion or the lower-cost boundary-capping path. quick_cap is live-tested. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Convert Model

**Slug:** `TRIPO3D_CONVERT_MODEL`

Submit a credit-consuming asynchronous task to convert a model format and optionally alter topology, textures, orientation, scale, or animation export. Returns a bare UUID task ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `bake` | boolean | No | Bake textures into the converted output. |
| `quad` | boolean | No | Convert to quad topology. When enabled, the target format is forced to FBX. |
| `input` | string | Yes | Source model bare task UUID, Tripo file token, or public URL; model files may be at most 150 MB. |
| `format` | string ("GLTF" | "FBX" | "USDZ" | "OBJ" | "STL" | "3MF") | Yes | Target model format; GLTF is live-tested. |
| `pack_uv` | boolean | No | Repack output UV coordinates. |
| `face_limit` | integer | No | Requested output face limit. |
| `fbx_preset` | string ("blender" | "3dsmax" | "mixamo" | "bake_scale") | No | FBX compatibility preset. |
| `part_names` | array | No | Optional model parts to include. |
| `scale_factor` | number | No | Multiplier applied to model scale. |
| `texture_size` | integer | No | Output texture resolution in pixels. |
| `flatten_bottom` | boolean | No | Flatten the model's bottom surface. |
| `force_symmetry` | boolean | No | Force symmetrical topology; requires quad=true. |
| `texture_format` | string ("JPEG" | "PNG" | "WEBP" | "BMP" | "DPX" | "HDR" | "OPEN_EXR" | "TARGA" | "TIFF") | No | Output texture image format. |
| `with_animation` | boolean | No | Include existing animation data. |
| `animate_in_place` | boolean | No | Convert animation to remain in place. |
| `export_orientation` | string ("+x" | "-x" | "-y" | "+y") | No | Output forward-axis orientation. |
| `export_vertex_colors` | boolean | No | Export vertex colors; supported only for OBJ and GLTF output. |
| `pivot_to_center_bottom` | boolean | No | Move the pivot to the center of the model's bottom. |
| `flatten_bottom_threshold` | number | No | Threshold used when flatten_bottom is enabled. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Presigned Upload

**Slug:** `TRIPO3D_CREATE_PRESIGNED_UPLOAD`

Reserve a presigned URL and file token for a client-managed upload. This action only reserves the upload and does not upload bytes. A separate raw PUT to presigned_url is required without Tripo Authorization or any connected-account credentials; the file token is usable only after that PUT completes successfully.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `format` | string ("jpeg" | "jpg" | "png" | "webp" | "bmp" | "tiff" | "glb" | "gltf" | "fbx" | "obj" | "stl" | "3mf" | "usdz") | Yes | Lowercase file extension without a leading dot. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Decimate Mesh

**Slug:** `TRIPO3D_DECIMATE_MESH`

Submit a credit-consuming asynchronous task to reduce a model's polygon count using basic decimation or smart retopology. Returns a bare UUID task ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `bake` | boolean | No | Bake textures onto the low-poly model. Supported only by v2.0; omit this field when using v1.0. |
| `quad` | boolean | No | Produce quad rather than triangle topology. |
| `input` | string | Yes | Source model bare task UUID, Tripo file token, or public GLB, GLTF, FBX, OBJ, or STL URL; uploaded models may be at most 150 MB. |
| `model` | string ("v2.0" | "v1.0") | No | Retopology algorithm: v2.0 performs 30-credit smart retopology; v1.0 performs 10-credit basic decimation. v1.0 is live-tested. |
| `face_limit` | integer | No | Target face count. Required for v1.0. For v2.0, use 500-20,000 triangles or 500-10,000 quads, or omit it for adaptive reduction. |
| `part_names` | array | No | Names of segmented parts to retopologize. Supported only by v2.0; omit this field when using v1.0. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Edit Image

**Slug:** `TRIPO3D_EDIT_IMAGE`

Submit a credit-consuming asynchronous task to edit one or more reference images. Returns a bare UUID task ID; completed generated image URLs are temporary.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `size` | string | No | Output dimensions; allowed values depend on the selected model. |
| `input` | string | No | One primary public image URL, Tripo file token, or successful image-task bare UUID. Mutually exclusive with inputs. |
| `model` | string ("seedream_v5" | "banana" | "banana_pro" | "banana2" | "chat_image_1" | "chat_image_1.5" | "chat_image_2") | No | Image-editing model; banana is live-tested. |
| `inputs` | array | No | Multiple reference images. Limits are 4 for Seedream, 10 for Banana, and 16 for Chat Image. Mutually exclusive with input. |
| `prompt` | string | No | Editing instruction; required when template is omitted. |
| `template` | string ("t_pose" | "character_completion" | "3d_enhance" | "variants" | "figure") | No | Optional predefined edit template. |
| `aspect_ratio` | string | No | Requested aspect ratio for Banana-family models. |
| `output_format` | string ("png" | "jpeg") | No | Generated image format. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Edit Multiview

**Slug:** `TRIPO3D_EDIT_MULTIVIEW`

Submit a credit-consuming asynchronous task to apply view-specific text edits to a multiview set. Returns a bare UUID task ID; completed view URLs are temporary.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `input` | string | Yes | Prior multiview bare task UUID, Tripo file token, or public multiview URL. |
| `prompts` | array | Yes | One or more view-specific edit instructions. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Generate Image from Text

**Slug:** `TRIPO3D_GENERATE_IMAGE_FROM_TEXT`

Submit a credit-consuming asynchronous image-generation task from a text prompt. Returns a bare UUID task ID; use GET_TASK or GET_TASKS to retrieve the result, and download the temporary generated_image_url promptly.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `size` | string | No | Output dimensions, such as 1024x1024. Allowed values depend on the model. |
| `model` | string ("seedream_v5" | "seedream_v4" | "banana" | "banana_pro" | "banana2" | "chat_image_1" | "chat_image_1.5" | "chat_image_2") | No | Image-generation model. The banana model with size 1024x1024 is live-tested. |
| `prompt` | string | Yes | Text description of the image to generate. |
| `template` | string ("asset_extraction" | "character_completion" | "t_pose" | "variants" | "figure") | No | Optional predefined image-generation template. |
| `watermark` | boolean | No | Whether to add a watermark. Effective only for Seedream models. |
| `aspect_ratio` | string | No | Requested aspect ratio for Banana-family models. |
| `output_format` | string ("png" | "jpeg") | No | Generated image file format. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Generate Model from Image

**Slug:** `TRIPO3D_GENERATE_MODEL_FROM_IMAGE`

Submit a credit-consuming asynchronous task to generate a 3D model from one image, file token, or successful image-task UUID. Returns a bare UUID task ID for GET_TASK or GET_TASKS.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `pbr` | boolean | No | Generate PBR materials. |
| `quad` | boolean | No | Generate quad topology; support depends on the selected model family. |
| `input` | string | Yes | One public PNG, JPEG, or WebP URL, Tripo file token, or bare UUID of a successful text-to-image or image-to-image task. Images may be at most 20 MB. |
| `model` | string ("v3.1-20260211" | "v3.0-20250812" | "v2.5-20250123" | "P1-20260311" | "P2-20260801") | Yes | Tripo H- or P-series model version. v3.1-20260211 is the live-tested H-series value. |
| `texture` | boolean | No | Generate textures. Set false with pbr=false for the live-tested lower-cost untextured path. |
| `compress` | string | No | Optional geometry compression mode. |
| `auto_size` | boolean | No | Automatically normalize model scale for H3 and P-series models. |
| `export_uv` | boolean | No | Include UV coordinates in the exported model. |
| `face_limit` | integer | No | Requested polygon face limit; valid ranges depend on the selected model. |
| `model_seed` | integer | No | Optional geometry-generation seed. |
| `orientation` | string ("default" | "align_image") | No | Use the default model orientation or align it to the source image. |
| `texture_seed` | integer | No | Optional texture-generation seed. |
| `generate_parts` | boolean | No | Generate separate parts on H3 models; requires texture=false and pbr=false and cannot be combined with quad or smart_low_poly. |
| `smart_low_poly` | boolean | No | Use H3-series smart low-poly generation. |
| `texture_quality` | string ("standard" | "detailed" | "extreme") | No | Texture detail level for H3 and P-series models. |
| `geometry_quality` | string ("standard" | "detailed") | No | Geometry detail level; available on H-series v3.0 and later. |
| `texture_alignment` | string ("original_image" | "geometry") | No | Align texture to the source image or to the generated geometry. |
| `export_orientation` | string ("+x" | "-x" | "-y" | "+y") | No | Final export orientation; leave unset before post-processing. |
| `enable_image_autofix` | boolean | No | Automatically repair unsuitable source-image characteristics before generation. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Generate Model from Multiview

**Slug:** `TRIPO3D_GENERATE_MODEL_FROM_MULTIVIEW`

Submit a credit-consuming asynchronous task to generate a 3D model from multiple views or one multiview task UUID. Returns a bare UUID task ID for later status queries.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `pbr` | boolean | No | Generate PBR materials. |
| `quad` | boolean | No | Generate quad topology on H3 or P2 models. |
| `model` | string ("v3.1-20260211" | "v3.0-20250812" | "v2.5-20250123" | "P1-20260311" | "P2-20260801") | Yes | Tripo H- or P-series model version; v3.1-20260211 is live-tested. |
| `inputs` | array | Yes | Use exactly one format: 2-4 single-key view objects using front, left, back, or right (front required); exactly four positional image URL or file-token strings; or one object containing a successful multiview task_id. Do not mix formats. |
| `texture` | boolean | No | Generate textures. |
| `compress` | string | No | Optional geometry compression mode. |
| `auto_size` | boolean | No | Automatically normalize scale for H3 and P-series models. |
| `export_uv` | boolean | No | Include UV coordinates. |
| `face_limit` | integer | No | Requested face limit; supported ranges depend on the model. |
| `model_seed` | integer | No | Optional geometry seed. |
| `orientation` | string ("default" | "align_image") | No | Use default model orientation or align it to the source views. |
| `texture_seed` | integer | No | Optional texture seed. |
| `generate_parts` | boolean | No | Generate separate model parts on H3 models. |
| `smart_low_poly` | boolean | No | Use H3-series smart low-poly generation. |
| `texture_quality` | string ("standard" | "detailed" | "extreme") | No | Texture detail level for H3 and P-series models. |
| `geometry_quality` | string ("standard" | "detailed") | No | Geometry detail level for H3 models. |
| `texture_alignment` | string ("original_image" | "geometry") | No | Align textures to source imagery or generated geometry. |
| `export_orientation` | string ("+x" | "-x" | "-y" | "+y") | No | Final export orientation; leave unset before post-processing. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Generate Model from Text

**Slug:** `TRIPO3D_GENERATE_MODEL_FROM_TEXT`

Submit a credit-consuming asynchronous task to generate a 3D model from text. Returns a bare UUID task ID immediately; query it with GET_TASK or GET_TASKS and download completed output URLs promptly.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `pbr` | boolean | No | Generate PBR materials; disable with texture for an untextured model. |
| `quad` | boolean | No | Generate quad topology. H-series quad output forces FBX; P-series supports it only on P2. |
| `model` | string ("v3.1-20260211" | "v3.0-20250812" | "v2.5-20250123" | "P1-20260311" | "P2-20260801") | Yes | Tripo H- or P-series model version; v3.1-20260211 is the live-tested H-series value. |
| `prompt` | string | Yes | Text description of the model to generate (maximum 1024 characters). |
| `texture` | boolean | No | Generate textures. Set false with pbr=false for the live-tested lower-cost untextured path. |
| `compress` | string | No | Optional geometry compression mode. |
| `auto_size` | boolean | No | Automatically normalize model scale for H3 and P-series models. |
| `export_uv` | boolean | No | Include UV coordinates in the exported model. |
| `face_limit` | integer | No | Requested polygon face limit; supported ranges depend on model and topology options. |
| `image_seed` | integer | No | Optional seed for generated reference imagery. |
| `model_seed` | integer | No | Optional seed for model geometry generation. |
| `texture_seed` | integer | No | Optional texture-generation seed. |
| `generate_parts` | boolean | No | Generate separate parts; requires texture=false and pbr=false and cannot be combined with quad or smart_low_poly. |
| `smart_low_poly` | boolean | No | Use H3-series smart low-poly generation. |
| `negative_prompt` | string | No | Features to avoid in the result (maximum 255 characters). |
| `texture_quality` | string ("standard" | "detailed" | "extreme") | No | Texture detail level for H3 and P-series models. |
| `geometry_quality` | string ("standard" | "detailed") | No | Geometry detail level; available on H v3.0 and later. |
| `export_orientation` | string ("+x" | "-x" | "-y" | "+y") | No | Final export orientation. Leave unset if the model will be post-processed to avoid incorrect downstream orientation. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Generate Multiview from Image

**Slug:** `TRIPO3D_GENERATE_MULTIVIEW_FROM_IMAGE`

Submit a credit-consuming asynchronous task to generate front, left, back, and right views from one image. Returns a bare UUID task ID; use GET_TASK or GET_TASKS to retrieve the result, and download the four temporary view URLs promptly.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `input` | string | Yes | Public PNG, JPEG, or WebP URL or Tripo image file token. Task UUID input is not documented for this endpoint. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Generate Splat from Image

**Slug:** `TRIPO3D_GENERATE_SPLAT_FROM_IMAGE`

Submit a credit-consuming asynchronous task to generate a Gaussian Splat scene from one image. Returns a bare UUID task ID; use GET_TASK or GET_TASKS to retrieve the result, and download the temporary .splat model URL promptly.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `input` | string | Yes | Public PNG, JPEG, or WebP URL or Tripo file token for an image up to 20 MB. |
| `model_seed` | integer | No | Optional deterministic generation seed. The value 7 is live-tested. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Balance

**Slug:** `TRIPO3D_GET_BALANCE`

Get the authenticated account's available and frozen Tripo credit balances.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Task

**Slug:** `TRIPO3D_GET_TASK`

Get status, progress, errors, credits, timestamps, and type-specific output for one asynchronous task. Use a bare UUID without a task_ prefix. Download successful output URLs promptly because they are temporary.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `task_id` | string | Yes | Bare Tripo V3 task UUID returned by a submission tool; do not prepend task_. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Tasks

**Slug:** `TRIPO3D_GET_TASKS`

Get snapshots for up to 100 asynchronous task UUIDs in one request. Inspect missed even on success because it lists unknown IDs. Prefer this tool when polling parallel jobs every 1-2 seconds, and download successful output URLs promptly because they are temporary.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `task_ids` | array | Yes | One to 100 distinct bare Tripo V3 task UUIDs; do not prepend task_. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Import Model

**Slug:** `TRIPO3D_IMPORT_MODEL`

Submit an asynchronous task to import an external model into Tripo for later processing. Returns a bare UUID task ID; the live-tested import consumed no credits but pricing is not guaranteed.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `input` | string | Yes | Tripo file token or public GLB, GLTF, FBX, OBJ, or STL URL; model files may be at most 150 MB. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Usage

**Slug:** `TRIPO3D_LIST_USAGE`

Return one newest-first page of per-task credit usage and an opaque continuation cursor. Pass next_cursor unchanged to retrieve the next offset page; the API provides no total count.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum usage records to return in this page (1-100). The tool caps pages at the live-tested size of 100. |
| `next_cursor` | string | No | Opaque continuation cursor returned by a previous call. Omit for the newest records and do not construct it manually. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Retarget Animation

**Slug:** `TRIPO3D_RETARGET_ANIMATION`

Submit a credit-consuming asynchronous task to apply one or up to five preset animations to a rigged model. Returns a bare UUID task ID; query it with GET_TASK or GET_TASKS and download completed model URLs promptly.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `input` | string | Yes | Bare UUID of a successful Tripo3D rigging task. |
| `animation` | string | No | One preset animation, such as the live-tested v1 preset preset:biped:idle. Use v1 preset:biped:* names with v1 rigs; V2.5 rigs use a different preset namespace. Mutually exclusive with animations. |
| `animations` | array | No | One to five preset animations. Use v1 preset:biped:* names with v1 rigs; V2.5 rigs use a different preset namespace. Mutually exclusive with animation. |
| `out_format` | string ("glb" | "fbx") | No | Animated model output format. |
| `bake_animation` | boolean | No | Bake animation into the model. This option is valid only for GLB output. |
| `animate_in_place` | boolean | No | Remove root translation so the animation remains in place. |
| `export_with_geometry` | boolean | No | Include model geometry with the animation export. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Rig Model

**Slug:** `TRIPO3D_RIG_MODEL`

Submit a credit-consuming asynchronous task to attach a biped or creature skeleton to a model. Run CHECK_MODEL_RIGGABILITY first and use its recommended rig type. Returns a bare UUID task ID for GET_TASK or GET_TASKS.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `spec` | string ("tripo" | "mixamo") | No | Skeleton naming and layout specification. |
| `input` | string | Yes | Source model bare task UUID, Tripo file token, or public model URL. |
| `model` | string ("v1.0-20240301" | "v2.5-20260210") | No | Rigging model version. v1.0-20240301 supports only biped rigs; v2.5-20260210 supports non-humanoid creature rigs. |
| `rig_type` | string ("biped" | "quadruped" | "hexapod" | "octopod" | "avian" | "serpentine" | "aquatic") | No | Skeleton type, preferably copied from CHECK_MODEL_RIGGABILITY output. Use biped with v1.0-20240301. |
| `out_format` | string ("glb" | "fbx") | No | Rigged model output format. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Segment Mesh

**Slug:** `TRIPO3D_SEGMENT_MESH`

Submit a credit-consuming asynchronous task to split a model into geometry-based or semantically labeled parts. Returns a bare UUID task ID used by COMPLETE_MESH or task-status tools.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `input` | string | Yes | Source model bare task UUID, Tripo file token, or public model URL. |
| `model` | string ("v1.0-20250506" | "v2.0-20260430") | No | Segmentation model. V1 performs geometry segmentation; V2 supports semantic segmentation options. |
| `ref_image` | string | No | V2-only reference image file token or public URL for semantic segmentation. It cannot be combined with explicit granularity or connectivity settings. |
| `split_by_connectivity` | boolean | No | V2-only option that splits disconnected geometry into separate parts. Omit when using ref_image because the reference image overrides this setting. |
| `segmentation_granularity` | string ("simple" | "balanced" | "detailed") | No | V2-only segmentation detail level. Omit when using ref_image because the reference image overrides this setting. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Texture Model

**Slug:** `TRIPO3D_TEXTURE_MODEL`

Submit a credit-consuming asynchronous task to apply or regenerate textures on an existing model. Returns a bare UUID task ID; completed model and preview URLs are temporary.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `pbr` | boolean | No | Generate PBR materials; pbr=false is the live-tested standard-texture path. |
| `bake` | boolean | No | Bake generated textures into the output model. |
| `input` | string | Yes | Source model bare task UUID, Tripo file token, or public model URL. |
| `model` | string ("v3.0-20250812" | "v2.5-20250123") | No | Texture model version. Use v3.0-20250812 for v3.0 or v3.1 source models and v2.5-20250123 for v2.5 source models; v3.0-20250812 is live-tested. |
| `compress` | string | No | Optional geometry compression mode. |
| `part_names` | array | No | Optional names of model parts to texture. |
| `texture_seed` | integer | No | Optional texture seed. |
| `texture_prompt` | object | No | Optional texture guidance using exactly one of text, image, or four ordered images; style_image may accompany text only. |
| `texture_quality` | string ("standard" | "detailed" | "extreme") | No | Texture detail level. |
| `texture_alignment` | string ("original_image" | "geometry") | No | Align texture to source imagery or model geometry. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Upload File

**Slug:** `TRIPO3D_UPLOAD_FILE`

Upload one image or model to Tripo3D and return a reusable file token for generation or processing tools. Supported direct-upload formats are JPEG/JPG/PNG images and GLB/GLTF/FBX/OBJ/STL models. This action supports local files up to 20 MiB; larger local files are unsupported. Provider operations may still accept supported public URLs where their input schema permits.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `file` | object | Yes | One of JPEG/JPG/PNG images and GLB/GLTF/FBX/OBJ/STL models, up to 20 MiB. Larger local files are unsupported by this action. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |