> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tigo3d.art/llms.txt
> Use this file to discover all available pages before exploring further.

# Text to 3D

> Describe an object, get a clean textured mesh. Two steps: geometry, then texture.

## How it works

<Steps>
  <Step title="Geometry">
    A prompt of up to 800 characters produces untextured 3D geometry.
  </Step>

  <Step title="Inspect">
    Review the shape in the viewer. If it is wrong, adjust the prompt and run
    again before spending on a texture.
  </Step>

  <Step title="Texture">
    Run a texture pass on the geometry you approved.
  </Step>
</Steps>

## Options

<ParamField path="prompt" type="string" required>
  What to create. Up to 800 characters. Be concrete about material, style, and
  scale.
</ParamField>

<ParamField path="model" type="string">
  Model tier. Higher tiers trade speed for fidelity.
</ParamField>

<ParamField path="quality" type="string" default="standard">
  `standard` or `ultra`. Ultra adds geometric detail.
</ParamField>

<ParamField path="topology" type="string" default="triangle">
  `triangle` or `quad`.
</ParamField>

<ParamField path="targetPolycount" type="number">
  100 to 300,000. Leave unset for the default.
</ParamField>

<ParamField path="pose" type="string" default="original">
  `original`, `a-pose`, or `t-pose`. Use A-pose or T-pose for characters you
  intend to rig.
</ParamField>

<ParamField path="formats" type="string[]" default="[glb]">
  Any of `glb`, `fbx`, `obj`, `usdz`, `stl`.
</ParamField>

## Tips

* Name a material and a finish: "matte ceramic", "brushed aluminium",
  "weathered oak".
* Keep it to one object. Scenes with multiple objects reconstruct poorly.
* If you plan to rig, generate in A-pose or T-pose.