Import Model — Tripo Developers

http

Base URL: https://openapi.tripo3d.com/v3

Endpoint: POST /models/import

Import an external 3D model file into the Tripo platform for downstream processing.

Note

This endpoint requires an API Key. Include it in the Authorization header as Bearer {api_key}. Example identifiers are illustrative; replace them with values returned by your requests.
This is an asynchronous API. After submitting the request, use the Task Query API to poll for results, or configure a Webhook to receive automatic notifications when the task completes.

Request Parameters

Request Body

inputstringRequired

Model file source. Accepts file_token (prefix file_) or a URL.

Notes

Formats: GLB, GLTF, FBX, OBJ, STL
Max file size: 150 MB

Response

model_urlstringRequired

Imported model download URL.

rendered_image_urlstring

Rendered preview image URL.

normalize_scalenumber

Uniform scale factor applied when the imported model was normalized: normalized size = original size × normalize_scale. 1.0 means the model was not scaled, though it may still have been translated. Divide the normalized size by this factor to recover the original size; the platform's output keeps the normalized result.
Returned by Import Model and by model post-processing tasks (rig, texture, convert, etc.) whose model input is a file_token or URL (they import the model first); not returned for task_id input or for tasks created before this field was added.

normalize_translationnumber[]

Translation vector applied when the imported model was normalized, as [tx, ty, tz] (3 numbers). Use it together with normalize_scale:

normalized coordinate = original coordinate × normalize_scale + normalize_translation
original coordinate = (normalized coordinate - normalize_translation) / normalize_scale

Returned only when the import pipeline provides it, by the same tasks as normalize_scale; not returned for task_id input or for tasks created before this field was added.

Examples

From file

{
  "input": "file_abc123"}

From URL

{
  "input": "https://example.com/my-model.glb"}

Create task

{
  "code": 0,
  "data": {
    "task_id": "123e4567-e89b-42d3-a456-426614174000"}
}

Task result

{
  "code": 0,
  "data": {
    "task_id": "123e4567-e89b-42d3-a456-426614174000",
    "type": "import_model",
    "status": "success",
    "progress": 100,
    "output": {
      "model_url": "https://cdn.tripo3d.ai/output/tripo_input.glb",
      "rendered_image_url": "https://cdn.tripo3d.ai/output/preview.webp",
      "normalize_scale": 0.365714,
      "normalize_translation": [
        -1,
        -0.5,
        -1.5
      ]
    },
    "created_at": "2026-04-28T12:00:00Z",
    "completed_at": "2026-04-28T12:00:02Z"}
}

Import Model

curl --request POST \
  --url https://openapi.tripo3d.com/v3/models/import \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "input": "file_abc123"}'

200Response

{
  "code": 0,
  "data": {
    "task_id": "123e4567-e89b-42d3-a456-426614174000"}
}