---
title: Tripo 3D v3.1 | Runware Docs
url: https://runware.ai/docs/models/tripo-v3-1
description: High-fidelity 3D asset generation with enhanced geometry and texture precision
---
# Tripo 3D v3.1

![Tripo 3D v3.1](https://assets.runware.ai/covers/tripo-v3-1.jpg)

Tripo 3D v3.1 is a high-fidelity 3D generation model that creates production-ready 3D assets from text prompts or images. It delivers enhanced detail, stronger geometry precision, and improved texture quality compared to earlier versions, with support for PBR materials and export in GLB, FBX, OBJ, and STL formats.

- **Status**: live
- **ID**: `tripo:v3.1@0`
- Try in Playground
- **Creator**: Tripo AI
- **Release Date**: February 11, 2026
- **Capabilities**: Text to 3D, Image to 3D, Checkpoint

## Pricing

$0.30 from, per run · ~2m 4s per request

**Rates** (per run)

- Text-to-3D: `$0.30`
- Image-to-3D: `$0.40`

**5 example generations**

- [segmented-3d](https://runware.ai/docs/models/tripo-v3-1/examples#example-near-future-apiary-smoker-prop): `$0.30` (~1m 51s)
- [geometry-only-3d](https://runware.ai/docs/models/tripo-v3-1/examples#example-polar-research-ice-core-auger): `$0.30` (~1m 46s)
- [reference-to-3d](https://runware.ai/docs/models/tripo-v3-1/examples#example-metro-signal-relay-room): `$0.30` (~3m 58s)
- [quad-mesh](https://runware.ai/docs/models/tripo-v3-1/examples#example-sculptural-watering-can-product-model): `$0.35` (~2m 4s)
- [text-to-3d](https://runware.ai/docs/models/tripo-v3-1/examples#example-wildfire-ranger-pangolin-character): `$0.50` (~3m 34s)

times vary, measured end to end · [How pricing works](https://runware.ai/docs/models-api/pricing)

## Compatibility & Validation

Provide exactly one of: `positivePrompt`, `inputs.images`.

---

`negativePrompt` cannot be used with `inputs.images`.

---

When `settings.generateParts` is `true`, `settings.texture`, `settings.pbr`, and `settings.quad` cannot be `true`.

---

When `settings.imageAutoFix` is provided, `inputs.images` is required.

---

When `settings.orientation` is `align_image`, `inputs.images` is required.

---

When `settings.pbr` is `true`, `settings.texture` must be `true`.

---

When `settings.quad` is `true`, `outputFormat` must be `FBX`.

## Request Parameters

**API Options**

Platform-level options for task execution and delivery.

### [taskType](https://runware.ai/docs/models/tripo-v3-1#request-tasktype)

- **Type**: `string`
- **Required**: true
- **Value**: `3dInference`

Identifier for the type of task being performed.

### [taskUUID](https://runware.ai/docs/models/tripo-v3-1#request-taskuuid)

- **Type**: `string`
- **Required**: true
- **Format**: `UUID v4`

UUID v4 identifier for tracking tasks and matching async responses. Must be unique per task.

### [outputType](https://runware.ai/docs/models/tripo-v3-1#request-outputtype)

- **Type**: `string`
- **Default**: `URL`

3D output type.

**Allowed values**: `URL`

### [outputFormat](https://runware.ai/docs/models/tripo-v3-1#request-outputformat)

- **Type**: `string`
- **Default**: `GLB`

Specifies the file format of the generated output. The available values depend on the task type and the specific model's capabilities.

- \`GLB\`: Binary glTF format for 3D models, including geometry, textures, and PBR materials.

**Allowed values**: `GLB` `FBX`

### [webhookURL](https://runware.ai/docs/models/tripo-v3-1#request-webhookurl)

- **Type**: `string`
- **Format**: `uri`

Webhook URL that receives JSON responses via HTTP POST when generation tasks complete. For batch requests with multiple results, each completed item triggers a separate webhook call as it becomes available.

**Learn more** (1 resource):

- [Webhooks](https://runware.ai/docs/models-api/webhooks) (platform)

### [deliveryMethod](https://runware.ai/docs/models/tripo-v3-1#request-deliverymethod)

- **Type**: `string`
- **Default**: `async`

Determines how the API delivers task results.

**Allowed values**:

- `sync` Returns results directly in the API response. Over HTTP, a task still running after 120 seconds continues as an async task and comes back with status 'processing'. Poll for its results using getResponse.
- `async` Returns an immediate acknowledgment with the task UUID. Poll for results using getResponse.

**Learn more** (1 resource):

- [Task Polling](https://runware.ai/docs/models-api/task-polling) (platform)

### [uploadEndpoint](https://runware.ai/docs/models/tripo-v3-1#request-uploadendpoint)

- **Type**: `string`
- **Format**: `uri`

Specifies a URL where the generated content will be automatically uploaded using the HTTP PUT method. The raw binary data of the media file is sent directly as the request body. For secure uploads to cloud storage, use presigned URLs that include temporary authentication credentials.

**Common use cases:**

- **Cloud storage**: Upload directly to S3 buckets, Google Cloud Storage, or Azure Blob Storage using presigned URLs.
- **CDN integration**: Upload to content delivery networks for immediate distribution.

```text
// S3 presigned URL for secure upload
https://your-bucket.s3.amazonaws.com/generated/content.mp4?X-Amz-Signature=abc123&X-Amz-Expires=3600

// Google Cloud Storage presigned URL
https://storage.googleapis.com/your-bucket/content.jpg?X-Goog-Signature=xyz789

// Custom storage endpoint
https://storage.example.com/uploads/generated-image.jpg
```

The content data will be sent as the request body to the specified URL when generation is complete.

### [ttl](https://runware.ai/docs/models/tripo-v3-1#request-ttl)

- **Type**: `integer`
- **Min**: `60`

Time-to-live (TTL) in seconds for generated content. Only applies when `outputType` is `URL`.

### [includeCost](https://runware.ai/docs/models/tripo-v3-1#request-includecost)

- **Type**: `boolean`

Include task cost in the response.

### [numberResults](https://runware.ai/docs/models/tripo-v3-1#request-numberresults)

- **Type**: `integer`
- **Min**: `1`
- **Max**: `4`
- **Default**: `1`

Number of results to generate. Each result uses a different seed, producing variations of the same parameters.

**Inputs**

Input resources for the task (images, audio, etc). These must be nested inside the \`inputs\` object.

### [images](https://runware.ai/docs/models/tripo-v3-1#request-inputs-images)

- **Path**: `inputs.images`
- **Type**: `array of strings`
- **Min items**: `1`
- **Max items**: `4`

Image inputs for image-to-3D or multiview-to-3D generation (UUID, URL, Data URI, or Base64).

**Core Parameters**

Primary parameters that define the task output.

### [model](https://runware.ai/docs/models/tripo-v3-1#request-model)

- **Type**: `string`
- **Required**: true
- **Value**: `tripo:v3.1@0`

Send `auto` instead of an AIR identifier to have the model router choose the model for this task. The rest of the request is unchanged, every value you send is kept, and only the parameters you leave out are filled in. See [Model Router](https://runware.ai/docs/models-api/model-router).

**Learn more** (3 resources):

- [Text To Image: Model Selection](https://runware.ai/docs/learn/text-to-image#model-selection) (learn)
- [Image Inpainting: Model Specialized Inpainting Models](https://runware.ai/docs/learn/image-inpainting#model-specialized-inpainting-models) (learn)
- [Image Outpainting: Other Critical Parameters](https://runware.ai/docs/learn/image-outpainting#other-critical-parameters) (learn)

### [positivePrompt](https://runware.ai/docs/models/tripo-v3-1#request-positiveprompt)

- **Type**: `string`
- **Max**: `1024`

Text prompt describing elements to include in the generated output.

**Learn more** (1 resource):

- [Prompts](https://runware.ai/docs/learn/prompts) (learn)

### [negativePrompt](https://runware.ai/docs/models/tripo-v3-1#request-negativeprompt)

- **Type**: `string`
- **Max**: `255`

Prompt to guide what to exclude from generation. Ignored when guidance is disabled (CFGScale ≤ 1).

**Learn more** (1 resource):

- [Prompts: Negative Prompts](https://runware.ai/docs/learn/prompts#negative-prompts) (learn)

### [seed](https://runware.ai/docs/models/tripo-v3-1#request-seed)

- **Type**: `integer`
- **Min**: `1`
- **Max**: `20240919`

Random seed for reproducible generation. When not provided, a random seed is generated in the unsigned 32-bit range.

**Learn more** (1 resource):

- [Seed](https://runware.ai/docs/learn/seed) (learn)

**Settings**

Technical parameters to fine-tune the inference process. These must be nested inside the \`settings\` object.

### [autoSize](https://runware.ai/docs/models/tripo-v3-1#request-settings-autosize)

- **Path**: `settings.autoSize`
- **Type**: `boolean`

Scales the model to real-world dimensions in meters.

### [compress](https://runware.ai/docs/models/tripo-v3-1#request-settings-compress)

- **Path**: `settings.compress`
- **Type**: `string`
- **Default**: `meshopt`

Compression method for the output mesh.

**Allowed values**:

- `geometry` Geometry-based compression. Requires decompression for editing.
- `meshopt` Default mesh optimization compression.

### [exportUv](https://runware.ai/docs/models/tripo-v3-1#request-settings-exportuv)

- **Path**: `settings.exportUv`
- **Type**: `boolean`
- **Default**: `true`

Enables UV unwrapping on the output mesh.

### [faceLimit](https://runware.ai/docs/models/tripo-v3-1#request-settings-facelimit)

- **Path**: `settings.faceLimit`
- **Type**: `integer`
- **Min**: `500`
- **Max**: `20000`

Maximum number of faces (polygons) in the output mesh. If not set, determined adaptively. Range depends on mode: 1000–20000 for low-poly, 500–10000 for quad.

### [generateParts](https://runware.ai/docs/models/tripo-v3-1#request-settings-generateparts)

- **Path**: `settings.generateParts`
- **Type**: `boolean`

Generates segmented 3D models with individually editable parts.

### [geometryQuality](https://runware.ai/docs/models/tripo-v3-1#request-settings-geometryquality)

- **Path**: `settings.geometryQuality`
- **Type**: `string`
- **Default**: `standard`

Controls the geometric detail level of the output mesh.

**Allowed values**:

- `standard` Balanced detail and generation speed.
- `detailed` Maximum geometric detail. Slower generation.

### [imageAutoFix](https://runware.ai/docs/models/tripo-v3-1#request-settings-imageautofix)

- **Path**: `settings.imageAutoFix`
- **Type**: `boolean`

Optimizes the input image for better 3D generation results.

### [orientation](https://runware.ai/docs/models/tripo-v3-1#request-settings-orientation)

- **Path**: `settings.orientation`
- **Type**: `string`
- **Default**: `default`

Controls model orientation.

**Allowed values**:

- `default` Default model orientation.
- `align_image` Rotates the model to match the input image viewpoint.

### [pbr](https://runware.ai/docs/models/tripo-v3-1#request-settings-pbr)

- **Path**: `settings.pbr`
- **Type**: `boolean`
- **Default**: `true`

Enables physically-based rendering materials.

### [quad](https://runware.ai/docs/models/tripo-v3-1#request-settings-quad)

- **Path**: `settings.quad`
- **Type**: `boolean`

Enables quad mesh output.

### [smartLowPoly](https://runware.ai/docs/models/tripo-v3-1#request-settings-smartlowpoly)

- **Path**: `settings.smartLowPoly`
- **Type**: `boolean`

Generates low-poly meshes optimized for simple inputs. May fail on complex models.

### [texture](https://runware.ai/docs/models/tripo-v3-1#request-settings-texture)

- **Path**: `settings.texture`
- **Type**: `boolean`
- **Default**: `true`

Enables texturing on the generated model. Set to false for a base model without textures.

### [textureAlignment](https://runware.ai/docs/models/tripo-v3-1#request-settings-texturealignment)

- **Path**: `settings.textureAlignment`
- **Type**: `string`

Controls texture alignment priority.

**Allowed values**:

- `original_image` Prioritizes visual fidelity to the source image. May introduce minor 3D inconsistencies.
- `geometry` Prioritizes structural accuracy. May slightly deviate from original appearance.

### [textureQuality](https://runware.ai/docs/models/tripo-v3-1#request-settings-texturequality)

- **Path**: `settings.textureQuality`
- **Type**: `string`
- **Default**: `standard`

Resolution quality for generated textures.

**Allowed values**:

- `standard` Balanced quality and speed.
- `detailed` Higher resolution textures with finer surface detail.

### [textureSeed](https://runware.ai/docs/models/tripo-v3-1#request-settings-textureseed)

- **Path**: `settings.textureSeed`
- **Type**: `integer`
- **Min**: `0`
- **Max**: `20240919`

Seed for texture generation reproducibility.

## Response Parameters

### [taskType](https://runware.ai/docs/models/tripo-v3-1#response-tasktype)

- **Type**: `string`
- **Required**: true
- **Value**: `3dInference`

Identifier for the type of task this response belongs to.

### [taskUUID](https://runware.ai/docs/models/tripo-v3-1#response-taskuuid)

- **Type**: `string`
- **Required**: true
- **Format**: `UUID v4`

UUID v4 identifier echoed from the original request, used to match async responses to their tasks.

### [seed](https://runware.ai/docs/models/tripo-v3-1#response-seed)

- **Type**: `integer`

The seed used for generation. If none was provided, shows the randomly generated seed.

### [cost](https://runware.ai/docs/models/tripo-v3-1#response-cost)

- **Type**: `float`

Task cost in USD. Present when `includeCost` is set to `true` in the request.

### [outputs](https://runware.ai/docs/models/tripo-v3-1#response-outputs)

- **Path**: `outputs.files`
- **Type**: `object (3 properties)`
- **Required**: true

Generated output artifacts.

#### [files](https://runware.ai/docs/models/tripo-v3-1#response-outputs-files)

- **Path**: `outputs.files`
- **Type**: `array of objects (2 properties)`
- **Required**: true
- **Min items**: `1`

Generated output files.

##### [uuid](https://runware.ai/docs/models/tripo-v3-1#response-outputs-files-uuid)

- **Path**: `outputs.files.uuid`
- **Type**: `string`
- **Required**: true
- **Format**: `UUID v4`

UUID of the output file.

##### [url](https://runware.ai/docs/models/tripo-v3-1#response-outputs-files-url)

- **Path**: `outputs.files.url`
- **Type**: `string`
- **Required**: true
- **Format**: `uri`

URL of the output file.

## Examples

### text-to-3d (text-to-3d)

[View 3D model](https://assets.runware.ai/examples/tripo-v3-1/378010fd-79a1-4de6-91d7-e8c667a41abb.glb)

```json
{
  "taskType": "3dInference",
  "taskUUID": "52eed271-8111-4755-9148-078e83632913",
  "model": "tripo:v3.1@0",
  "positivePrompt": "Full-body stylized pangolin wildfire ranger character for a wildlife conservation game, standing upright in a neutral A-pose. Clear compact silhouette with a long heavy tail, tapered snout, sturdy clawed feet, and layered geometric keratin scales. Wearing a practical mustard canvas utility vest, dark green ranger helmet, leather belt with canteen, and rugged rubber field boots. Friendly alert expression, believable anatomy, clean animation-friendly forms, distinct equipment pieces, warm clay-brown scales, matte woven fabric, scuffed leather, and molded rubber. Self-contained character with no base or environment.",
  "settings": {
    "geometryQuality": "detailed",
    "textureQuality": "detailed",
    "texture": true,
    "pbr": true
  }
}
```

---

### segmented-3d (segmented-3d)

[View 3D model](https://assets.runware.ai/examples/tripo-v3-1/10470c16-e3b9-402d-87c4-4c77e4928a96.glb)

```json
{
  "taskType": "3dInference",
  "taskUUID": "4d1344c2-7889-471a-a318-abedf0d7a9d2",
  "model": "tripo:v3.1@0",
  "positivePrompt": "Game-ready 3D prop of a rugged near-future beekeeper's smoker used by commercial orchard pollination crews. Practical industrial design with clearly separable functional parts: cylindrical brushed-steel fire chamber, perforated ivory ceramic heat shield, hinged conical lid, short directional smoke nozzle, lime-green silicone bellows with two rigid paddle plates, rear pivot bracket, folding carry handle, side latch, removable ash cup, and small protective feet. Each component should read as a distinct assembled part with believable seams, hinges, fasteners, and thickness. Subtle soot around the nozzle, heat discoloration on steel, dusty wear on grips, restrained cream, graphite, and citrus-green palette. Realistic PBR materials, clean optimized geometry, fully modeled from every angle, neutral resting pose, isolated complete object, no branding or text.",
  "settings": {
    "generateParts": true
  }
}
```

---

### geometry-only-3d (geometry-only-3d)

[View 3D model](https://assets.runware.ai/examples/tripo-v3-1/b0f1bf9f-88ee-4b27-baae-56932d7730ed.glb)

```json
{
  "taskType": "3dInference",
  "taskUUID": "bb85b41a-87eb-4f2f-a278-a4fb855f9ac7",
  "model": "tripo:v3.1@0",
  "positivePrompt": "Create a production-ready 3D prop for a grounded Antarctic survival game: a man-portable ice-core auger, approximately 1.2 meters long. Build a strong readable silhouette around a hollow cylindrical core barrel, broad double-helical chip flights, a toothed cutting crown, and a compact faceted drive housing. Add two folded side handles, a recessed coupling socket, deep bolt wells, guarded vents, grooved grip collars, raised reinforcement ribs, bevels, and stepped mechanical transitions. Make the cutting teeth thick and credible rather than razor thin. The form should feel engineered for field maintenance, with clearly separated functional components and convincing wall thickness. Visual interest must come from sculpted volumes, recesses, edge treatment, and surface geometry rather than decals or printed graphics. Single assembled object, complete on every side, clean game-ready topology, no stand, cable, loose parts, environment, logos, or text.",
  "settings": {
    "texture": false,
    "pbr": false,
    "geometryQuality": "detailed",
    "exportUv": false
  }
}
```

---

### reference-to-3d (reference-to-3d)

[View 3D model](https://assets.runware.ai/examples/tripo-v3-1/b36451b5-297c-49fd-a619-a7c475159805.glb)

```json
{
  "taskType": "3dInference",
  "taskUUID": "eaf4f459-ee20-496c-b499-08f03a8c1de2",
  "model": "tripo:v3.1@0",
  "settings": {
    "imageAutoFix": true,
    "orientation": "align_image",
    "textureAlignment": "original_image"
  },
  "inputs": {
    "images": [
      "https://assets.runware.ai/assets/inputs/c8bf20e8-5cac-4576-9136-e9a4df58f753.jpg",
      "https://assets.runware.ai/assets/inputs/b8693f31-a2a7-47c2-8eba-6d33fdc076b1.jpg",
      "https://assets.runware.ai/assets/inputs/2b86d50b-002a-4a11-9590-7b4cd5fc776a.jpg",
      "https://assets.runware.ai/assets/inputs/472169a6-fc56-46b4-9af8-47f0d5899c25.jpg"
    ]
  }
}
```

---

### quad-mesh (quad-mesh)

```
{
  "taskType": "3dInference",
  "taskUUID": "4e744241-a688-4bb0-9204-ed4e2550d73f",
  "seed": 18574884,
  "cost": 0.35,
  "outputs": {
    "files": [
      {
        "uuid": "edad1dce-993c-478e-89c7-6164e7fdab27",
        "url": "https://im.runware.ai/image/os/a08dlim3/ws/4/ii/edad1dce-993c-478e-89c7-6164e7fdab27.fbx"
      }
    ]
  }
}
```

```json
{
  "taskType": "3dInference",
  "taskUUID": "4e744241-a688-4bb0-9204-ed4e2550d73f",
  "outputFormat": "FBX",
  "model": "tripo:v3.1@0",
  "settings": {
    "quad": true,
    "faceLimit": 8000,
    "texture": true,
    "pbr": true
  },
  "inputs": {
    "images": [
      "https://assets.runware.ai/assets/inputs/a1d96f7f-b153-4b60-8f77-f0aed077a49d.jpg"
    ]
  }
}
```