Tripo 3D Image - Generate 3D Model (AI Model · By )

API Documentation

API Reference

3D Generation

Generate 3D Model

Supported Model Code

Loading models...

Tripo 3D Image (image_to_model)

image_to_model0 models support this endpoint

Tripo's Image to Model transforms any single image — a photo, sketch, illustration, or concept art — into a high-quality 3D model in seconds. Its AI analyzes the structure, surface detail, and depth of your image to reconstruct accurate geometry, rich textures, and realistic proportions with high fidelity to the source, preserving form and detail through strong input alignment and structural precision. The result is a production-ready asset with industry-leading textures and clean topology that you can further texture, rig, animate, or split into parts, and export in GLB, OBJ, FBX, STL, and more.

Create a 3D generation task (text/image/multiview to 3D). The "type" field selects the model and request shape; parameters vary per model.

https://api.modelstream.ai

POST/tripo/v2/openapi/task

Authentication

BearerAuth

AuthenticationBearer <token>

All API requests must be authenticated using a Bearer token in the Authorization header. Please ensure your API key is active.Authorization: Bearer sk-xxxxxx

Parameter Location: Header Param

Request Body

application/json

These parameters come from the selected model form_schema. Switching models updates this list and the request example.

Model Version

Tripo model version. Defaults to the latest.

texture?boolean

Whether to generate surface texture. Off outputs an untextured mesh.

Example Value: true

pbr?boolean

Whether to generate PBR (metalness/roughness) material. Requires texture on.

Example Value: true

texture_quality?string

Texture detail level. Detailed is sharper but slower and costs more.

Example Value: standard

Enum/Options:

Standard: standardDetailed: detailed

geometry_quality?string

Geometry detail level. Ultra produces a higher-detail mesh (V3.0/V3.1 only, ~+20 credits).

Example Value: standard

Enum/Options:

Standard: standardUltra (Detailed): detailed

face_limit?number

Cap the output mesh polygon count. Leave empty to let the model decide.

Placeholder: Leave empty for autoValue Range: 1000 ≤ value ≤ 500000

quad?boolean

Output quad topology, better for editing/animation. Adds a small cost.

Example Value: false

auto_size?boolean

Automatically scale the model to real-world dimensions.

Example Value: false

Response Parameters

application/json

200apiDocs.responses.successCreateTripoTask

code?integer

data?object

task_id?string

System task id; poll it via GET /tripo/v2/openapi/task/{task_id}.

400apiDocs.responses.badRequestParams

error?object

Parameter description for Error

message?string

Error Message

type?string

Error Type

param?string

Related Parameters

code?string

Error Code

curl -X POST "https://api.modelstream.ai/tripo/v2/openapi/task" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "image_to_model"
}'

{
  "code": 0,
  "data": {
    "task_id": "string"
  }
}

API Documentation

API Reference

3D Generation

Generate 3D Model

Supported Model Code

Loading models...

Tripo 3D Image (image_to_model)

image_to_model0 models support this endpoint

Create a 3D generation task (text/image/multiview to 3D). The "type" field selects the model and request shape; parameters vary per model.

https://api.modelstream.ai

POST/tripo/v2/openapi/task

Authentication

BearerAuth

AuthenticationBearer <token>

All API requests must be authenticated using a Bearer token in the Authorization header. Please ensure your API key is active.Authorization: Bearer sk-xxxxxx

Parameter Location: Header Param

Request Body

application/json

These parameters come from the selected model form_schema. Switching models updates this list and the request example.

Model Version

Tripo model version. Defaults to the latest.

texture?boolean

Whether to generate surface texture. Off outputs an untextured mesh.

Example Value: true

pbr?boolean

Whether to generate PBR (metalness/roughness) material. Requires texture on.

Example Value: true

texture_quality?string

Texture detail level. Detailed is sharper but slower and costs more.

Example Value: standard

Enum/Options:

Standard: standardDetailed: detailed

geometry_quality?string

Geometry detail level. Ultra produces a higher-detail mesh (V3.0/V3.1 only, ~+20 credits).

Example Value: standard

Enum/Options:

Standard: standardUltra (Detailed): detailed

face_limit?number

Cap the output mesh polygon count. Leave empty to let the model decide.

Placeholder: Leave empty for autoValue Range: 1000 ≤ value ≤ 500000

quad?boolean

Output quad topology, better for editing/animation. Adds a small cost.

Example Value: false

auto_size?boolean

Automatically scale the model to real-world dimensions.

Example Value: false

Response Parameters

application/json

200apiDocs.responses.successCreateTripoTask

code?integer

data?object

task_id?string

System task id; poll it via GET /tripo/v2/openapi/task/{task_id}.

400apiDocs.responses.badRequestParams

error?object

Parameter description for Error

message?string

Error Message

type?string

Error Type

param?string

Related Parameters

code?string

Error Code

curl -X POST "https://api.modelstream.ai/tripo/v2/openapi/task" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "image_to_model"
}'

{
  "code": 0,
  "data": {
    "task_id": "string"
  }
}