3D Format Conversion
3D format conversion API reference. Convert between GLB, OBJ, FBX, STL, and PLY formats. Resize models and handle unit conversion in a single API request.
Convert Format
POST/v1/tools/convert/
Convert any 3D model between all major file formats. Upload a GLB, OBJ, STL, PLY, FBX, or even a ZIP archive containing a 3D file and receive it in your desired output format. You can also optionally rescale the model to fit within a specific bounding box size. Textures, materials, UVs, normals, and vertex colors are preserved wherever the target format supports them. Costs 10 credits per 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",
"max_size": 50.0,
"unit": "cm"
}'{
"task_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"created_at": "2026-02-25T12:00:00Z"
}Supported Formats
The following input and output formats are supported. ZIP archives are also accepted as input and will be searched for the first supported 3D file inside.
| Format | Input | Output | Notes |
|---|---|---|---|
| GLB / glTF | Yes | Yes | Binary glTF with embedded textures and materials. |
| OBJ | Yes | Yes | Wavefront OBJ. Output includes geometry only (no materials). |
| OBJ (ZIP) | Yes | Yes | OBJ + MTL + texture files bundled in a ZIP archive. |
| STL | Yes | Yes | Stereolithography format. Geometry only, no color or texture data. |
| PLY | Yes | Yes | Polygon format with vertex colors and normals. |
| FBX | Yes | Yes | Autodesk FBX with embedded textures. |
| FBX (ZIP) | No | Yes | FBX + external texture files bundled in a ZIP archive. |
| ZIP | Yes | No | ZIP archive containing any of the above formats. |
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| model_url | string (URL) | Yes | URL of the 3D model to convert. Supports GLB, glTF, OBJ, STL, PLY, FBX, and ZIP. |
| output_format | string | No | Target format: "glb", "obj", "obj_zip", "stl", "ply", "fbx", or "fbx_zip". Default: "glb". |
| max_size | number | No | Maximum bounding box dimension. The model will be scaled down to fit within this size if it exceeds it. Will not scale up. Minimum: 0.01. |
| unit | string | No | Unit for max_size: "cm" or "in". Default: "cm". |
Checking Status
GET/v1/generation-request/<task_id>/status/
Poll this endpoint with the task_id from the submit response. When status is "FINISHED", the results array contains the converted file. Results expire after 24 hours.
curl https://api.3daistudio.com/v1/generation-request/YOUR_TASK_ID/status/ \
-H "Authorization: Bearer YOUR_API_KEY"{
"status": "FINISHED",
"progress": 100,
"results": [
{
"asset_url": null,
"asset": "https://storage.3daistudio.com/assets/converted_model.fbx",
"asset_type": "3D_MODEL",
"thumbnail": null
}
]
}Processing Times
Conversion typically takes 25–40 seconds. Larger files or ZIP exports with bundled textures may take longer.
What Gets Preserved
During conversion, the tool preserves as much data as the target format allows. GLB and FBX retain textures, materials, UVs, normals, and vertex colors. OBJ (without ZIP) exports geometry only. STL exports geometry only with no color data. PLY preserves vertex colors and normals. If you need materials and textures with OBJ or FBX, use the ZIP variants (obj_zip, fbx_zip) which bundle the texture files alongside the model.