---

Importing

This request will POST binary file data using the Content-Type multipart/form-data according to RFC1867.

Definition

Synchronous and Asynchronous

POST https://clara.io/api/scenes/{uuid}/import?async={0|1}

URL Parameters

• uuid: the scene ID.
• async: 0 or 1. whether to use the robust, but complex, asynchronous mode.

If you send an Accept: text/event-stream header, the output is an event stream of the job and its progress.

Supported formats:

3D Models and Scenes:

• Autodesk FBX (.fbx) Recommended for best results!
• Wavefront Object (.obj/.mlt) Recommended for best results!
• Collada (.dae) Recommended for best results!
• [STereoLithography (.stl)](https://en.wikipedia.org/wiki/STL_(file_format%29)
• ThreeJS (.json)
• Blender (.blend)
• 3D Studio (.3ds)
• STEP CAD (.stp/.step)
• IGES CAD (.igs/.iges)
• [Stanford Poly (.ply)](https://en.wikipedia.org/wiki/PLY_(file_format%29)

Images:

• Radiance HDR (.hdr)
• OpenEXR (.exr)
• JPEG (.jpg)
• Portable Network Graphics (.png)
• TIFF (.tif/.tiff)
• Targa (.tga)
• GIF (.gif)
• Microsoft BMP (.bmp)

Available Import Options:

• inGroup: {true | false}
• importInto”: string
• fbxAnimations”: {true | false}
• fbxThinningTolerance: number
• fbxThinningType: {“None” | “Density” | “Simplification”}
• fbxThinningFPS: number
• fbxUnit”: {“Null” | “Meter” | “Centimeter”}
• objSplitStyle”: number
• objNormalTypes”: number
• objSmoothAngle”: number
• stlRemoveDuplicates”: {true | false}
• stlDuplicatePrecision”: number
• vrMatAsPhysical”: {true | false}
• cadReductLvl”: number
• cadClientView”: number
• cadClientLvl”: number
• cadServerView”: number
• cadServerLvl”: number
• cadChord”: number
• cadAngle”: number
• emAngle”: number
• emAutoSize”: number
• vrsMtlToStandard”: {true | false}
• vrsViewOption”: number
• cameraFrameAll: {true | false}
• countPoly: {true | false}

Synchronous Example Request

This example demonstrates how to do a synchronous (blocking) import.

In BASH

curl "https://clara.io/api/scenes/de8891ef-6ee5-4a2c-8884-507e3648ea93/import" \
    -u username:c3be3060-fe81-467b-aa62-0ee42eea9c8b \
    -X POST \
    -F "file0=@butcherboy/butcherboy.obj" \
    -F "file1=@butcherboy/butcherboy.mtl" \
    -F "file2=@butcherboy/ButcherBoyDiffMap.jpg" \
    -F async=0

ASynchronous Example Request

See the Asynchronous Operations documentation for asynchronous examples in several languages.

Clara Node SDK

When using the Clara Node SDK:

$ clara scenes:import [options]

---