Tools | Overview
3D and image processing tools API overview. Convert formats, render previews, repair meshes, optimize for web, bake textures, enhance images, and remove backgrounds.
Overview
The Tools API provides a set of 3D and image processing utilities. All tool operations are asynchronous. Submit a request with your input and parameters, receive a task ID, and poll the status endpoint for the processed result.
Available Tools
| Tool | Endpoint | Description | Credits |
|---|---|---|---|
| Format Conversion | /v1/tools/convert/ | Convert between 3D formats (GLB, OBJ, STL, PLY, FBX). | 10 |
| 3D Render | /v1/tools/render/ | Render 3D models to images or videos from any angle. | 5 to 20 |
| Mesh Repair | /v1/tools/repair/ | Fix mesh issues, prepare for 3D printing, hollow models. | 60 to 90 |
| Optimize | /v1/tools/optimize/ | Compress and optimize GLB models with Draco, texture compression, and simplification. | 10 |
| Bake Texture | /v1/tools/bake-texture/ | Transfer textures from a high-poly model to a retopologized mesh. | 5 |
| BetaVolume Calculator | /v1/tools/calculate-volume/ | Calculate volume, surface area, and material estimates for a 3D model at a given height. | 20 |
| Image Enhance & Restore | /v1/tools/image-enhance/ | Upscale and enhance images. Remove noise, artifacts, and damage from old photos. Optionally remove background. | 15 to 20 |
| Remove Background | /v1/tools/remove-bg/ | Remove image backgrounds with transparent PNG output. Three quality levels for general use and fine-edge subjects. | 3 to 5 |
Common Pattern
All tools follow the same request pattern. POST your model URL and parameters, then poll the status endpoint.
Request
# 1. Submit a tool request
curl -X POST https://api.3daistudio.com/v1/tools/convert/ \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model_url": "https://example.com/model.glb", "output_format": "fbx"}'
# 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 tool endpoints.
| Status | Error Code | Description |
|---|---|---|
| 402 | insufficient_credits | Not enough credits. |
| 429 | rate_limited | Rate limit exceeded. |
| 400 | validation_failed | Missing or invalid parameters. |