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

# ObjectCraft

> Generate stunning 3D models from text or images with advanced AI technology.

# ObjectCraft: AI-Powered 3D Model Generation Powered by Meshy

<Tip>
  Transform your ideas into stunning 3D models using cutting-edge AI technology with ObjectCraft, powered by Meshy API!
</Tip>

## Overview

ObjectCraft is a powerful AI-driven tool leveraging the **Meshy API** to generate 3D models. It offers multiple input methods: creating models from text descriptions (**Text to 3D**), converting single images into 3D (**Image to 3D**), and generating models from multiple images (**Multi Image to 3D**). ObjectCraft provides detailed controls and post-processing options like **Remesh** to refine your generated models.

<CardGroup cols={3}>
  <Card title="Text to 3D" icon="keyboard">
    Generate intricate 3D models from detailed text descriptions.
  </Card>

  <Card title="Image to 3D" icon="image">
    Transform single 2D images into fully-realized 3D models.
  </Card>

  <Card title="Multi Image to 3D" icon="images">
    Generate 3D models from multiple images of an object.
  </Card>
</CardGroup>

## Understanding 3D Model Generation Basics

For users new to 3D model generation, here are a few fundamental concepts:

* **Topology:** Refers to the arrangement of vertices, edges, and faces that make up a 3D model's surface. Common types are **Triangle** (simpler, often used in real-time graphics) and **Quad** (preferred for animation and smooth surfaces).
* **Polycount:** The total number of polygons (usually triangles or quads) in a model. A **High Target Polycount** results in more detail but larger file sizes, while a **Low Target Polycount** simplifies the model.
* **Texturing:** Applying images to the surface of a 3D model to give it color, detail, and material properties. **Textured Mesh** means the generated model will come with these surface images.

## How to Use ObjectCraft

ObjectCraft offers three primary modes, selectable via the dropdown menu at the top.

<Frame>
  <img src="https://pixiomedia.nyc3.digitaloceanspaces.com/docs/dropdownmenu.png" alt="ObjectCraft Mode Selection Dropdown" />
</Frame>

<Steps>
  <Step title="Choose Mode" icon="list-ul">
    Select the generation mode from the dropdown menu: **Text to 3D**, **Image to 3D**, or **Multi Image to 3D**.
  </Step>

  <Step title="Provide Input" icon="square-pen">
    * For **Text to 3D**: Enter a text prompt describing your desired 3D model.
    * For **Image to 3D**: Upload a single image file.
    * For **Multi Image to 3D**: Upload multiple image files (up to 4).
  </Step>

  <Step title="Adjust Settings" icon="sliders">
    Configure the available parameters based on your selected mode (see Input Parameters section below).
  </Step>

  <Step title="Generate 3D Model" icon="play">
    Click the **Generate** button. The AI will process your input and settings to create your 3D model.
  </Step>
</Steps>

### Text to 3D Mode

Generate a 3D model from a text description.

<Frame>
  <img src="https://pixiomedia.nyc3.digitaloceanspaces.com/docs/textto3d.png" alt="ObjectCraft Text to 3D Screenshot" />
</Frame>

<Steps>
  <Step title="Select Text to 3D" icon="keyboard">
    Choose **Text to 3D** from the mode dropdown.
  </Step>

  <Step title="Enter Prompts" icon="pencil">
    Enter a **Prompt** describing the model. You can also add a **Negative Prompt** to exclude elements.
  </Step>

  <Step title="Adjust Settings" icon="sliders">
    Configure **Art Style**, **Seed (optional)**, **Symmetry Mode**, **Topology**, and **Target Polycount**.
  </Step>

  <Step title="Generate" icon="play">
    Click **Generate**.
  </Step>
</Steps>

### Image to 3D Mode

Generate a 3D model from a single image.

<Frame>
  <img src="https://pixiomedia.nyc3.digitaloceanspaces.com/docs/imgto3d.png" alt="ObjectCraft Image to 3D Screenshot" />
</Frame>

<Steps>
  <Step title="Select Image to 3D" icon="image">
    Choose **Image to 3D** from the mode dropdown.
  </Step>

  <Step title="Upload Image" icon="upload">
    Upload your image file (JPG or PNG).
  </Step>

  <Step title="Adjust Settings" icon="sliders">
    Configure **Texture**, **Texture Prompt (optional)**, **Symmetry Mode**, **Topology**, and **Target Polycount**.
  </Step>

  <Step title="Generate" icon="play">
    Click **Generate**.
  </Step>
</Steps>

### Multi Image to 3D Mode

Generate a 3D model from multiple images (up to 4).

<Frame>
  <img src="https://pixiomedia.nyc3.digitaloceanspaces.com/docs/multiimageto3d.png" alt="ObjectCraft Multi Image to 3D Screenshot" />
</Frame>

