Tripo 开发者平台

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}.
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

Examples

From file

{
  "input": "file_abc123"}

From URL

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

Create task

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

Task result

{
  "code": 0,
  "data": {
    "task_id": "task_abc123",
    "type": "text_to_model",
    "status": "success",
    "progress": 100,
    "output": {
      "model_url": "https://cdn.tripo3d.ai/output/model_pbr.glb",
      "rendered_image_url": "https://cdn.tripo3d.ai/output/preview.png"},
    "credits_consumed": 100,
    "created_at": "2026-04-28T12:00:00Z",
    "completed_at": "2026-04-28T12:01:30Z"}
}

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": "task_abc123"}
}