Skip to content

v1.0.0

Latest

Choose a tag to compare

@PeakLee PeakLee released this 14 Oct 21:25
aa94035

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