<Steps>
  <Step title="Select Multi Image to 3D" icon="images">
    Choose **Multi Image to 3D** from the mode dropdown.
  </Step>

  <Step title="Upload Images" icon="upload">
    Upload 2 to 4 image files (JPG or PNG) of the object from different angles.
  </Step>

  <Step title="Adjust Settings" icon="sliders">
    Configure **Texture**, **Texture Prompt (optional)**, **Symmetry Mode**, **Topology**, and **Target Polycount**.
  </Step>

  <Step title="Generate" icon="play">
    Click **Generate**.
  </Step>
</Steps>

## Input Parameters and Options

The available parameters in ObjectCraft depend on the selected **Select Type**:

<ResponseField name="Prompt" type="string" required>
  (Text to 3D) Text description of the desired 3D model.
</ResponseField>

<ResponseField name="Art Style" type="Enum">
  (Text to 3D) Choose the artistic style: `realistic`, `sculpture`.
</ResponseField>

<ResponseField name="Negative Prompt" type="string">
  (Text to 3D) Text description for elements to avoid.
</ResponseField>

<ResponseField name="Seed (optional)" type="string">
  (Text to 3D) Enter a seed for reproducible results.
</ResponseField>

<ResponseField name="Upload Image(s)" type="file / array of files" required>
  (Image to 3D & Multi Image to 3D) Upload 1 image (Image to 3D) or up to 4 images (Multi Image to 3D). JPG or PNG.
</ResponseField>

<ResponseField name="Texture" type="boolean">
  (Image to 3D & Multi Image to 3D) Toggle to generate the model with textures.
</ResponseField>

<ResponseField name="Texture Prompt" type="string">
  (Image to 3D & Multi Image to 3D) (Optional) Describe the desired texture.
</ResponseField>

<ResponseField name="Symmetry Mode" type="Enum">
  (All Modes) Control symmetry: `off`, `auto`, `on`.
</ResponseField>

<ResponseField name="Topology" type="Enum">
  (All Modes) Choose mesh topology: `triangle`, `quad`.
</ResponseField>

<ResponseField name="Target Polycount" type="integer">
  (All Modes) Desired complexity of the model. Range: 10000-300000.
</ResponseField>

## Mastering ObjectCraft Prompts (Text to 3D)

Crafting effective prompts is crucial for achieving the best results with ObjectCraft's Text to 3D mode.

### The Importance of Prompting

Your **Prompt** tells the AI what to create, while the **Negative Prompt** tells it what to avoid. Using both effectively helps guide the AI towards your desired outcome and away from unwanted results (e.g., "blurry, poor quality").

### Key Prompt Elements & Settings

<AccordionGroup>
  <Accordion title="Prompt" icon="pencil">
    Clearly describe the object, style, and details.
  </Accordion>

  <Accordion title="Negative Prompt" icon="ban">
    Specify elements or qualities to exclude (e.g., "low poly", "untextured").
  </Accordion>

  <Accordion title="Art Style" icon="palette">
    Choose between **Realistic** (for lifelike models) and **Sculpture** (for a more stylized, artistic look).
  </Accordion>

  <Accordion title="Seed" icon="barcode">
    Use a specific seed for model consistency across generations.
  </Accordion>

  <Accordion title="Symmetry Mode" icon="arrow-up">
    Control symmetry: **Off** (no symmetry), **On** (enforce symmetry), **Auto** (AI decides).
  </Accordion>

  <Accordion title="Topology" icon="triangle">
    Choose between **Triangle** (simpler mesh) and **Quad** (more complex, often better for animation).
  </Accordion>

  <Accordion title="Target Polycount" icon="grid">
    Set the desired detail level. **Low Target Polycount** creates simpler models, while **High Target Polycount** creates more detailed ones.
  </Accordion>
</AccordionGroup>

## Generated Models / History

ObjectCraft keeps a history of your generated 3D models.

<Frame>
  <img src="https://pixiomedia.nyc3.digitaloceanspaces.com/docs/showhistory.png" alt="ObjectCraft Show History Screenshot" />
</Frame>

<AccordionGroup>
  <Accordion title="Show History" icon="clock">
    Click the **Show History** button to open the history sidebar on the left.
  </Accordion>

  <Accordion title="Generated Models List" icon="list">
    See a list of your previously generated models with thumbnails.
  </Accordion>

  <Accordion title="View Model" icon="eye">
    Select a model from the history to view it in the 3D viewer.
  </Accordion>

  <Accordion title="Download Model" icon="download">
    Download individual models in various formats or all formats as a ZIP.

    <Frame>
      <img src="https://pixiomedia.nyc3.digitaloceanspaces.com/docs/download-extensions.png" alt="ObjectCraft Download Options Screenshot" />
    </Frame>
  </Accordion>

  <Accordion title="Remesh Model" icon="wrench">
    Remesh a generated model to change its format, topology, polycount, origin, or height.
  </Accordion>

  <Accordion title="Send to Gallery" icon="share">
    Share your generated model to a community gallery.
  </Accordion>

  <Accordion title="Clear All Models" icon="trash">
    Clear all generated models from your history.
  </Accordion>
