Browse ModelsTripo3dTripo3d H3.1 Text To 3d

Tripo3d H3.1 Text To 3d

Tripo3d H3.1 Text To 3d

Playground

Try it on WavespeedAI!

Tripo3D H3.1 Text-to-3D generates high-quality 3D models from text descriptions. Supports textures with standard and HD quality, PBR materials, detailed geometry, quad mesh topology, and auto-sizing. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

Features

Tripo3D H3.1 Text-to-3D

Tripo3D H3.1 Text-to-3D generates a production-ready 3D model directly from a text description. Describe the object you want — the model creates accurate geometry with optional PBR textures, quad mesh topology, and detailed quality tiers for both geometry and texture. No reference image needed.


Why Choose This?

  • Text-driven 3D generation Create 3D models from natural language descriptions alone — no photography or reference images required.

  • Negative prompt support Specify features to avoid in the generated model for more precise control over the output geometry and style.

  • PBR material generation Generate Physically Based Rendering materials alongside the mesh for realistic real-time rendering in game engines and 3D tools.

  • Geometry and texture quality tiers Choose between standard and detailed quality independently for geometry and texture.

  • Quad mesh support Generate quad (4-sided) mesh topology instead of triangles for cleaner topology compatible with animation and sculpting workflows.


Parameters

ParameterRequiredDescription
promptYesText description of the 3D object to generate. Max 1024 characters.
negative_promptNoFeatures to avoid in the generated model. Max 1024 characters.
textureNoWhether to generate textures for the model. Default: true.
pbrNoWhether to generate PBR materials. Requires texture to be enabled. Default: true.
texture_qualityNoTexture quality: standard (default) or detailed (higher resolution).
geometry_qualityNoGeometry quality: standard (default) or detailed.
auto_sizeNoAuto-scale the model to real-world dimensions. Default: false.
quadNoGenerate quad mesh topology instead of triangles. Default: false.

How to Use

  1. Write your prompt — describe the object in detail including shape, material, style, and any distinctive features. Max 1024 characters.
  2. Add negative prompt (optional) — specify features or styles you want to avoid.
  3. Configure texture settings (optional) — enable or disable texture and PBR generation, and choose standard or detailed texture quality.
  4. Set geometry quality (optional) — choose standard for faster results or detailed for higher fidelity.
  5. Enable quad mesh (optional) — use quad topology for animation or sculpting workflows.
  6. Submit — generate and download your 3D model.

Pricing

TextureTexture QualityGeometry QualityQuadCost
NoStandardNo$0.10
NoDetailedNo$0.30
YesStandardStandardNo$0.20
YesStandardDetailedNo$0.40
YesDetailedStandardNo$0.30
YesDetailedDetailedNo$0.50

Add +$0.05 to any combination above when quad is enabled.

Billing Rules

  • Base: $0.10 × texture multiplier (no texture: ×1, standard texture: ×2, detailed texture: ×3)
  • Detailed geometry surcharge: +$0.20
  • Quad surcharge: +$0.05
  • Default configuration (texture standard, geometry standard, no quad): $0.20

Best Use Cases

  • Concept art & prototyping — Rapidly generate 3D assets from written descriptions for ideation and visualization.
  • Game asset creation — Create textured 3D props and objects from descriptive prompts without photography.
  • Animation & VFX — Use quad mesh output for animation-ready topology compatible with rigging and sculpting.
  • AR/VR content — Generate PBR-textured models for immersive application development.
  • Developer workflows — Embed text-driven 3D generation into creative pipelines and tools.

Pro Tips

  • Be specific and descriptive in your prompt — include shape, material, style, color, and any distinctive features.
  • Use negative_prompt to avoid unwanted stylistic elements or geometric artifacts.
  • Use detailed geometry quality for complex shapes with fine surface detail.
  • Use quad mesh when the model will be used for animation or further sculpting in tools like Blender or ZBrush.
  • For objects with a known visual reference, consider using Image-to-3D for more accurate results.

Notes

  • Only prompt is required; all other parameters are optional.
  • Prompt and negative_prompt are each limited to 1024 characters.
  • Please ensure your content complies with Tripo3D’s usage policies.

Authentication

For authentication details, please refer to the Authentication Guide.

API Endpoints

Submit Task & Query Result


# Submit the task
curl --location --request POST "https://api.wavespeed.ai/api/v3/tripo3d/h3.1/text-to-3d" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}" \
--data-raw '{
    "texture": true,
    "pbr": true,
    "texture_quality": "standard",
    "geometry_quality": "standard",
    "auto_size": false,
    "quad": false
}'

# Get the result
curl --location --request GET "https://api.wavespeed.ai/api/v3/predictions/${requestId}/result" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}"

Parameters

Task Submission Parameters

Request Parameters

ParameterTypeRequiredDefaultRangeDescription
promptstringYes-Text description of the 3D object to generate. Maximum 1024 characters.
negative_promptstringNo-Text describing features to avoid in the generated model.Maximum 1024 characters.
texturebooleanNotrue-Whether to generate textures for the model.
pbrbooleanNotrue-Whether to generate PBR (Physically Based Rendering) materials. If true, texture is also enabled.
texture_qualitystringNostandardstandard, detailedQuality level for textures. 'detailed' produces higher-resolution textures.
geometry_qualitystringNostandardstandard, detailedQuality level for geometry.
auto_sizebooleanNofalse-Auto-scale the model to real-world dimensions.
quadbooleanNofalse-Generate quad (4-sided) mesh topology instead of triangles.
face_limitintegerNo-1000 ~ 2000000Target number of faces for the generated mesh. If not set, the model adaptively determines the count.
model_seedintegerNo--Seed for geometry generation reproducibility.
image_seedintegerNo--Seed for the text-to-image step.
texture_seedintegerNo--Seed for texture generation reproducibility.

Response Parameters

ParameterTypeDescription
codeintegerHTTP status code (e.g., 200 for success)
messagestringStatus message (e.g., “success”)
data.idstringUnique identifier for the prediction, Task Id
data.modelstringModel ID used for the prediction
data.outputsarrayArray of URLs to the generated content (empty when status is not completed)
data.urlsobjectObject containing related API endpoints
data.urls.getstringURL to retrieve the prediction result
data.has_nsfw_contentsarrayArray of boolean values indicating NSFW detection for each output
data.statusstringStatus of the task: created, processing, completed, or failed
data.created_atstringISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”)
data.errorstringError message (empty if no error occurred)
data.timingsobjectObject containing timing details
data.timings.inferenceintegerInference time in milliseconds

Result Request Parameters

ParameterTypeRequiredDefaultDescription
idstringYes-Task ID

Result Response Parameters

ParameterTypeDescription
codeintegerHTTP status code (e.g., 200 for success)
messagestringStatus message (e.g., “success”)
dataobjectThe prediction data object containing all details
data.idstringUnique identifier for the prediction, the ID of the prediction to get
data.modelstringModel ID used for the prediction
data.outputsstringArray of URLs to the generated content (empty when status is not completed).
data.urlsobjectObject containing related API endpoints
data.urls.getstringURL to retrieve the prediction result
data.statusstringStatus of the task: created, processing, completed, or failed
data.created_atstringISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”)
data.errorstringError message (empty if no error occurred)
data.timingsobjectObject containing timing details
data.timings.inferenceintegerInference time in milliseconds
© 2025 WaveSpeedAI. All rights reserved.