# 3DGen AI

**Note:** To generate 3d models with only prompt **(Text-to-3D)**, we suggest you to use [Fluw AI](https://luw-ai.gitbook.io/api/luw.ai-api-documentation/generators/fluw-ai) and get the image from this endpoint to use with 3DGen AI endpoint.&#x20;

```
POST /v2/generate
```

**Parameters**

<table><thead><tr><th width="160">Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>model</td><td>string</td><td><p><strong>Required</strong></p><p>Value must be <strong><code>3dgen</code></strong> for 3DGen AI. See other generators. Browse other <a href=""><strong>Generators</strong></a>.</p></td></tr><tr><td>image</td><td>string</td><td><p><em>Optional</em></p><p>URL of the input image to get 3d model of image file. Encode your image url if url have special characters. </p></td></tr><tr><td>extra_image_1</td><td>string</td><td><p><em>Optional</em></p><p>URL of the extra input image 1 to get 3d model. Side photos &#x26; angles</p></td></tr><tr><td>extra_image_2</td><td>string</td><td><p><em>Optional</em></p><p>URL of the extra input image 2 to get 3d model. Side photos &#x26; angles</p></td></tr><tr><td>extra_image_3</td><td>string</td><td><p><em>Optional</em></p><p>URL of the extra input image 3 to get 3d model. Side photos &#x26; angles</p></td></tr><tr><td>seed</td><td>integer</td><td><p><em>Optional</em></p><p>For reproducible results</p></td></tr><tr><td>luwmodel</td><td>string</td><td><p><em>Optional</em></p><p>If you want to use <strong>Luw 3 Symphony</strong> model, use <strong><code>symphony-3</code></strong> value. If you want to continue using <strong>Luw 2.5 Aria</strong> model don't add <strong><code>luwmodel</code></strong> parameter to your requests.</p></td></tr><tr><td>pid</td><td>integer</td><td><p><em>Optional</em></p><p>Persona ID to use if you want to use <a href="../personas/persona-slots">Persona Slots</a> for images.</p></td></tr><tr><td>processing_url</td><td>string</td><td><p><em>Optional</em></p><p>Get process results with same endpoint, alternative to <a href="../introduction/get-process-results"><strong><code>/results</code></strong></a> endpoint usage.</p></td></tr><tr><td>webhook</td><td>string</td><td><p><em>Optional</em></p><p>Get process results with real-time <a href="../introduction/webhooks">webhooks</a>, alternative to <a href="../introduction/get-process-results"><strong><code>/results</code></strong></a> endpoint usage.</p></td></tr></tbody></table>

### **If you want to use additional images to generate 3D model better, also add extra images:** [Visual training slots from 1 to 3](https://luw-ai.gitbook.io/api/luw.ai-api-documentation/personas/persona-slots) or use `extra_image_1` `extra_image_2` **and** `extra_image_3` **parameters**

**Curl Example**

```bash
curl -X POST https://api.luw.ai/v2/generate \
  -H "Authorization: Bearer LUW_API_TOKEN" \
  -d "model=3dgen" \
  -d "image=https://example.com/sofa.jpg"
```

**Response Example**

```json
{
  "status": true,
  "progress": {
    "started_at": "2024-01-04T12:00:00Z",
    "state": "processing",
    "percent": 45
  },
  "processing": true,
  "processing_url": "pred_123..."
}
```

## ✨ Get results using the [**`/results`**](https://luw-ai.gitbook.io/api/luw.ai-api-documentation/introduction/get-process-results) endpoint.

Alternative legacy method: Add **`&processing_url={url}`** to your request.
