↑↓ Navigate enter Open esc Close
Dashboard
MODEL ID tripo:v3.1@0
coming-soon

Tripo 3D v3.1

Tripo AI
by Tripo AI

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.

Tripo 3D v3.1

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.

    Allowed values 2 values

    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

    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

    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: 20 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:tripo@v3-1

    Identifier of the model to use for generation.

    Learn more 3 resources

    positivePrompt

    string max: 1024

    Text prompt describing elements to include in the generated output.

    Learn more 2 resources

    negativePrompt

    string max: 255

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

    Learn more 1 resource

    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.

    Learn more 1 resource

    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.

    Ask AI
    Send feedback