---
title: "TRELLIS 2"
method: POST
path: "/generate/3d/microsoft/trellis-2"
tags: ["3D"]
---

# TRELLIS 2

`POST /generate/3d/microsoft/trellis-2`

Native 3D generative model for high-quality 3D asset creation

## Headers

- `X-Webhook-URL` string, uri

## Request body

- object
  - `prompt` string
  - `seed` number
  - `input_mode` 'image' | 'text'
  - `generate_texture` boolean
  - `resolution` '512' | '1024' | '1536'
  - `texture_size` '1024' | '2048' | '4096'
  - `decimation_target` number
  - `image_urls` string[] — Input image URLs for image-to-3D generation. Omit or pass an empty array for text-to-3D.

## Response `200`

The resulting job data. This will be returned in a pending state until the job is completed. See [`/jobs/{id}`](#tag/default/get/jobs/{id}) for retrieving the results.

- object
  - `job_id` string, uuid, required
  - `status` 'backlogged' | 'queued' | 'scheduled' | 'processing' | 'sampling' | 'intermediate-complete' | 'completed' | 'failed' | 'cancelled', required
  - `created_at` string, date-time, required
  - `completed_at` unknown, required
  - `result` unknown, required
  - `error` object
    - `code` string, required
    - `message` string

## Other responses

- `400` — The request body is invalid.
- `401` — You are not authenticated.
- `402` — You have run out of credits.
- `429` — You have reached the maximum number of concurrent jobs.

---

[API](https://skmtc.net/krea/apis/krea-api.md) · [All operations](https://skmtc.net/krea/apis/krea-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/krea/krea-api/versions/5654aa0aa524/schema)