Browse ModelsTripo3dTripo3d H3.1 Image To 3d

Tripo3d H3.1 Image To 3d

Tripo3d H3.1 Image To 3d

Playground

Try it on WavespeedAI!

Tripo3D H3.1 Image-to-3D converts a single image into high-quality 3D models with textures and PBR materials. Supports standard and HD texture quality, detailed geometry, quad mesh topology, texture alignment, and orientation control. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

Features

Tripo3D H3.1 Image-to-3D

Tripo3D H3.1 Image-to-3D reconstructs a production-ready 3D model from a single reference image. Upload one photo — the model generates accurate geometry with optional PBR textures, quad mesh topology, and detailed quality tiers for both geometry and texture.


Why Choose This?

  • Single-image 3D reconstruction Generate a fully textured 3D model from just one reference photo — no multi-view capture or manual modeling required.

  • 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 — optimizing for speed, cost, or maximum fidelity.

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

  • Texture alignment control Align textures to the original input image or to the generated geometry for different use case requirements.

  • Orientation control Use align_image to auto-rotate the model to match the input image orientation.


Parameters

ParameterRequiredDescription
imageYesURL of the input image for 3D model creation.
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.
texture_alignmentNoHow textures are aligned: original_image (default) or geometry.
auto_sizeNoAuto-scale the model to real-world dimensions. Default: false.
orientationNoModel orientation: default or align_image (auto-rotates to match input image).
quadNoGenerate quad mesh topology instead of triangles. Default: false.

How to Use

  1. Upload your image — provide a clear, well-lit reference image URL of the object.
  2. Configure texture settings (optional) — enable or disable texture and PBR generation, and choose standard or detailed texture quality.
  3. Set geometry quality (optional) — choose standard for faster results or detailed for higher geometric fidelity.
  4. Configure additional options (optional) — set texture alignment, orientation, quad mesh, and auto-size as needed.
  5. Submit — generate and download your 3D model.

Pricing

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

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

Billing Rules

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

Best Use Cases

  • Game asset production — Reconstruct clean, textured 3D models from product or object photography for use in game engines.
  • E-commerce 3D — Generate 3D product models from a single product photo for interactive viewers and AR.
  • Animation & VFX — Use quad mesh output for animation-ready topology compatible with rigging and sculpting workflows.
  • Digital twins — Accurately reconstruct real-world objects from a single reference photograph.
  • AR/VR content — Generate PBR-textured models for immersive application development.
  • Rapid prototyping — Quickly convert reference photos into 3D assets for concept visualization.

Pro Tips

  • Use a clear, well-lit photo with the subject centered and clearly visible for the most accurate reconstruction.
  • Plain or neutral backgrounds help the model focus on the object geometry and texture.
  • Use detailed geometry quality for objects with fine surface detail like mechanical parts or organic shapes.
  • Use quad mesh when the model will be used for animation or further sculpting.
  • Enable auto_size when you need the model to match real-world scale.
  • For better accuracy with complex objects, consider using Multiview-to-3D with multiple angle shots.

Notes

  • image is the only required field; all other parameters are optional.
  • 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/image-to-3d" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}" \
--data-raw '{
    "texture_alignment": "original_image",
    "orientation": "default",
    "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
imagestringYes-URL of the input image for 3D model creation.
texture_alignmentstringNooriginal_imageoriginal_image, geometryHow textures are aligned. 'original_image' aligns to input image, 'geometry' aligns to generated geometry.
orientationstringNodefaultdefault, align_imageModel orientation. 'align_image' auto-rotates to match the input image.
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.