Tripo3D H3.1 Image to 3D | AI Image-to-3D Model API

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.

Need more accuracy? Try Tripo3D H3.1 Multiview-to-3D with 2–4 angle shots.

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

Parameter	Required	Description
image	Yes	URL of the input image for 3D model creation.
texture	No	Whether to generate textures for the model. Default: true.
pbr	No	Whether to generate PBR materials. Requires texture to be enabled. Default: true.
texture_quality	No	Texture quality: standard (default) or detailed (higher resolution).
geometry_quality	No	Geometry quality: standard (default) or detailed.
texture_alignment	No	How textures are aligned: original_image (default) or geometry.
auto_size	No	Auto-scale the model to real-world dimensions. Default: false.
orientation	No	Model orientation: default or align_image (auto-rotates to match input image).
quad	No	Generate quad mesh topology instead of triangles. Default: false.

How to Use

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

Pricing

Texture	Texture Quality	Geometry Quality	Quad	Cost
No	—	Standard	No	$0.20
No	—	Detailed	No	$0.40
Yes	Standard	Standard	No	$0.30
Yes	Standard	Detailed	No	$0.50
Yes	Detailed	Standard	No	$0.40
Yes	Detailed	Detailed	No	$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.

Related Models

Tripo3D H3.1 Multiview-to-3D — Higher accuracy 3D reconstruction from 2–4 reference images.

H3.1 Image To 3d API — Quick start

Grab a WaveSpeedAI API key, then call POST https://api.wavespeed.ai/api/v3/tripo3d/h3.1/image-to-3d with your input as JSON. The endpoint returns a prediction id; poll the prediction endpoint until status flips to completed, then read the output URL from data.outputs[0]. Examples for H3.1 Image To 3d below.

HTTP example

# Submit the prediction
curl -X POST "https://api.wavespeed.ai/api/v3/tripo3d/h3.1/image-to-3d" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY" \
  -d '{
    "image": "https://example.com/your-input.jpg",
    "texture_alignment": "original_image",
    "orientation": "default",
    "texture": true,
    "pbr": true,
    "texture_quality": "standard",
    "geometry_quality": "standard",
    "auto_size": false,
    "quad": false
}'

# Response includes a prediction id. Poll for the result:
curl -X GET "https://api.wavespeed.ai/api/v3/predictions/{request_id}/result" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY"

# When status is "completed", read the output from data.outputs[0].

Node.js example

// npm install wavespeed
const WaveSpeed = require('wavespeed');

const client = new WaveSpeed(); // reads WAVESPEED_API_KEY from env

const result = await client.run("tripo3d/h3.1/image-to-3d", {
        "image": "https://example.com/your-input.jpg",
        "texture_alignment": "original_image",
        "orientation": "default",
        "texture": true,
        "pbr": true,
        "texture_quality": "standard",
        "geometry_quality": "standard",
        "auto_size": false,
        "quad": false
});

console.log(result.outputs[0]); // → URL of the generated output

Python example

# pip install wavespeed
import wavespeed

output = wavespeed.run(
    "tripo3d/h3.1/image-to-3d",
    {
    "image": "https://example.com/your-input.jpg",
    "texture_alignment": "original_image",
    "orientation": "default",
    "texture": true,
    "pbr": true,
    "texture_quality": "standard",
    "geometry_quality": "standard",
    "auto_size": false,
    "quad": false
}
)

print(output["outputs"][0])  # → URL of the generated output

H3.1 Image To 3d API — Frequently asked questions

What is the H3.1 Image To 3d API?

H3.1 Image To 3d is a Tripo3D model for 3D asset generation from images, exposed as a REST API 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. You can call it programmatically or try it from the playground above.

How do I call the H3.1 Image To 3d API?

POST your input parameters to the model's REST endpoint (shown in the API tab of this playground) with your WaveSpeedAI API key in the Authorization header. Submission returns a prediction ID; poll the prediction endpoint until status flips to "completed", then read the output URL from the result. The playground generates a ready-to-paste code sample in Python, JavaScript, or cURL for whatever inputs you've set. Full request/response shape is documented at https://wavespeed.ai/docs/docs-api/tripo3d/tripo3d-h3.1-image-to-3d.

How much does H3.1 Image To 3d cost per run?

H3.1 Image To 3d starts at $0.20 per run. That figure is the base price — the final charge scales with the parameters you set in the form (output size, length, count, references, or whatever knobs this model exposes), so a higher-quality or larger output costs more than a minimal one. The exact cost for your current input is shown live next to the Generate button before you submit, and the actual per-call charge is recorded on the prediction afterwards.

What inputs does H3.1 Image To 3d accept?

Key inputs: `image`, `auto_size`, `geometry_quality`, `orientation`, `pbr`, `quad`. The full JSON schema (types, defaults, allowed values) is rendered above the Generate button and mirrored in the API reference at https://wavespeed.ai/docs/docs-api/tripo3d/tripo3d-h3.1-image-to-3d.

How do I get started with the H3.1 Image To 3d API?

Sign up for a free WaveSpeedAI account to claim starter credits, copy your API key from /accesskey, then call the endpoint shown in the API tab of the playground. The playground also auto-generates a code sample in Python, JavaScript, or cURL for the parameters you've set.

Can I use H3.1 Image To 3d outputs commercially?

Commercial usage rights depend on the model's license, set by its provider (Tripo3D). The license summary appears on the model card above; see WaveSpeedAI's Terms of Service for platform-level conditions.

BeispieleAlle anzeigen

Ähnliche Modelle

README