Skip to content

Tripo H3.1 Text to 3D

Integrate

Model id tripo3d/h3.1/text-to-3d
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/tripo3d/h3.1/text-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Files like the example: $0.20 200 API credits your files are measured before the run Run it on this page

Get API key
Tripo Text to 3D #3d#text-to-3d#3d-generation#tripo

Text-to-3D mesh generator with negative prompt, separate geometry and texture quality tiers, and a very high face cap

Tripo · 3D

Your first result goes here

Build a request below and run it with your API key. Outputs are copied to our storage, kept forever or 7 days for free.

Build a request

Controls are generated from the model schema. The code and the price update as you change them.

•required 88 / 1024

Description in text of the desired 3D object, limited to 1024 characters.

texture_quality default standard

Texture quality setting; choosing 'detailed' increases texture resolution.

geometry_quality default standard

Quality setting for the geometry.

Advanced negative_prompt · face_limit · model_seed · image_seed · texture_seed · auto_size · enable_safety_checker
0 / 1024

Description of features that should be excluded from the generated model.

Explicit face-count target for mesh generation, overriding the model's adaptive count selection when supplied.

Seed used to make geometry generation reproducible.

Seed used during the text-to-image stage.

Seed used to make texture generation reproducible.

POST /run/tripo3d/h3.1/text-to-3d?wait=20 quote → $0.20
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/tripo3d/h3.1/text-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Run this request

Your key stays in this browser: it is sent only to the Doitong API and saved (localStorage) only if you tick Remember. Get an API key

About Tripo H3.1 Text to 3D

Builds a 3D model from a text description of up to 1024 characters, with an optional `negative_prompt` for features to avoid. `face_limit` accepts 1,000 to 2,000,000 faces. `geometry_quality` and `texture_quality` can each be standard or detailed. Options include PBR materials, quad topology, auto-scaling to real-world size, and separate seeds for geometry, the text-to-image step and texture.

Parameters

NameType DefaultAllowed Description
promptrequired
Typestring
≤ 1,024 characters
Description in text of the desired 3D object, limited to 1024 characters.
negative_promptoptional
Typestring | null
≤ 1,024 characters
Description of features that should be excluded from the generated model.
face_limitoptional
Typeinteger | null
1,000 – 2,000,000
Explicit face-count target for mesh generation, overriding the model's adaptive count selection when supplied.
textureoptional
Typeboolean
Defaulttrue
Controls whether the model receives generated textures.
pbroptional
Typeboolean
Defaulttrue
Enable PBR materials (Physically Based Rendering), which also turns on texture generation when true.
model_seedoptional
Typeinteger | null
Seed used to make geometry generation reproducible.
image_seedoptional
Typeinteger | null
Seed used during the text-to-image stage.
texture_seedoptional
Typeinteger | null
Seed used to make texture generation reproducible.
texture_qualityoptional
Typeenum
Defaultstandard
standarddetailed
Texture quality setting; choosing 'detailed' increases texture resolution.
geometry_qualityoptional
Typeenum
Defaultstandard
standarddetailed
Quality setting for the geometry.
auto_sizeoptional
Typeboolean
Defaultfalse
Automatic scaling to give the model real-world dimensions measured in meters.
quadoptional
Typeboolean
Defaultfalse
Choose between triangular faces and quads with 4 sides by enabling quad topology. For quad results, an FBX file is returned whenever Tripo supplies the data as FBX bytes.
enable_safety_checkeroptional
Typeboolean
Defaulttrue
Screening can be relaxed by setting false, provided the caller is authorized.
required

Output

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "tripo3d/h3.1/text-to-3d",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 200,
    "usd": "0.20",
    "charged": 200,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "output": {
    "model_mesh": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "model_urls": {
      "glb": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "fbx": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "base_model": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "pbr_model": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      }
    },
    "rendered_image": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "task_id": "string"
  },
  "outputs": [
    {
      "type": "file",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Your files, your choiceEvery outputs[].url is a copy on our storage: kept forever (paid per GB-month) or 7 days for free, by your account setting or ?storage=.
Same shape on every modeltype, url, content_type, width, height and duration, for images, video and audio alike. output is the model’s own result object.
Fields of output
model_mesh
object {url, content_type, file_name, file_size}GLB or FBX file containing the generated 3D model, with the format determined by what Tripo produces.
model_urls
object {glb, fbx, base_model, pbr_model}URLs pointing to alternative versions of the 3D model.
rendered_image
object {url, content_type, file_name, file_size} | nullRendered preview showing the generated 3D model.
task_id
string | nullReusable Tripo task ID identifying the generated model for rig or rig-check, allowing those operations without another model upload.

More models: Text to 3D

For AI agents: this page as Markdown is at https://doitong.com/developers/models/tripo3d/h3.1/text-to-3d.md. All models and guides: https://doitong.com/developers/llms.txt