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

API Documentation

API Reference

3D Generation

Generate 3D Model

Supported Model Code

Loading models...

Tripo 3D Text (text_to_model)

text_to_model0 models support this endpoint

Tripo's Text to Model turns a simple written description into a complete, high-quality 3D model in seconds. Just describe what you want to see — "a wooden chair," "a sci-fi helmet," "a cartoon cat with wings" — and Tripo's large vision-language models interpret the objects, structure, and context of your prompt to build a fully formed mesh with sharp geometry and clean topology. Supporting both short phrases and detailed descriptions, it produces production-ready assets you can further refine with textures, rigging, animation, or part segmentation, and export in GLB, OBJ, FBX, STL, and more for games, design, and 3D-printing workflows.

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": "text_to_model"
}'

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

API Documentation

API Reference

3D Generation

Generate 3D Model

Supported Model Code

Loading models...

Tripo 3D Text (text_to_model)

text_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": "text_to_model"
}'

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