Skip to main content
Tripo3D logo
  • Category: media generation
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 23
  • Triggers: 0
  • Slug: TRIPO3D
  • Version: 20261026_00

Tools

Slug: TRIPO3D_CHECK_MODEL_RIGGABILITYSubmit 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

string
required
Source GLB bare task UUID, Tripo file token, or public URL; the model may be at most 150 MB.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TRIPO3D_COMPLETE_MESHSubmit 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

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

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TRIPO3D_CONVERT_MODELSubmit 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

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

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TRIPO3D_CREATE_PRESIGNED_UPLOADReserve 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

string ("jpeg" | "jpg" | "png" | "webp" | "bmp" | "tiff" | "glb" | "gltf" | "fbx" | "obj" | "stl" | "3mf" | "usdz")
required
Lowercase file extension without a leading dot.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TRIPO3D_DECIMATE_MESHSubmit 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

boolean
Bake textures onto the low-poly model. Supported only by v2.0; omit this field when using v1.0.
boolean
Produce quad rather than triangle topology.
string
required
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.
string ("v2.0" | "v1.0")
Retopology algorithm: v2.0 performs 30-credit smart retopology; v1.0 performs 10-credit basic decimation. v1.0 is live-tested.
integer
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.
array
Names of segmented parts to retopologize. Supported only by v2.0; omit this field when using v1.0.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TRIPO3D_EDIT_IMAGESubmit 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

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

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TRIPO3D_EDIT_MULTIVIEWSubmit 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

string
required
Prior multiview bare task UUID, Tripo file token, or public multiview URL.
array
required
One or more view-specific edit instructions.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TRIPO3D_GENERATE_IMAGE_FROM_TEXTSubmit 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

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

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TRIPO3D_GENERATE_MODEL_FROM_IMAGESubmit 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

boolean
Generate PBR materials.
boolean
Generate quad topology; support depends on the selected model family.
string
required
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.
string ("v3.1-20260211" | "v3.0-20250812" | "v2.5-20250123" | "P1-20260311" | "P2-20260801")
required
Tripo H- or P-series model version. v3.1-20260211 is the live-tested H-series value.
boolean
Generate textures. Set false with pbr=false for the live-tested lower-cost untextured path.
string
Optional geometry compression mode.
boolean
Automatically normalize model scale for H3 and P-series models.
boolean
Include UV coordinates in the exported model.
integer
Requested polygon face limit; valid ranges depend on the selected model.
integer
Optional geometry-generation seed.
string ("default" | "align_image")
Use the default model orientation or align it to the source image.
integer
Optional texture-generation seed.
boolean
Generate separate parts on H3 models; requires texture=false and pbr=false and cannot be combined with quad or smart_low_poly.
boolean
Use H3-series smart low-poly generation.
string ("standard" | "detailed" | "extreme")
Texture detail level for H3 and P-series models.
string ("standard" | "detailed")
Geometry detail level; available on H-series v3.0 and later.
string ("original_image" | "geometry")
Align texture to the source image or to the generated geometry.
string ("+x" | "-x" | "-y" | "+y")
Final export orientation; leave unset before post-processing.
boolean
Automatically repair unsuitable source-image characteristics before generation.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TRIPO3D_GENERATE_MODEL_FROM_MULTIVIEWSubmit 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

boolean
Generate PBR materials.
boolean
Generate quad topology on H3 or P2 models.
string ("v3.1-20260211" | "v3.0-20250812" | "v2.5-20250123" | "P1-20260311" | "P2-20260801")
required
Tripo H- or P-series model version; v3.1-20260211 is live-tested.
array
required
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.
boolean
Generate textures.
string
Optional geometry compression mode.
boolean
Automatically normalize scale for H3 and P-series models.
boolean
Include UV coordinates.
integer
Requested face limit; supported ranges depend on the model.
integer
Optional geometry seed.
string ("default" | "align_image")
Use default model orientation or align it to the source views.
integer
Optional texture seed.
boolean
Generate separate model parts on H3 models.
boolean
Use H3-series smart low-poly generation.
string ("standard" | "detailed" | "extreme")
Texture detail level for H3 and P-series models.
string ("standard" | "detailed")
Geometry detail level for H3 models.
string ("original_image" | "geometry")
Align textures to source imagery or generated geometry.
string ("+x" | "-x" | "-y" | "+y")
Final export orientation; leave unset before post-processing.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TRIPO3D_GENERATE_MODEL_FROM_TEXTSubmit 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

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

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TRIPO3D_GENERATE_MULTIVIEW_FROM_IMAGESubmit 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

string
required
Public PNG, JPEG, or WebP URL or Tripo image file token. Task UUID input is not documented for this endpoint.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TRIPO3D_GENERATE_SPLAT_FROM_IMAGESubmit 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

string
required
Public PNG, JPEG, or WebP URL or Tripo file token for an image up to 20 MB.
integer
Optional deterministic generation seed. The value 7 is live-tested.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TRIPO3D_GET_BALANCEGet the authenticated account’s available and frozen Tripo credit balances.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TRIPO3D_GET_TASKGet 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

string
required
Bare Tripo V3 task UUID returned by a submission tool; do not prepend task_.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TRIPO3D_GET_TASKSGet 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

array
required
One to 100 distinct bare Tripo V3 task UUIDs; do not prepend task_.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TRIPO3D_IMPORT_MODELSubmit 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

string
required
Tripo file token or public GLB, GLTF, FBX, OBJ, or STL URL; model files may be at most 150 MB.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TRIPO3D_LIST_USAGEReturn 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

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

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TRIPO3D_RETARGET_ANIMATIONSubmit 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

string
required
Bare UUID of a successful Tripo3D rigging task.
string
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.
array
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.
string ("glb" | "fbx")
Animated model output format.
boolean
Bake animation into the model. This option is valid only for GLB output.
boolean
Remove root translation so the animation remains in place.
boolean
Include model geometry with the animation export.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TRIPO3D_RIG_MODELSubmit 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

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

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TRIPO3D_SEGMENT_MESHSubmit 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

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

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TRIPO3D_TEXTURE_MODELSubmit 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

boolean
Generate PBR materials; pbr=false is the live-tested standard-texture path.
boolean
Bake generated textures into the output model.
string
required
Source model bare task UUID, Tripo file token, or public model URL.
string ("v3.0-20250812" | "v2.5-20250123")
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.
string
Optional geometry compression mode.
array
Optional names of model parts to texture.
integer
Optional texture seed.
object
Optional texture guidance using exactly one of text, image, or four ordered images; style_image may accompany text only.
string ("standard" | "detailed" | "extreme")
Texture detail level.
string ("original_image" | "geometry")
Align texture to source imagery or model geometry.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TRIPO3D_UPLOAD_FILEUpload 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

object
required
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not