Tripo Segmentation

Tripo mesh segmentation API reference. Automatically segment 3D models into semantic parts using AI.

Mesh Segmentation

POST

/v1/3d-models/tripo/mesh-segmentation/

Segment a 3D model into semantic parts using AI. Upload a model file directly or provide a URL to a publicly accessible model. Costs 80 credits per request.

Request

curl -X POST https://api.3daistudio.com/v1/3d-models/tripo/mesh-segmentation/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model_url=https://example.com/character.glb"

Response

{
  "task_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
  "created_at": "2026-03-26T12:00:00Z"
}

Parameters

Parameter	Type	Required	Default	Description
model	file	Conditional	—	3D model file upload. Required if model_url is not provided.
model_url	string	Conditional	—	URL to a publicly accessible 3D model. Required if model is not provided.

Use Cases

Mesh segmentation is useful for a variety of downstream workflows.

Use Case	Description
Selective texturing	Apply different textures to individual parts (e.g. skin, clothing, accessories).
Rigging preparation	Identify body parts for skeletal rigging and animation setup.
Modular assets	Break a single model into reusable components for asset libraries.
Part-based editing	Edit or replace individual segments without modifying the entire model.

Checking Status

GET

/v1/generation-request/<task_id>/status/

Poll this endpoint with the task_id from the segmentation response. When status is "FINISHED", the results array contains the segmented model. Results expire after 24 hours.

Request

curl https://api.3daistudio.com/v1/generation-request/YOUR_TASK_ID/status/ \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "status": "FINISHED",
  "progress": 100,
  "failure_reason": null,
  "results": [
    {
      "asset": "https://storage.3daistudio.com/assets/segmented-model.glb",
      "asset_type": "3D_MODEL",
      "metadata": null
    }
  ]
}

Credit Costs

Mesh segmentation costs a flat 80 credits per request. Credits are deducted when you submit a request. If segmentation fails, credits are refunded automatically.

Operation	Credits
Mesh Segmentation	80

Errors

Common errors for the mesh segmentation endpoint.

Status	Error Code	Description
400	VALIDATION_FAILED	Missing or invalid parameters (no model provided).
401	INVALID_API_KEY	Invalid or missing API key.
402	INSUFFICIENT_CREDITS	Not enough credits. Purchase more credits.
429	RATE_LIMITED	Rate limit exceeded. Wait and retry.