Qubico
  1. Trellis
Qubico
  • Get Started
    • Overview
    • Quickstart
  • Endpoints
    • Flux
      • Flux with LoRA and Controlnet
      • Available LoRA and Controlnet
      • Flux API with Redux Variation, Fill, Inpaint and Outpaint
      • Create Task
        • Kontext
        • Text to Image
        • Image to Image
      • Get task
    • AI Hug
      • Get Task
      • Create Task
    • Trellis
      • Create Task
        POST
      • Get Task
        GET
    • WanX
      • Generate WanX Task with LoRA Using Qubico
      • Available LoRA Types for Wanx
      • Use Cases for Wanx LoRA
      • Use Cases for Wanx Control Camera
      • Create Task
      • Get Task
    • Skyreels
      • Create Task
      • Get Task
    • Qwen Image
      • Text to Image
      • Image Edit
      • Get Task
    • Framepack
      • Create Task
      • Get Task
    • Hunyuan Video
      • How to Make a Hunyuan API Call
      • Get Task
      • Generate Video
    • Tools
      • Video Upscale
      • Video Upscale-Get Task
      • Remove Background API
      • Remove Background-Get Task
      • Segment With Prompt API
      • Segment With Prompt API-Get Task
      • Image Upscale(Super Resolution) API
      • Image Upscale-Get Task
    • Account Management
      • Account Info
      • Task List Info
      • User Task History
  • Resources
    • Change Log
    • Output Storage
    • Unified API Schema
    • Webhook
  1. Trellis

Create Task

POST
/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

Responses

