UV Unwrap | Overview
UV unwrapping API overview. Re-unwrap a 3D model's UVs into a clean layout while keeping its textures, rigging and animation.
Overview
The UV Unwrap API gives an existing 3D model a new, clean UV layout. Existing textures are baked onto the new layout, and rigging and animation are kept, so the model looks the same but is ready for texture painting, re-texturing or baking. Upload a model or pass a URL, receive a task ID, and poll for the result.
Available Providers
| Provider | Capabilities | Credits |
|---|---|---|
| Tripo | Smart UV unwrapping for GLB, FBX, OBJ and STL models up to 80,000 triangles. Keeps textures, rigging and animation. Also returns a preview image of the new UV layout. | 45 credits |
How It Works
Submit a model by URL or file upload, then poll the status endpoint for results.
Request
# 1. Submit a UV unwrap request
curl -X POST https://api.3daistudio.com/v1/3d-models/tripo/uv/ \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "model_url=https://example.com/model.glb"
# 2. Poll for results
curl https://api.3daistudio.com/v1/generation-request/TASK_ID/status/ \
-H "Authorization: Bearer YOUR_API_KEY"Errors
Common errors for UV unwrap endpoints.
| Status | Error Code | Description |
|---|---|---|
| 400 | VALIDATION_FAILED | Missing or invalid parameters, an unsupported format, or a model with too many triangles. |
| 402 | INSUFFICIENT_CREDITS | Not enough credits. Purchase more credits. |
| 429 | RATE_LIMITED | Rate limit exceeded. Wait and retry. |