# Tripo3D Tripo v2.5 Text to 3D API

> Tripo v2.5 Text to 3D by Tripo3D: turn a text prompt into a textured 3D model.

Source: https://www.sandbase.ai/models/tripo3d/tripo-v2.5/text-to-3d
API reference: https://www.sandbase.ai/models/tripo3d/tripo-v2.5/text-to-3d#api

## Facts

- Provider: Tripo3D
- Type: Image model
- Model ID: `tripo3d/tripo-v2.5/text-to-3d`
- Price: From $0.20 per run
- Capabilities: text to 3d
- Billing: pay per use from one SandBase balance; no provider account or subscription needed

## Call it

- Unified Run API: `POST https://api.sandbase.ai/v1/run`

```bash
curl -X POST https://api.sandbase.ai/v1/run \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "tripo3d/tripo-v2.5/text-to-3d",
  "pbr": true,
  "quad": false,
  "prompt": "A low-poly medieval wooden treasure chest with iron hinges and a rusty lock.",
  "delight": false,
  "texture": true,
  "export_uv": true,
  "texture_quality": "standard"
}'
```

The response returns a run id; poll `GET https://api.sandbase.ai/v1/run/{id}` until the status is `completed` or `failed`.

## FAQ

### How do I call Tripo3D Tripo v2.5 Text to 3D through SandBase?

Create a SandBase API key, then send requests with the model ID "tripo3d/tripo-v2.5/text-to-3d" to Unified Run API (/v1/run) at https://api.sandbase.ai. The request examples on this page show the exact payload.

### Do I need a separate Tripo3D account?

No. One SandBase API key and balance gives you access to Tripo3D Tripo v2.5 Text to 3D and the other models in the catalog; you do not need to sign up with Tripo3D separately.

## README

### Tripo v2.5 Text to 3D
Tripo v2.5 (v2.5-20250123) is Tripo's legacy model, kept for older projects.
#### Fields
| Field | Type | Default | Notes |
|---|---|---|---|
| `prompt` | string, required | — | Describe shape, material, style and scale. Up to 1,024 characters. |
| `negative_prompt` | string | — | What to avoid, up to 255 characters. |
| `texture` | boolean | `true` | Generate textures. Set texture and pbr to false for bare geometry (cheaper). |
| `pbr` | boolean | `true` | PBR material maps (base color, metallic, roughness, normal). true also turns texture on. |
| `texture_quality` | `standard` / `detailed` | `standard` | fast and standard cost the same; detailed (HD) and extreme (8K) are add-ons. |
| `quad` | boolean | `false` | Quad topology instead of triangles. Output becomes FBX; 10,000 faces when face_limit is unset. |
| `face_limit` | integer | — | Maximum face count, up to 500,000 (150,000 with quad). Adaptive when unset. |
| `seed` | integer | — | Seed for geometry generation (Tripo model_seed). Same seed and input give the same mesh. |
| `texture_seed` | integer | — | Seed for texture generation. Keep seed and change texture_seed for new textures on the same geometry. |
| `image_seed` | integer | — | Seed for the internal text-to-image step. |
| `texture_version` | `v2.5-20250123` / `v3.5-20260815` | — | Texture model. Default v2.5-20250123; v3.5-20260815 uses the current texture model. |
| `delight` | boolean | `false` | Remove baked-in lighting from the reference image before texturing (texture v3.5). |
| `export_uv` | boolean | `true` | UV-unwrap during generation. false is faster and smaller; UVs are then made during texturing. |
| `export_orientation` | `+x` / `-x` / `+y` / `-y` | — | Forward axis of the exported model. Leave unset if you will post-process the model. |
#### Output
- `url`: 3D model (GLB; FBX when quad is on).
- `thumbnail`: Preview render.
- `generated_image`: Reference image Tripo generated from the prompt.
#### Billing
$0.20 textured (standard texture), $0.10 untextured (texture and pbr false).
| Add-on | Price |
|---|---|
| texture_quality = detailed | +$0.10 |
| quad | +$0.05 |
Failed runs are not charged.
