Tripo H3.1 Text-to 3D API

Tripo H3.1 Text-to-3D

Tripo H3.1 Text-to-3D generates a textured 3D model from a text prompt. It produces a mesh (GLB, or FBX when quad topology is requested) with optional PBR materials, plus a preview render — ideal for rapid asset prototyping, game/AR content, and 3D design exploration.

🌟 Key Features

🧊 Text-to-3D

Generate a complete 3D mesh from a natural-language description of the object.

🎨 Textures & PBR Materials

Optionally generate textures and Physically Based Rendering (PBR) materials for production-ready shading.

🔺 Adaptive or Fixed Face Count

Let the model choose the mesh density adaptively, or cap it with face_limit for lighter assets.

🔁 Reproducible Results

Pin model_seed, image_seed, and texture_seed to reproduce or iterate on a specific generation.

📦 Multiple Output Formats

Receive GLB by default, or FBX when quad is enabled, alongside base and PBR model variants.

⚙️ Parameters

Parameter	Required	Description
prompt	✅	Text description of the 3D object to generate (max 1024 characters).
negative_prompt	❌	Features to avoid in the generated model.
texture	❌	Generate textures for the model (default: true).
pbr	❌	Generate PBR materials (default: true).
texture_quality	❌	Texture resolution level: standard (default) or detailed.
geometry_quality	❌	Geometry quality level: standard (default) or detailed.
face_limit	❌	Target mesh face count. Adaptive if unset.
model_seed	❌	Seed for geometry generation reproducibility.
image_seed	❌	Seed for the text-to-image step reproducibility.
texture_seed	❌	Seed for texture generation reproducibility.
auto_size	❌	Auto-scale the model to real-world dimensions in meters (default: false).
quad	❌	Generate a quad mesh instead of triangles; outputs FBX (default: false).

💲 Pricing

Configuration	Price
Without textures	$0.22
With standard textures	$0.33
With HD textures	$0.44
+ Detailed geometry (geometry_quality: detailed)	+$0.22
+ Quad mesh (quad: true)	+$0.055

💡 Prompt Tips

A small stylized wooden house with a red roof, white walls, and a stone chimney.

• Describe the object's shape, material, and style clearly; avoid scene/background details.
• Enable pbr for realistic materials in engines that support PBR shading.
• Use geometry_quality: detailed for organic or intricate shapes.
• Fix the seeds when iterating on a prompt to isolate the effect of each change.
• Set face_limit to keep meshes lightweight for real-time / mobile use.

🎯 Use Cases

• Game & AR Assets — Generate props, items, and environment pieces from text.
• Rapid Prototyping — Explore 3D concepts before committing to manual modeling.
• 3D Design Exploration — Iterate on shapes and materials quickly.
• E-commerce — Produce 3D previews of described products.

📝 Notes

• prompt is the only required field (besides model).
• Output model files are returned in outputs (GLB/FBX and variants); the preview image is in thumbnail and appended to outputs last.
• Structured per-file metadata (type, content_type, size) is available in files.
• Task status values: created, processing, completed, failed.