# Trellis 2 API via PiAPI

Base URL: https://api.piapi.ai
Auth: X-API-KEY header (get your key at https://piapi.ai/workspace/key)

Documentation: https://piapi.ai/docs/trellis2-api/create-task
Project page: https://microsoft.github.io/TRELLIS.2/
Technical report: https://arxiv.org/abs/2512.14692

## What it is

Trellis.2 is Microsoft Research's state-of-the-art image-to-3D generation
model: a 4B-parameter architecture producing up to 1536^3 PBR textured 3D
assets, built on native 3D VAEs with 16x spatial compression. It handles
arbitrary topology — open surfaces, non-manifold geometry, and enclosed
interior structures. Generated assets are licensed for commercial use.

## Model & Pricing

- model: Qubico/trellis2, task_type: image-to-3d — $0.10 per generation.
  Pay only for successful generations; new PiAPI accounts get free credits.

## Generate a 3D Asset from an Image

POST /api/v1/task
{
  "model": "Qubico/trellis2",
  "task_type": "image-to-3d",
  "input": {
    "image": "https://example.com/input.png",
    "seed": 0
  }
}

input.image: URL or base64 string (required, less than 2048*2048 pixels).
seed: optional integer 0-2147483647, default 0 (0 = randomized).
Optional webhook: config.webhook_config.endpoint + secret
(https://piapi.ai/docs/unified-webhook).

## Get Task Result

GET /api/v1/task/{task_id}

Status: "pending" -> "processing" -> "completed" or "failed"
Result: the generated 3D asset (GLB mesh with PBR textures) in
response.data.output. Tasks are asynchronous — use polling or webhooks.

## Related

- Trellis (text-to-3D + image-to-3D, $0.04/generation): https://piapi.ai/trellis-3d-api
- Interactive playground: https://piapi.ai/trellis-2-playground

## Quick Start

1. Get API key: https://piapi.ai/workspace/key
2. Top up: https://piapi.ai/workspace/billing
3. POST /api/v1/task with model Qubico/trellis2 + your image URL
4. Poll GET /api/v1/task/{task_id} until "completed"
5. Download the GLB asset from the task output