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

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.

Have a reference photo? Try Tripo3D H3.1 Image-to-3D for more accurate results.

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

Parameter	Required	Description
prompt	Yes	Text description of the 3D object to generate. Max 1024 characters.
negative_prompt	No	Features to avoid in the generated model. Max 1024 characters.
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.
auto_size	No	Auto-scale the model to real-world dimensions. Default: false.
quad	No	Generate quad mesh topology instead of triangles. Default: false.

How to Use

Write your prompt — describe the object in detail including shape, material, style, and any distinctive features. Max 1024 characters.
Add negative prompt (optional) — specify features or styles you want to avoid.
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 fidelity.
Enable quad mesh (optional) — use quad topology for animation or sculpting workflows.
Submit — generate and download your 3D model.

Pricing

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

Related Models

Tripo3D H3.1 Image-to-3D — Generate 3D models from a single reference image.
Tripo3D H3.1 Multiview-to-3D — Higher accuracy reconstruction from 2–4 reference images.

H3.1 Text To 3d API — Quick start

Grab a WaveSpeedAI API key, then call POST https://api.wavespeed.ai/api/v3/tripo3d/h3.1/text-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 Text To 3d below.

HTTP example

# Submit the prediction
curl -X POST "https://api.wavespeed.ai/api/v3/tripo3d/h3.1/text-to-3d" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY" \
  -d '{
    "prompt": "A cinematic shot of a city at sunset, soft golden light",
    "negative_prompt": "blurry, low quality, distorted",
    "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/text-to-3d", {
        "prompt": "A cinematic shot of a city at sunset, soft golden light",
        "negative_prompt": "blurry, low quality, distorted",
        "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/text-to-3d",
    {
    "prompt": "A cinematic shot of a city at sunset, soft golden light",
    "negative_prompt": "blurry, low quality, distorted",
    "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 Text To 3d API — Frequently asked questions

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

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

How do I call the H3.1 Text 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-text-to-3d.

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

H3.1 Text To 3d starts at $0.10 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 Text To 3d accept?

Key inputs: `prompt`, `negative_prompt`, `auto_size`, `geometry_quality`, `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-text-to-3d.

How do I get started with the H3.1 Text 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 Text 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.

サンプルすべて表示

関連モデル

README