Tripo UV Unwrap

Tripo Smart UV API reference. Re-unwrap a 3D model's UVs into a clean layout and keep its textures, rigging and animation.

UV Unwrap

POST

/v1/3d-models/tripo/uv/

Re-unwrap a 3D model's UVs into a clean layout. By default the existing textures are baked onto the new layout, so the model looks the same; rigging and animation are kept. Upload a model file or provide a URL to a publicly accessible model. Costs 45 credits per request.

Request

# Upload a model file
curl -X POST https://api.3daistudio.com/v1/3d-models/tripo/uv/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=@character.glb"

# Or pass a URL, geometry and UVs only
curl -X POST https://api.3daistudio.com/v1/3d-models/tripo/uv/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model_url": "https://example.com/character.fbx",
    "bake": false
  }'

Response

{
  "task_id": "d4e5f6a7-b8c9-0123-def0-123456789abc",
  "created_at": "2026-11-05T12:00:00Z"
}

Parameters

Parameter	Type	Required	Default	Description
model	file	Conditional	—	3D model file upload (GLB, FBX, OBJ or STL). Required if model_url is not provided.
model_url	string	Conditional	—	URL to a publicly accessible GLB, FBX, OBJ or STL model. Required if model is not provided.
bake	boolean	No	true	Bake the existing textures onto the new UV layout. Set to false to return geometry with the new UVs only.
export_orientation	string	No	—	Facing of the exported model: "+x", "-x", "+y" or "-y".
compress	string	No	—	"geometry" applies meshopt compression for a smaller file.

Input Limits

Limit	Value
Formats	GLB, FBX, OBJ, STL. FBX input returns FBX; all other formats return GLB.
Triangles	Up to 80,000 (a quad counts as two). GLB, OBJ and STL uploads above the limit are rejected before you are charged; other inputs above it fail and are refunded automatically. Reduce the polygon count first, for example with face_limit on the Tripo convert endpoint.
File size	Up to 150 MB.

Checking Status

GET

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

Poll this endpoint with the task_id from the submit response. When status is "FINISHED", results contains the unwrapped model (3D_MODEL), followed by a preview image of the new UV layout (IMAGE) when one is available. 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/unwrapped.glb",
      "asset_type": "3D_MODEL",
      "metadata": null
    },
    {
      "asset": "https://storage.3daistudio.com/assets/uv_layout.webp",
      "asset_type": "IMAGE",
      "metadata": null
    }
  ]
}

Credit Costs

UV unwrapping costs a flat 45 credits per request. Credits are deducted when you submit a request. If the unwrap fails, credits are refunded automatically.

Operation	Credits
UV Unwrap	45

Processing Times

A UV unwrap typically takes 30–90 seconds from submit to result, depending on the model's size and the provider's current load.

Errors

Common errors for the UV unwrap endpoint.

Status	Error Code	Description
400	VALIDATION_FAILED	Missing or invalid parameters, an unsupported or unreadable model, or an uploaded model with more than 80,000 triangles. Nothing is charged.
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.