Trellis/PiAPI-Get Task

Request

Path Params

task_id

string

required

Header Params

x-api-key

string

required

Your API key for authorization

Request samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

Responses

🟢200Success

application/json

Body

code

integer

required

data

object

required

task_id

string

required

model

string

required

task_type

string

required

status

enum<string>

required

Hover on the "Completed" option and you coult see the explaintion of all status: completed/processing/pending/failed/staged

Allowed values:

CompletedProcessingPendingFailedStaged

input

object

required

output

object

required

meta

object

required

detail

null

required

logs

array [object]

required

error

object

required

message

string

required

If you get non-null error message, here are some steps you chould follow:

Check our common error message

Retry for several times

If you have retried for more than 3 times and still not work, file a ticket on Discord and our support will be with you soon.

Example

{
  "code": 200,
  "data": {
    "task_id": "858c981e-9fbc-4d66-9305-16e3100b1e2b",
    "model": "Qubico/trellis",
    "task_type": "image-to-3d",
    "status": "pending",
    "config": {
      "service_mode": "",
      "webhook_config": {
        "endpoint": "",
        "secret": ""
      }
    },
    "input": {
      "image": "https://static.flomoapp.com/file/2024-10-13/895452/1728800202.451645_xYWPucOx.jpg?OSSAccessKeyId=LTAI5tAXfrgN5cBQ7Bym1EcM&Expires=1742648337&Signature=wDuQPlO4VwL2BFtGAkhZU44%2BkFU%3D",
      "ss_sampling_steps": 50,
      "slat_sampling_steps": 50,
      "ss_guidance_strength": 7.5,
      "slat_guidance_strength": 3,
      "seed": 0
    },
    "output": null,
    "meta": {
      "created_at": "2025-03-19T13:00:12.364098449Z",
      "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"
}