MODEL ID tripo:v3.1@0

api-only

Tripo 3D v3.1

by Tripo AI February 11, 2026

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.

API Options

Platform-level options for task execution and delivery.

taskType string required value: 3dInference: Identifier for the type of task being performed

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

outputType string default: URL: 3D output type.

Allowed values 1 value

outputFormat 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 1 value

webhookURL string URI

Specifies a webhook URL where JSON responses will be sent 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
PLATFORM

deliveryMethod string default: async

Determines how the API delivers task results.

Allowed values 2 values

: Returns complete results directly in the API response.
: Returns an immediate acknowledgment with the task UUID. Poll for results using getResponse.

Learn more 1 resource

Task Polling
PLATFORM

uploadEndpoint string 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.

// 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 integer min: 60: Time-to-live (TTL) in seconds for generated content. Only applies when outputType is URL.

includeCost boolean default: false: Include task cost in the response.

numberResults 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.

inputs » images images array of strings min items: 1max items: 4: Image inputs for image-to-3D or multiview-to-3D generation (UUID, URL, Data URI, or Base64).

Generation Parameters

Core parameters for controlling the generated content.

model string required value: tripo:v3.1@0: Identifier of the model to use for generation.

positivePrompt string max: 1024: Text prompt describing elements to include in the generated output.

negativePrompt string max: 255: Prompt to guide what to exclude from generation. Ignored when guidance is disabled (CFGScale ≤ 1).

seed integer min: 0 max: 20240919: Random seed for reproducible generation. When not provided, a random seed is generated in the unsigned 32-bit range.

Settings

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

settings » autoSize autoSize boolean default: false: Scales the model to real-world dimensions in meters.

settings » compress compress string default: meshopt

Compression method for the output mesh.

Allowed values 2 values

: Geometry-based compression. Requires decompression for editing.
: Default mesh optimization compression.

settings » exportUv exportUv boolean default: true: Enables UV unwrapping on the output mesh.

settings » faceLimit faceLimit 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.

settings » generateParts generateParts boolean default: false: Generates segmented 3D models with individually editable parts.

settings » geometryQuality geometryQuality string default: standard

Controls the geometric detail level of the output mesh.

Allowed values 2 values

: Balanced detail and generation speed.
: Maximum geometric detail. Slower generation.

settings » imageAutoFix imageAutoFix boolean default: false: Optimizes the input image for better 3D generation results.

settings » orientation orientation string default: default

Controls model orientation.

Allowed values 2 values

: Default model orientation.
: Rotates the model to match the input image viewpoint.

settings » pbr pbr boolean default: true: Enables physically-based rendering materials.

settings » quad quad boolean default: false: Enables quad mesh output.

settings » smartLowPoly smartLowPoly boolean default: false: Generates low-poly meshes optimized for simple inputs. May fail on complex models.

settings » texture texture boolean default: true: Enables texturing on the generated model. Set to false for a base model without textures.

settings » textureAlignment textureAlignment string

Controls texture alignment priority.

Allowed values 2 values

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

settings » textureQuality textureQuality string default: standard

Resolution quality for generated textures.

Allowed values 2 values

: Balanced quality and speed.
: Higher resolution textures with finer surface detail.

settings » textureSeed textureSeed integer min: 0 max: 20240919: Seed for texture generation reproducibility.