🟒200Success
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/api/v1/task' \
--header 'x-api-key;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "Qubico/trellis",
    "task_type": "text-to-3d",
    "input": {
        "prompt": "string",
        "ss_sampling_steps": 0,
        "slat_sampling_steps": 0,
        "ss_guidance_strength": 0,
        "slat_guidance_strength": 0,
        "seed": 0
    },
    "config": {
        "webhook_config": {
            "endpoint": "string",
            "secret": "string"
        }
    }
}'
Response Response Example
{
    "completed_at": "2024-12-11T12:50:29.319432+00:00",
    "created_at": null,
    "error": null,
    "id": null,
    "input": {
        "generate_color": true,
        "generate_model": true,
        "generate_normal": true,
        "image": "https://i.ibb.co/NY6W1r6/trellis.png",
        "mesh_simplify": 0.9,
        "randomize_seed": true,
        "seed": 0,
        "slat_guidance_strength": 3,
        "slat_sampling_steps": 50,
        "ss_guidance_strength": 7.5,
        "ss_sampling_steps": 50,
        "texture_size": 1024
    },
    "logs": "INFO:predict:Loading and preprocessing input image...\nINFO:predict:Saved image without background\nINFO:predict:Using randomized seed: 996765520\nINFO:predict:Running TRELLIS pipeline...\nSampling:   0%|          | 0/50 [00:00<?, ?it/s]\nSampling:   2%|▏         | 1/50 [00:00<00:09,  5.43it/s]\nSampling:   4%|▍         | 2/50 [00:00<00:10,  4.79it/s]\nSampling:   6%|β–Œ         | 3/50 [00:00<00:10,  4.67it/s]\nSampling:   8%|β–Š         | 4/50 [00:00<00:09,  4.60it/s]\nSampling:  10%|β–ˆ         | 5/50 [00:01<00:09,  4.57it/s]\nSampling:  12%|β–ˆβ–        | 6/50 [00:01<00:09,  4.54it/s]\nSampling:  14%|β–ˆβ–        | 7/50 [00:01<00:09,  4.53it/s]\nSampling:  16%|β–ˆβ–Œ        | 8/50 [00:01<00:09,  4.52it/s]\nSampling:  18%|β–ˆβ–Š        | 9/50 [00:01<00:09,  4.52it/s]\nSampling:  20%|β–ˆβ–ˆ        | 10/50 [00:02<00:08,  4.51it/s]\nSampling:  22%|β–ˆβ–ˆβ–       | 11/50 [00:02<00:08,  4.49it/s]\nSampling:  24%|β–ˆβ–ˆβ–       | 12/50 [00:02<00:08,  4.49it/s]\nSampling:  26%|β–ˆβ–ˆβ–Œ       | 13/50 [00:02<00:08,  4.49it/s]\nSampling:  28%|β–ˆβ–ˆβ–Š       | 14/50 [00:03<00:08,  4.49it/s]\nSampling:  30%|β–ˆβ–ˆβ–ˆ       | 15/50 [00:03<00:07,  4.48it/s]\nSampling:  32%|β–ˆβ–ˆβ–ˆβ–      | 16/50 [00:03<00:07,  4.48it/s]\nSampling:  34%|β–ˆβ–ˆβ–ˆβ–      | 17/50 [00:03<00:07,  4.49it/s]\nSampling:  36%|β–ˆβ–ˆβ–ˆβ–Œ      | 18/50 [00:03<00:07,  4.48it/s]\nSampling:  38%|β–ˆβ–ˆβ–ˆβ–Š      | 19/50 [00:04<00:06,  4.48it/s]\nSampling:  40%|β–ˆβ–ˆβ–ˆβ–ˆ      | 20/50 [00:04<00:06,  4.48it/s]\nSampling:  42%|β–ˆβ–ˆβ–ˆβ–ˆβ–     | 21/50 [00:04<00:06,  4.49it/s]\nSampling:  44%|β–ˆβ–ˆβ–ˆβ–ˆβ–     | 22/50 [00:04<00:06,  4.48it/s]\nSampling:  46%|β–ˆβ–ˆβ–ˆβ–ˆβ–Œ     | 23/50 [00:05<00:06,  4.48it/s]\nSampling:  48%|β–ˆβ–ˆβ–ˆβ–ˆβ–Š     | 24/50 [00:05<00:05,  4.48it/s]\nSampling:  50%|β–ˆβ–ˆβ–ˆβ–ˆβ–ˆ     | 25/50 [00:05<00:05,  4.48it/s]\nSampling:  52%|β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–    | 26/50 [00:05<00:05,  4.48it/s]\nSampling:  54%|β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–    | 27/50 [00:05<00:05,  4.48it/s]\nSampling:  56%|β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–Œ    | 28/50 [00:06<00:04,  4.48it/s]\nSampling:  58%|β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–Š    | 29/50 [00:06<00:04,  4.48it/s]\nSampling:  60%|β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆ    | 30/50 [00:06<00:04,  4.48it/s]\nSampling:  62%|β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–   | 31/50 [00:06<00:04,  4.48it/s]\nSampling:  64%|β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–   | 32/50 [00:07<00:04,  4.48it/s]\nSampling:  66%|β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–Œ   | 33/50 [00:07<00:03,  4.47it/s]\nSampling:  68%|β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–Š   | 34/50 [00:07<00:03,  4.47it/s]\nSampling:  70%|β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆ   | 35/50 [00:07<00:03,  4.47it/s]\nSampling:  72%|β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–  | 36/50 [00:07<00:03,  4.47it/s]\nSampling:  74%|β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–  | 37/50 [00:08<00:02,  4.47it/s]\nSampling:  76%|β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–Œ  | 38/50 [00:08<00:02,  4.47it/s]\nSampling:  78%|β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–Š  | 39/50 [00:08<00:02,  5.26it/s]\nSampling:  80%|β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆ  | 40/50 [00:08<00:01,  6.01it/s]\nSampling:  82%|β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ– | 41/50 [00:08<00:01,  6.66it/s]\nSampling:  84%|β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ– | 42/50 [00:08<00:01,  7.21it/s]\nSampling:  86%|β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–Œ | 43/50 [00:08<00:00,  7.66it/s]\nSampling:  88%|β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–Š | 44/50 [00:09<00:00,  8.00it/s]\nSampling:  90%|β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆ | 45/50 [00:09<00:00,  8.27it/s]\nSampling:  92%|β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–| 46/50 [00:09<00:00,  8.46it/s]\nSampling:  94%|β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–| 47/50 [00:09<00:00,  8.59it/s]\nSampling:  96%|β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–Œ| 48/50 [00:09<00:00,  8.71it/s]\nSampling:  98%|β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–Š| 49/50 [00:09<00:00,  8.78it/s]\nSampling: 100%|β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆ| 50/50 [00:09<00:00,  8.82it/s]\nSampling: 100%|β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆ| 50/50 [00:09<00:00,  5.11it/s]\nSampling:   0%|          | 0/50 [00:00<?, ?it/s]\nSampling:   2%|▏         | 1/50 [00:02<02:26,  2.99s/it]\nSampling:   4%|▍         | 2/50 [00:03<01:07,  1.41s/it]\nSampling:   6%|β–Œ         | 3/50 [00:03<00:42,  1.11it/s]\nSampling:   8%|β–Š         | 4/50 [00:03<00:30,  1.50it/s]\nSampling:  10%|β–ˆ         | 5/50 [00:04<00:24,  1.87it/s]\nSampling:  12%|β–ˆβ–        | 6/50 [00:04<00:20,  2.19it/s]\nSampling:  14%|β–ˆβ–        | 7/50 [00:04<00:17,  2.46it/s]\nSampling:  16%|β–ˆβ–Œ        | 8/50 [00:05<00:15,  2.68it/s]\nSampling:  18%|β–ˆβ–Š        | 9/50 [00:05<00:14,  2.84it/s]\nSampling:  20%|β–ˆβ–ˆ        | 10/50 [00:05<00:13,  2.97it/s]\nSampling:  22%|β–ˆβ–ˆβ–       | 11/50 [00:06<00:12,  3.06it/s]\nSampling:  24%|β–ˆβ–ˆβ–       | 12/50 [00:06<00:12,  3.13it/s]\nSampling:  26%|β–ˆβ–ˆβ–Œ       | 13/50 [00:06<00:11,  3.18it/s]\nSampling:  28%|β–ˆβ–ˆβ–Š       | 14/50 [00:06<00:11,  3.21it/s]\nSampling:  30%|β–ˆβ–ˆβ–ˆ       | 15/50 [00:07<00:10,  3.24it/s]\nSampling:  32%|β–ˆβ–ˆβ–ˆβ–      | 16/50 [00:07<00:10,  3.26it/s]\nSampling:  34%|β–ˆβ–ˆβ–ˆβ–      | 17/50 [00:07<00:10,  3.27it/s]\nSampling:  36%|β–ˆβ–ˆβ–ˆβ–Œ      | 18/50 [00:08<00:09,  3.28it/s]\nSampling:  38%|β–ˆβ–ˆβ–ˆβ–Š      | 19/50 [00:08<00:09,  3.28it/s]\nSampling:  40%|β–ˆβ–ˆβ–ˆβ–ˆ      | 20/50 [00:08<00:09,  3.29it/s]\nSampling:  42%|β–ˆβ–ˆβ–ˆβ–ˆβ–     | 21/50 [00:09<00:08,  3.29it/s]\nSampling:  44%|β–ˆβ–ˆβ–ˆβ–ˆβ–     | 22/50 [00:09<00:08,  3.29it/s]\nSampling:  46%|β–ˆβ–ˆβ–ˆβ–ˆβ–Œ     | 23/50 [00:09<00:08,  3.29it/s]\nSampling:  48%|β–ˆβ–ˆβ–ˆβ–ˆβ–Š     | 24/50 [00:09<00:07,  3.30it/s]\nSampling:  50%|β–ˆβ–ˆβ–ˆβ–ˆβ–ˆ     | 25/50 [00:10<00:07,  3.30it/s]\nSampling:  52%|β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–    | 26/50 [00:10<00:07,  3.29it/s]\nSampling:  54%|β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–    | 27/50 [00:10<00:06,  3.29it/s]\nSampling:  56%|β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–Œ    | 28/50 [00:11<00:06,  3.29it/s]\nSampling:  58%|β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–Š    | 29/50 [00:11<00:06,  3.29it/s]\nSampling:  60%|β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆ    | 30/50 [00:11<00:06,  3.29it/s]\nSampling:  62%|β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–   | 31/50 [00:12<00:05,  3.29it/s]\nSampling:  64%|β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–   | 32/50 [00:12<00:05,  3.29it/s]\nSampling:  66%|β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–Œ   | 33/50 [00:12<00:05,  3.29it/s]\nSampling:  68%|β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–Š   | 34/50 [00:13<00:04,  3.29it/s]\nSampling:  70%|β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆ   | 35/50 [00:13<00:04,  3.29it/s]\nSampling:  72%|β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–  | 36/50 [00:13<00:04,  3.30it/s]\nSampling:  74%|β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–  | 37/50 [00:13<00:03,  3.30it/s]\nSampling:  76%|β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–Œ  | 38/50 [00:14<00:03,  3.30it/s]\nSampling:  78%|β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–Š  | 39/50 [00:14<00:02,  3.88it/s]\nSampling:  80%|β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆ  | 40/50 [00:14<00:02,  4.42it/s]\nSampling:  82%|β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ– | 41/50 [00:14<00:01,  4.90it/s]\nSampling:  84%|β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ– | 42/50 [00:14<00:01,  5.31it/s]\nSampling:  86%|β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–Œ | 43/50 [00:14<00:01,  5.63it/s]\nSampling:  88%|β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–Š | 44/50 [00:15<00:01,  5.88it/s]\nSampling:  90%|β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆ | 45/50 [00:15<00:00,  6.07it/s]\nSampling:  92%|β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–| 46/50 [00:15<00:00,  6.21it/s]\nSampling:  94%|β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–| 47/50 [00:15<00:00,  6.31it/s]\nSampling:  96%|β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–Œ| 48/50 [00:15<00:00,  6.38it/s]\nSampling:  98%|β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–Š| 49/50 [00:15<00:00,  6.43it/s]\nSampling: 100%|β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆ| 50/50 [00:16<00:00,  6.47it/s]\nSampling: 100%|β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆ| 50/50 [00:16<00:00,  3.12it/s]\nINFO:predict:TRELLIS pipeline complete!\nINFO:predict:Available output formats: dict_keys(['mesh', 'gaussian'])\nINFO:predict:Starting video rendering...\nINFO:predict:Generating color video from gaussian output...\nRendering: 0it [00:00, ?it/s]\nRendering: 18it [00:00, 173.86it/s]\nRendering: 41it [00:00, 205.90it/s]\nRendering: 65it [00:00, 217.88it/s]\nRendering: 89it [00:00, 223.56it/s]\nRendering: 112it [00:00, 224.36it/s]\nRendering: 120it [00:00, 218.59it/s]\nINFO:predict:Available gaussian render types: ['color', 'depth']\nINFO:predict:Generating normal video from mesh output...\nRendering: 0it [00:00, ?it/s]\nRendering: 9it [00:00, 80.92it/s]\nRendering: 18it [00:00, 82.59it/s]\nRendering: 27it [00:00, 82.89it/s]\nRendering: 36it [00:00, 83.16it/s]\nRendering: 45it [00:00, 83.28it/s]\nRendering: 54it [00:00, 83.36it/s]\nRendering: 63it [00:00, 83.48it/s]\nRendering: 72it [00:00, 83.70it/s]\nRendering: 81it [00:00, 84.09it/s]\nRendering: 90it [00:01, 84.47it/s]\nRendering: 99it [00:01, 84.77it/s]\nRendering: 108it [00:01, 84.94it/s]\nRendering: 117it [00:01, 84.79it/s]\nRendering: 120it [00:01, 83.97it/s]\nINFO:predict:Available mesh render types: ['normal']\nINFO:predict:Combining color and normal videos side by side...\nINFO:predict:Generated combined video successfully\nINFO:predict:Video rendering complete!\nINFO:predict:Generating GLB model...\nINFO- Loaded 22799 vertices and 45238 faces.\n0% done\n2% done\n4% done\n7% done\n9% done\n12% done\n14% done\n17% done\n19% done\n21% done\n24% done\n26% done\n29% done\n31% done\n34% done\n36% done\n39% done\n41% done\n43% done\n46% done\n48% done\n51% done\n53% done\n56% done\n58% done\n60% done\n63% done\n65% done\n68% done\n70% done\n73% done\n75% done\n78% done\n80% done\n82% done\n85% done\n87% done\n90% done\n92% done\n95% done\n97% done\n100% done\nRendering: 0it [00:00, ?it/s]\nRendering: 12it [00:00, 114.93it/s]\nRendering: 25it [00:00, 120.87it/s]\nRendering: 38it [00:00, 120.73it/s]\nRendering: 51it [00:00, 117.82it/s]\nRendering: 63it [00:00, 114.63it/s]\nRendering: 75it [00:00, 113.92it/s]\nRendering: 87it [00:00, 113.96it/s]\nRendering: 99it [00:00, 114.14it/s]\nRendering: 100it [00:00, 115.41it/s]\nINFO:predict:GLB model generation complete!\nINFO:predict:Prediction complete! Returning results...\n",
    "metrics": {
        "predict_time": 78.858637
    },
    "output": {
        "no_background_image": "",
        "combined_video": "",
        "model_file": ""
    },
    "started_at": "2024-12-11T12:49:10.460795+00:00",
    "status": "succeeded",
    "version": null
}
Modified atΒ 2025-07-06 06:39:33
Previous
Create Task
Next
Get Task
Built with