tripo3d

Tripo3D AI 3D Generation Skill

Overview

Tripo3D is a leading AI 3D generation platform. This skill handles:

Setup

Requires TRIPO3D_API_KEY environment variable.

Get your API key at: https://platform.tripo3d.ai

Proxy Configuration (Windows + Clash Verge)

Clash Verge (verge-mihomo) proxy port: 7897 — not 7890.

Use PowerShell for all API calls:

Invoke-RestMethod -Uri '...' -Proxy 'http://127.0.0.1:7897' -ProxyUseDefaultCredentials

For file downloads, use .NET WebClient:

$wc = New-Object System.Net.WebClient
$wc.Proxy = New-Object System.Net.WebProxy("http://127.0.0.1:7897")
$wc.Proxy.Credentials = [System.Net.CredentialCache]::DefaultCredentials
$wc.DownloadFile($url, $outPath)

Python SDK (aiohttp) does NOT respect system proxy — use PowerShell instead.

Base URL

https://api.tripo3d.ai/v2/openapi

All requests require header:

Authorization: Bearer 
Content-Type: application/json

Core Endpoints

| Action | Method | Path | |--------|--------|------| | Create task | POST | /task | | Check status | GET | /task/{task_id} | | Upload image (STS) | POST | /upload/sts | | Get balance | GET | /user/balance |

Task Types

All generation uses POST /task with different type field values:

| Type | Description | |------|-------------| | text_to_model | Text prompt → 3D model | | image_to_model | Single image → 3D model | | multiview_to_model | 4 images (front/left/back/right) → 3D model | | refine_model | Refine an existing draft model |

Workflow 1: Text to 3D

Step 1 — Create task

POST /v2/openapi/task

{
  "type": "text_to_model",
  "prompt": "a fierce tiger with orange and black stripes"
}

Step 2 — Poll status

GET /v2/openapi/task/{task_id}

Step 3 — Download model From response: data.output.pbr_model.url

Workflow 2: Image to 3D

Step 1 — Upload image (STS)

POST /v2/openapi/upload/sts
Content-Type: multipart/form-data

Response:

{ "code": 0, "data": { "image_token": "uuid-xxx" } }

Step 2 — Create image-to-3D task

POST /v2/openapi/task

{
  "type": "image_to_model",
  "file": {
    "type": "jpg",
    "file_token": ""
  }
}

Or use image URL directly (no upload needed):

{
  "type": "image_to_model",
  "file": {
    "type": "jpg",
    "url": "https://example.com/photo.jpg"
  }
}

Step 3 — Poll status (same as Text-to-3D)

Step 4 — Download model

Workflow 3: Multiview to 3D

Upload 4 images (front, left, back, right), then:

POST /v2/openapi/task

{
  "type": "multiview_to_model",
  "files": [
    { "type": "jpg", "file_token": "" },
    { "type": "jpg", "file_token": "" },
    { "type": "jpg", "file_token": "" },
    { "type": "jpg", "file_token": "" }
  ]
}

Workflow 4: Refine Model

POST /v2/openapi/task

{
  "type": "refine_model",
  "draft_model_task_id": ""
}

Common Parameters

| Parameter | Applies to | Description | |-----------|-----------|-------------| | model_version | all | Version: P1-20260311, Turbo-v1.0-20250506, v3.1-20260211, v3.0-20250812, v2.5-20250123 (default), v2.0-20240919, v1.4-20240625 | | texture | all | Enable texture, default true | | pbr | all | Enable PBR, default true | | texture_quality | all | "detailed" or "standard" (default) | | face_limit | all | Limit polygon count (1000~20000) | | quad | text/image | true → FBX output (not GLB) | | compress | all | "geometry" for compressed output | | auto_size | all | Scale to real-world meters | | texture_alignment | image/multiview | "original_image" or "geometry" | | model_seed | all | Integer, reproducible generation | | texture_seed | all | Integer, reproducible texture | | enable_image_autofix | image/multiview | Auto-enhance input image | | generate_parts | text/image | Segmentation mode |

P1-20260311 (Low-poly optimized)

Polling Logic

⚠️ Generation is asynchronous. Poll every 5–10 seconds.

Status values:

Never block with sleep. Submit job, reply with task_id, poll only when user asks.

Download

Model URLs expire after ~5 minutes. Download immediately after success.

Use .NET WebClient (PowerShell):

$wc = New-Object System.Net.WebClient
$wc.Proxy = New-Object System.Net.WebProxy("http://127.0.0.1:7897")
$wc.Proxy.Credentials = [System.Net.CredentialCache]::DefaultCredentials
$wc.DownloadFile($modelUrl, $outPath)

Output files from data.output:

Cost

| Task | Credits | |------|---------| | Text-to-3D | ~20 | | Image-to-3D | ~20 | | Multiview-to-3D | ~20 | | Refine Model | ~20 |

Check balance: GET /v2/openapi/user/balance

Error Handling

| Code | Meaning | |------|---------| | 2010 | Insufficient credit | | 2001 | Task not found (wrong task_id or API key mismatch) | | 2002 | Unsupported task type | | 2003 | Empty input file | | 2004 | Unsupported file type | | 429 2000 | Rate limited — retry later |

Windows PowerShell Upload Example

$headers = @{
  'Authorization' = 'Bearer '
}
$filePath = "C:/path/to/image.jpg"
$response = Invoke-RestMethod -Uri 'https://api.tripo3d.ai/v2/openapi/upload/sts' 
  -Method POST 
  -Headers $headers 
  -ContentType 'multipart/form-data' 
  -Proxy 'http://127.0.0.1:7897' 
  -ProxyUseDefaultCredentials 
  -Body @{
    file = Get-Item $filePath
  }
$imageToken = $response.data.image_token

Requires TRIPO3D_API_KEY environment variable.

Get your API key at: https://platform.tripo3d.ai

Proxy Configuration (Windows + Clash Verge)

Clash Verge (verge-mihomo) proxy port: 7897 — not 7890.

Use PowerShell for all API calls:

Invoke-RestMethod -Uri '...' -Proxy 'http://127.0.0.1:7897' -ProxyUseDefaultCredentials

For file downloads, use .NET WebClient:

$wc = New-Object System.Net.WebClient
$wc.Proxy = New-Object System.Net.WebProxy("http://127.0.0.1:7897")
$wc.Proxy.Credentials = [System.Net.CredentialCache]::DefaultCredentials
$wc.DownloadFile($url, $outPath)

Python SDK (aiohttp) does NOT respect system proxy — use PowerShell instead.