</AccordionGroup>

## Remesh Model

The Remesh feature allows you to modify the properties of a generated 3D model, such as its format, topology, polycount, origin, and height.

<Frame>
  <img src="https://pixiomedia.nyc3.digitaloceanspaces.com/docs/remesh-modal.png" alt="ObjectCraft Remesh Modal Screenshot" />
</Frame>

<Steps>
  <Step title="Select Remesh" icon="wrench">
    From the history sidebar, click the **Remesh** option under a generated model. This will open the Remesh Model modal.

    <Frame>
      <img src="https://pixiomedia.nyc3.digitaloceanspaces.com/docs/remesh-model-selection.png" alt="ObjectCraft Remesh Option in History Screenshot" />
    </Frame>
  </Step>

  <Step title="Adjust Settings" icon="sliders">
    Configure the remeshing parameters in the modal:

    * **Target Format**: Choose the output file format (GLB, FBX, OBJ, USDZ, BLEND, STL).

    <Frame>
      <img src="https://pixiomedia.nyc3.digitaloceanspaces.com/docs/remesh-target-format.png" alt="ObjectCraft Remesh Target Format Screenshot" />
    </Frame>

    * **Topology**: Select the mesh structure (Triangle or Quad).

    <Frame>
      <img src="https://pixiomedia.nyc3.digitaloceanspaces.com/docs/remesh-topology.png" alt="ObjectCraft Remesh Topology Screenshot" />
    </Frame>

    * **Target Polycount**: Set the desired complexity using the slider.
    * **Origin**: Choose the model's origin point (Bottom or Center).

    <Frame>
      <img src="https://pixiomedia.nyc3.digitaloceanspaces.com/docs/remesh-origin.png" alt="ObjectCraft Remesh Origin Screenshot" />
    </Frame>

    * **Resize Height**: Enter a value to resize the model's height in meters (0 for no resize).
  </Step>

  <Step title="Remesh" icon="play">
    Click the **Remesh** button in the modal. The AI will process the model with the new settings.
  </Step>
</Steps>

### Remesh Parameters:

<ResponseField name="Target Format" type="Enum" required>
  The desired output file format for the remeshed model: `GLB`, `FBX`, `OBJ`, `USDZ`, `BLEND`, `STL`.
</ResponseField>

<ResponseField name="Topology" type="Enum" required>
  The desired mesh structure: `Triangle` or `Quad`.
</ResponseField>

<ResponseField name="Target Polycount" type="integer" required>
  The desired complexity of the remeshed model. Range: 100-300000.
</ResponseField>

<ResponseField name="Origin" type="Enum" required>
  The desired origin point: `Bottom` or `Center`.
</ResponseField>

<ResponseField name="Resize Height (meters, 0 for no resize)" type="number" required>
  Set a specific height in meters (0 to keep original height).
</ResponseField>

## Tips for Best Results

<CardGroup cols={2}>
  <Card title="Clear Inputs" icon="pencil">
    Provide clear and specific text descriptions or high-quality images for better results. For Multi Image to 3D, ensure images cover different angles well.
  </Card>

  <Card title="Experiment with Modes" icon="shuffle">
    Try all three modes (Text, Image, Multi Image) to see which works best for your concept.
  </Card>

  <Card title="Adjust Parameters" icon="sliders">
    Experiment with settings like Topology, Target Polycount, and Symmetry Mode to refine the mesh.
  </Card>

  <Card title="Use Remesh" icon="wrench">
    Utilize the Remesh feature to optimize models for specific use cases or software.
  </Card>
</CardGroup>

## Troubleshooting

If you encounter issues with ObjectCraft, consider these solutions:

<AccordionGroup>
  <Accordion title="Poor Model Quality" icon="box">
    Refine your text prompts or use higher-quality input images. Adjust generation settings like Target Polycount.
  </Accordion>

  <Accordion title="Generation Errors" icon="bug">
    Check your inputs for any unusual characters or overly complex descriptions. Ensure image files are valid and within limits.
  </Accordion>

  <Accordion title="Remesh Issues" icon="wrench">
    Ensure the original model was generated successfully. Check the parameters in the Remesh modal for valid inputs.
  </Accordion>
</AccordionGroup>

## Conclusion

ObjectCraft provides a powerful and intuitive way to generate 3D models using AI, whether starting from text or images. With its flexible input types, detailed settings, and post-processing tools like Remesh, it empowers you to create and refine 3D assets for various applications.
