Tripo3D H3.1 Image to 3D

curl --request POST \
  --url https://api.vidgo.ai/api/generate/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "tripo3d/h3.1/image-to-3d",
  "input": {
    "image_urls": [
      "https://example.com/image.png"
    ],
    "texture": true,
    "texture_quality": "standard",
    "geometry_quality": "standard",
    "quad": false
  }
}
'

{
  "code": 200,
  "data": {
    "task_id": "task-unified-example",
    "status": "running",
    "created_time": "2026-09-10T08:00:00"
  }
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

Request timeout

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

Convert a reference image into a 3D model with Tripo3D H3.1, with controls for geometry detail, textures, and mesh topology.

​

Models

• tripo3d/h3.1/image-to-3d - Generate a 3D model from an image.

​

Features

• Generate a 3D model from an image.
• Accepts exactly 1 image in image_urls.
• Retrieve model assets and available previews or supporting files from the task result.

​

Output Options

​

Face Limit

• face_limit: Optional. Set the face-count limit. Integer from 1000 to 2000000.

​

Geometry Quality

• geometry_quality: Optional. Accepted values: standard, detailed. Default: standard.

​

Advanced Parameters

Set model and optional callback_url at the request root. Place all workflow parameters, including output options, inside input. Use the input parameters listed below for this generation workflow. Use publicly accessible HTTP(S) image URLs with a hostname.

​

Image URLs

• image_urls: Required. Provide publicly accessible image URLs. Supply exactly 1 item. Each item must be an HTTP(S) URL.

​

Texture

• texture: Optional. Control texture generation. Use true or false. Default: true.

​

PBR

• pbr: Optional. Generate physically based rendering (PBR) materials when texture is true. Use true or false.

​

Model Seed

• model_seed: Optional. Set the model-generation seed. Integer.

​

Texture Seed

• texture_seed: Optional. Set the texture-generation seed. Integer.

​

Texture Quality

• texture_quality: Optional. Accepted values: standard, detailed. Default: standard.

​

Auto Size

• auto_size: Optional. Control automatic model sizing. Use true or false.

​

Quad

• quad: Optional. Request quad topology. Use true or false. Default: false.

​

Output Files

• Read every item in the returned files array.
• Model assets use file_type: "3d"; previews use file_type: "image".
• Additional artifacts may use file_type: "other". Retain accompanying assets and available label, format, content_type, file_name, and file_size metadata.