pbrboolean
Generate PBR materials (also enables texture).
Default: true
Tripo H3.1 Text to 3D
tripo3d/tripo-h3.1/text-to-3dTripo H3.1 is Tripo3D's text-to-3D AI model. Turn written descriptions into textured 3D objects with realistic geometry and materials.
Try the model
Playground
Input
Text description of the 3D object to generate. Maximum 1024 characters.
Additional Settings More
Customize your input with more control.
Generate PBR materials (also enables texture).
Generate quad mesh topology instead of triangles.
Seed for reproducible geometry generation.
Generate textures. Set both texture and pbr to false for an untextured model.
Target face count. Adaptive when unset. Range: 1000 to 2000000.
Features to avoid in the generated model.
standard or detailed (HD) textures. Allowed values: standard, detailed.
detailed geometry is billed as an add-on. Allowed values: standard, detailed.
ResultIdle
Your output will appear here
Complete the inputs, then click Run.
Tripo H3.1 Text to 3D
Tripo H3.1 turns a text prompt into a textured 3D model quickly and at low cost.
Fields
| Field | Type | Default | Notes |
|---|---|---|---|
prompt | string, required | — | Up to 1,024 characters. |
pbr | boolean | true | PBR materials. |
quad | boolean | false | Quad mesh output. |
seed | integer | random | Fix it to compare prompt changes. |
texture | boolean | true | Generate textures. |
face_limit | integer 1000–2000000 | — | Maximum face count. |
negative_prompt | string | — | What to avoid. |
texture_quality | standard / detailed | standard | Texture detail; higher costs more. |
geometry_quality | standard / detailed | standard | detailed adds mesh detail and cost. |
Billing
$0.24 per textured model at standard quality, $0.36 detailed, $0.12 untextured; detailed geometry adds $0.24 and quad output $0.06.
| Request | Price |
|---|---|
| Standard texture | $0.24 |
| Detailed texture | $0.36 |
| Untextured | $0.12 |
| Standard + detailed geometry | $0.48 |
Failed runs are not charged.
Also on SandBase
Other Tripo endpoints: tripo3d/tripo-p2/text-to-3d, tripo3d/tripo-p2/image-to-3d, tripo3d/tripo-h3.1/image-to-3d.
Start building
Send your first request
Submit this model through the SandBase Unified Run API.
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
-X POST "https://api.sandbase.ai/v1/run" \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<'SANDBASE_JSON'
{
"model": "tripo3d/tripo-h3.1/text-to-3d",
"pbr": true,
"quad": false,
"prompt": "A small house with a red roof and white walls",
"texture": true,
"texture_quality": "standard",
"geometry_quality": "standard"
}
SANDBASE_JSON
)
run_id=$(printf '%s' "$result" | jq -r .id)
for attempt in $(seq 1 120); do
status=$(printf '%s' "$result" | jq -r .status)
case "$status" in completed|failed|timeout) break ;; esac
sleep 2
result=$(curl --fail-with-body --silent \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
"https://api.sandbase.ai/v1/run/$run_id")
done
status=$(printf '%s' "$result" | jq -r .status)
[ "$status" = completed ] || { echo "Generation ended: $status" >&2; exit 1; }
printf '%s\n' "$result"2. Authentication
Create a SandBase API key and set it in your server environment. All requests use Bearer authentication.
export SANDBASE_API_KEY="YOUR_API_KEY"Keep the key on your server. Do not expose it in browser code or commit it to a repository.
3. Queue
Submit a request
POST to /v1/run with this model ID and its inputs. The request example above includes submission and polling.
Fetch request status and result
Use the returned run ID to poll until the status is completed, failed or timeout. Read output only after completed.
curl "https://api.sandbase.ai/v1/run/$RUN_ID" \
-H "Authorization: Bearer $SANDBASE_API_KEY"4. Files
Hosted files
Pass a publicly accessible file URL in the model’s image, video or audio field. Supported formats and limits are shown beside each Playground input.
Uploading images
Use the upload or replace control on supported image fields in the Playground. Video URL fields accept a hosted driving video; they do not imply video-upload support.
5. Schema
Input
quadboolean
Generate quad mesh topology instead of triangles.
Default: false
seedinteger
Seed for reproducible geometry generation.
promptstringrequired
Text description of the 3D object to generate. Maximum 1024 characters.
textureboolean
Generate textures. Set both texture and pbr to false for an untextured model.
Default: true
face_limitinteger
Target face count. Adaptive when unset.
Minimum: 1000
Maximum: 2000000
negative_promptstring
Features to avoid in the generated model.
texture_qualitystring
standard or detailed (HD) textures.
Default: "standard"
Possible values: "standard", "detailed"
geometry_qualitystring
detailed geometry is billed as an add-on.
Default: "standard"
Possible values: "standard", "detailed"
{
"model": "tripo3d/tripo-h3.1/text-to-3d",
"pbr": true,
"quad": false,
"prompt": "A small house with a red roof and white walls",
"texture": true,
"texture_quality": "standard",
"geometry_quality": "standard"
}Output
A completed run exposes its result in output. The following is the model’s saved example, not a new generation.
No example output has been published yet. Use Playground → Result → JSON after a completed run to inspect your response.