v1.0.0

tripo3d 1.0.0 — Tripo API v3

The Tripo v2 API (api.tripo3d.ai/v2/openapi) is shut down on 2026-10-31; 0.x stops working then.
1.0.0 sends every call to API v3 (https://openapi.tripo3d.ai, China https://openapi.tripo3d.com).

Upgrade: pip install -U "tripo3d>=1.0.0,<2.0.0". Method names, parameters and return types of 0.x
are unchanged, so existing code (including ComfyUI-Tripo 1.3.x) keeps working. ComfyUI-Tripo 2.0.0
requires this release.

Highlights

• All task, task-query, upload and balance calls use API v3.
• New: mesh_uv (Smart UV), image_to_depth, image_to_splat, list_tasks / get_tasks, get_usage,
  presign_upload, download_file, and v3-style methods (rig, retarget, mesh_segment, …).
• Uploads use /v3/files (presigned PUT above 50 MB); boto3 is no longer needed.
• Retired values are translated as the API requires: rig v2.0-20250506 → v2.5-20260210;
  decimate P-v*-* → v1.0 / v2.0 / v3.0.
• Downloads and presigned uploads never send the API key; GET requests retry on 429/5xx; task
  creation is never retried; no leaked HTTP sessions when a client is not closed.

No longer supported

• refine_model and stylize_model: Tripo has retired refine and stylize. Both methods now raise
  immediately without sending a request.

Notes

• Rig / retarget compatibility measured on the API is documented in docs/API.md
  (e.g. unity / unreal / vrm need rig v2.5 or v3.0).

Full details: CHANGELOG.md ·
API reference

v0.4.2

What's Changed

• feat: support Mesh Segmentation v2.0 with hybrid apiv3 routing

Full Changelog: v0.4.1...v0.4.2

v0.4.1

What's Changed

• fix: TaskOutput.image reads generated_image from API response by @MeterLong in #15

Full Changelog: v0.4.0...v0.4.1

v0.4.0

What's Changed

• feat: v0.4.0 — region support, 8 new methods, parameter drift fixes by @MeterLong in #14

New Contributors

• @MeterLong made their first contribution in #14

Full Changelog: v0.3.12...v0.4.0

v0.3.12

Full Changelog: v0.3.11...v0.3.12

v0.3.11

What's Changed

• Fix: Add missing passed_args to mesh_segmentation method by @haadirakhangi in #8
• fix texture_model crash and harden client reliability by @tipb47 in #10

New Contributors

• @haadirakhangi made their first contribution in #8
• @tipb47 made their first contribution in #10

Full Changelog: v0.3.10...v0.3.11

v0.3.10

Full Changelog: v0.3.9...v0.3.10

fix endpoint

v0.3.9

fix endpoint

v0.3.8

add endpoint for boto3

v0.3.7

Full Changelog: v0.3.6...v0.3.7