# Quick Start

Get up and running with the MeshifAI JavaScript SDK in minutes.\
\
You can generate both `Textured` and `Untextured` models. Textured models can often put a lot of strain on the server and may not be as reliable as untextured models but provide a much higher quality result.

### <kbd>Basic Setup</kbd>

```javascript
import meshifai from '@0xretrodev/meshifai';

// Generate an untextured model (faster and more reliable)
const result = await meshifai.textTo3d('A cute cat');
console.log(`Download URL: ${result.modelUrl}`);

// Generate a textured model with PBR materials
const texturedResult = await meshifai.textTo3d('A red apple', { 
  textured: true 
});
console.log(`Download URL: ${texturedResult.modelUrl}`);


```

{% hint style="warning" %}
Please note that `Textured Models` can take longer to generate and are highly experimental.
{% endhint %}

### <kbd>Additional Options</kbd>

The `textTo3d` function accepts an optional second parameter with options for `untextured` models:

```javascript
// The highRes parameter controls the quality of the model generation
// false = standard quality (faster), true = high resolution (better quality, slower)
const url = await meshifai.textTo3d('A luxury sports car', {
  highRes: true
});
```

\
The `textTo3d` function also accepts an optional second parameter with options for `textured` models:

```javascript
// Generate a high-quality textured model by increasing polygon count
const highQualityResult = await meshifai.textTo3d('A red apple', { 
  textured: true,
  polygons: 50000  // Default is 25000, higher = better quality
});
console.log(`Download URL: ${highQualityResult.modelUrl}`);
```

### <kbd>Model Format</kbd>

The generated 3D models are in `.glb` format (GL Transmission Format Binary), which is widely supported by:<br>

* 3D modeling software like Blender
* Game engines like Unity and Unreal
* Web-based 3D viewers
* AR/VR applications

More formats coming soon!


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.meshifai.com/javascript/getting-started/quick-start.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.