Skip to content

Tripo H3.1 Image to 3D

Integrate

Model id tripo3d/h3.1/image-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/image-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# 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.30 300 API credits your files are measured before the run Run it on this page

Get API key
Tripo Image to 3D #3d#image-to-3d#3d-generation#tripo

Single-image 3D generation with PBR materials, quad meshes and face-count control

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 image_url
Drop a file, or

Input-image URL used to create a 3D model.

texture_quality default standard

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

geometry_quality default standard

Quality setting for the geometry.

Advanced texture_alignment · orientation · face_limit · model_seed · texture_seed · auto_size · enable_safety_checker
texture_alignment default original_image

Texture alignment reference: use 'geometry' for the generated geometry or 'original_image' for the input image.

orientation default default

Orientation of the model; 'align_image' rotates it automatically to match the input image.

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 to make texture generation reproducible.

POST /run/tripo3d/h3.1/image-to-3d?wait=20 quote → $0.30
# 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/image-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# 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 Image to 3D

Builds a 3D model from one image at `image_url`. Options include `face_limit` (1,000 to 2,000,000), `texture`, `pbr`, standard or detailed `texture_quality` and `geometry_quality`, `quad` topology, `auto_size` and `orientation`. The result includes a preview render and a task ID for later rigging.

Parameters

Send either the canonical name or the native name, not both. Canonical names

NameType DefaultAllowed Description
image_urlrequired image
Typeurl · image
Input-image URL used to create a 3D 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.
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.
texture_alignmentoptional
Typeenum
Defaultoriginal_image
original_imagegeometry
Texture alignment reference: use 'geometry' for the generated geometry or 'original_image' for the input image.
auto_sizeoptional
Typeboolean
Defaultfalse
Automatic scaling to give the model real-world dimensions measured in meters.
orientationoptional
Typeenum
Defaultdefault
defaultalign_image
Orientation of the model; 'align_image' rotates it automatically to match the input image.
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 Canonical name, also accepted

File parameters take a public https:// URL, a data: URI up to 10 MB, or the file_url of an upload. Files

Output

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "tripo3d/h3.1/image-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": 300,
    "usd": "0.30",
    "charged": 300,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "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: Image to 3D

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