3D Format Conversion

3D format conversion API reference. Convert between GLB, OBJ, FBX, STL, PLY, USDZ, and 3MF 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, USDZ, or even a ZIP archive containing a 3D file and receive it in your desired output format — including USDZ for Apple AR and 3MF for 3D printing. 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.

Request

# Using a model URL
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"
  }'

# Using a file upload
curl -X POST https://api.3daistudio.com/v1/tools/convert/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F model_file=@model.glb \
  -F output_format=fbx \
  -F max_size=50.0 \
  -F unit=cm

Response

{
  "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.
USDZ	Yes	Yes	Apple's AR format. Textures and materials embedded. Used for AR Quick Look on iOS/Safari.
3MF	No	Yes	3D Manufacturing Format for 3D printing. Geometry with vertex colors.
ZIP	Yes	No	ZIP archive containing any of the above formats.

Parameters

Parameter	Type	Required	Description
model_url	string (URL)	Conditional	URL of the 3D model to convert. Supports GLB, glTF, OBJ, STL, PLY, FBX, and ZIP. Required if model_file is not provided.
model_file	file	Conditional	Direct file upload of the 3D model. Supports the same formats as model_url. Required if model_url is not provided.
output_format	string	No	Target format: "glb", "obj", "obj_zip", "stl", "ply", "fbx", "fbx_zip", "usdz", or "3mf". 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.

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/converted_model.fbx",
      "asset_type": "3D_MODEL",
      "metadata": 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, FBX, and USDZ 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. 3MF exports geometry for 3D printing. 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.