Create Task

POST

https://api.piapi.ai/api/v1/task

INFO

Trellis 3D API

The Create Task Endpoint for Trellis 3D Model Generation!

We've supported task_types including text-to-3D and image-to-3D to fit users' need better.

Deploying the official Trellis3D project from Microsoft Research

$0.04 per generation

Request

Header Params

Body Params application/json

Examples

text-to-3dimage-to-3d

{
    "model": "Qubico/trellis",
    "task_type": "text-to-3d",
    "input": {
        "prompt": "a bear",
        "ss_sampling_steps": 7,
        "slat_sampling_steps": 7,
        "ss_guidance_strength": 7.5,
        "slat_guidance_strength": 3
    },
    "config": {
        "webhook_config": {
            "endpoint": "https://webhook.site/3101de1a-6e2e-451c-8538-efd5875888d7",
            "secret": ""
        }
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

text-to-3dimage-to-3d

curl --location --request POST 'https://api.piapi.ai/api/v1/task' \
--header 'x-api-key;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "Qubico/trellis",
    "task_type": "text-to-3d",
    "input": {
        "prompt": "a bear",
        "ss_sampling_steps": 7,
        "slat_sampling_steps": 7,
        "ss_guidance_strength": 7.5,
        "slat_guidance_strength": 3
    },
    "config": {
        "webhook_config": {
            "endpoint": "https://webhook.site/3101de1a-6e2e-451c-8538-efd5875888d7",
            "secret": ""
        }
    }
}'

Responses

🟢200Success

application/json

Body

Examples

text-to-3dimage-to-3d

{
    "code": 200,
    "data": {
        "task_id": "97cb9075-dca9-4c15-ad94-a333ae96d1de",
        "model": "Qubico/trellis",
        "task_type": "text-to-3d",
        "status": "pending",
        "config": {
            "service_mode": "",
            "webhook_config": {
                "endpoint": "https://webhook.site/3101de1a-6e2e-451c-8538-efd5875888d7",
                "secret": ""
            }
        },
        "input": {
            "prompt": "a bear",
            "image": "",
            "images": null,
            "ss_sampling_steps": 7,
            "slat_sampling_steps": 7,
            "ss_guidance_strength": 7.5,
            "slat_guidance_strength": 3,
            "seed": 0
        },
        "output": null,
        "meta": {
            "created_at": "2025-11-26T08:17:30.677144106Z",
            "started_at": "0001-01-01T00:00:00Z",
            "ended_at": "0001-01-01T00:00:00Z",
            "usage": {
                "type": "llm",
                "frozen": 0,
                "consume": 400000
            },
            "is_using_private_pool": false
        },
        "detail": null,
        "logs": [],
        "error": {
            "code": 0,
            "raw_message": "",
            "message": "",
            "detail": null
        }
    },
    "message": "success"
}

Modified at 2025-11-26 09:08:37

Get Task

Create Task

Trellis 3D API#

Request

Request Code Samples

Responses

Trellis 3D API