Upload a 3D file through the Cloud Engine

The first step to consider when offering a online 3D printing service through your website is how to manage the 3D files that either you or your clients are uploading. If a file upload is not part of your 3D printing service scheme, you can always use pre-existing 3D files which are currently located in Sculpteo's shops.

On this page you'll find the following information concerning 3D file uploads:

The following diagram gives a detailed description of the available possibilities:

General information on 3D files housed on Sculpteo.com

3D File formats accepted on Sculpteo.com

Sculpteo's Cloud Engine is compatible with just about every 3D file format that exists. At the following link, you can find a list of all the file formats we accept , along with a brief description the functionality of each.

Automatic Repair of 3D Models

All of the 3D files uploaded to our site pass through our automatic 3D repair algorithms . The goal of this repairing process is to ensure that each file that is uploaded to Sculpteo's servers is able to be 3D printed, even given irregularities in geometries that might make it unprintable elsewhere.

Thanks to this online tool, most of 3D files uploaded to our servers are able to be 3D printed on our professional 3D printers with no problem at all.

At the following link you'll be able to find more information regarding the automatic repair of 3D files .

UUID: Our 3D design identifier

The UUID (Universal Unique IDentifier) of a 3D design uploaded to our site is a unique set of characters meant to make finding and changing a 3D file as easy as possible. Each files currently on our website also has a unique UUID, making for quick and easy file referencing.

If there is a particular model in a boutique on Sculpteo.com that interests you, just copy and paste the design's UUID and continue through the steps below.

How do you find the UUID of a 3D model? Head over to the product page of the 3D model you're interested in and take a look at the URL of the page. That object's UUID is the 8 letters and numbers situated between the name of the design and the question mark (?). Here's an example:
//www.sculpteo.com/en/print/coque-citrouille-iphone-5-159/ PpAK2tcc ?uuid=Ni49MqVeYrHIo1BxrYFU2e .

Get a 3D file from Sculpteo.com

The easiest way to propose an online 3D printing service to your customers is to start with the 3D models that are already on Sculpteo.com. Using those files means that neither you nor your end users will need to know how to make 3D models before ordering a 3D print. This solution is particularly advantageous in beginning stages, assuming the designs chosen for your site are pertinent to your customers.

All you need to do is to browse our pre-existing online shops , then choose the designs that interest you the most by copying their UUID as described in the previous section . With the UUID of the designs that interest you, you will be able to display the model when and where you would like as well as display a product window on the site of your choosing.

Uploading a 3D file from your website

This section is relevant to users that have 3D files pre-existing on their servers, or that have online 3D modelling tools of their own and would like to be able to 3D print them. You will need to upload the final 3D designs onto Sculpteo.com in order to display , purchase or even to simply see the price of your files.

Manually upload your 3D file onto Sculpteo.com

If you would like to propose a few 3D files which are not currently on the Sculpteo website, the simplest solution is to manually upload the files onto our site and to then gather the newly created UUIDs as described in the previous section . This is the fastest possible solution if there are just a few files to upload, if you're uploading a great deal of files, there are better suited options to do so.

Redirect users to Sculpteo.com using the Web2web API

A second possibility to allow access to our online 3D printing service is for your clients to automatically transfer your 3D files onto our site and to redirect your clients to the newly created product page. This is also possible all at once using the Web2web API .

Using this process, the final user will be able to visualize and purchase the object directly on our site. The following parameters are essential and are an addition to the regular set of parameters you'll find in the technical documentation:

Essential Parameters Description Possible Values
version Version number of the 3D file int
name Name of the 3D design string
urlfile1 URL of the 3D file string
provider Name of the 'provider' account ( contact us if you want to make one) string
hash The hash of all of the visible parameters and the 'secret' according to the SHA-1 algorithm (described in greater detail within the technical documentation) string

Consult the technical documentation on the Web2Web API for more information.

Keep in mind that it is also possible to obtain the same results using the Direct Upload API which is described in the following section.

Upload a 3D file in the background using the Direct Upload API

The final possibility for uploading a 3D file onto our servers actually keeps the entire process within your site (there is no redirect toward Sculpteo.com). This is made possible thanks to the Direct Upload API . Your 3D files are uploaded automatically in the background, allowing your website the possibility to offer a complete, "White Label" online printing service.

There are only two essential parameters in this case, but other parameters can be added to define more options in order to make the design more precise after it has been uploaded.

Essential Parameters Description Possible Values
file 3D file to upload multipart POST data
name Name of the 3D design string

Consult the technical documentation on the Direct Upload API for more information.


Technical Documentation

Are you an Experienced Developper?
Explore the technical documentation for our APIs