Image-to-3d
0 Quick Primer

Quick Primer on Image-to-3d

Image to 3d has two modes. hd and turbo

The HD mesh is much higher quality in terms of texture, geometry, overall detail/realism, but takes 1-2 hours to generate. The turbo mesh is a rough preview meant for fast ideating

These two modes are controlled by the key preview_mesh

Here is a quick primer on these two modes

Turbo mode

Turbo modes is a quick mode and can be used to create meshes quickly. The quality if turbo is lesser than hd mode though.

Turbo mode has 4 steps, create, spin generation, preview and refine step.

Create

To create a session, you upload the image_url along with the setting as mentioned in [Create Session]

The status returned upon succesful create is spin_generate_processing.


Spin Generation

Once an image is uploaded, 4 spins are generated. You can choose anyone of these 4 spins to generate a preview.

This step takes around a minute to complete.

The status during this step is spin_generate_processing

The status returned upon succesful spin generation is spin_generate_done

The status returned upon the failure in this stage is spin_generate_failed


Preview Generation

Once you have chosen a spin, a preview mesh is generated The preview mesh is generated from the spin you have chosen

This step takes around a minute to complete.

The status during this step is training_preview

The status returned upon succesful preview mesh generation is preview_done

The status returned upon the failure in this stage is preview_failed


Refine Generation

After the preview mesh is generated, you can send the mesh for refine.

This step takes a while.

The status during this step is training_refine

The status returned upon succesful preview mesh generation is refine_done

The status returned upon the failure in this stage is refine_failed

hd

Hd mode is the high quality mode, but dues to this, preview and refine takes more time than turbo mode.

Hd mode has three steps create, preview and refine.

Create

To create a session, you upload the image_url along with the setting as mentioned in [Create Session]

The status returned upon succesful create is uploaded. If you have auto_gen as true, then the preivew step is started automatically.


Preview Generation

HD preview is a slow process and takes aroud 15 minutes to complete.

The status during this step is training_preview

The status returned upon succesful preview mesh generation is preview_done

The status returned upon the failure in this stage is preview_failed


Refine Generation

After the preview mesh is generated, you can send the mesh for refine.

This step takes a while. Around an hour or so

The status during this step is training_refine

The status returned upon succesful preview mesh generation is refine_done

The status returned upon the failure in this stage is refine_failed