TRELLIS.2

/v1/3d-models/trellis2/generate/

Generates a 3D model (GLB) from a single input image. Supports geometry-only output for fast results, or full PBR-textured output with base color, roughness, metallic, and opacity maps. All generation is asynchronous — submit a request, receive a task ID, and poll for results.

curl -X POST https://api.3daistudio.com/v1/3d-models/trellis2/generate/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://example.com/my-object.png",
    "resolution": "1024",
    "textures": true,
    "texture_size": 2048
  }'

{
  "task_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "created_at": "2026-02-26T12:00:00Z"
}

Provide either a base64-encoded image or a public URL — not both. For best results, use an image with a clean background or a transparent (alpha-masked) foreground object. The model automatically removes backgrounds when needed, but pre-masked images produce better results. Supported formats: PNG, JPEG, WebP.

// Option A: Base64 image
{
  "image": "data:image/png;base64,iVBORw0KGgo..."
}

// Option B: Image URL
{
  "image_url": "https://example.com/my-object.png"
}

Resolution controls the voxel grid density used during 3D generation. Higher resolutions capture finer geometric details but increase processing time.

Setting textures to false returns a clean, remeshed GLB with smooth geometry and vertex normals — no UV maps or materials. This is significantly faster and ideal for workflows where you apply your own textures downstream. Setting textures to true produces a fully UV-unwrapped GLB with baked PBR texture maps (base color, roughness, metallic, opacity).

/v1/generation-request/<task_id>/status/

Poll this endpoint with the task_id from the generation response. When status is "FINISHED", the results array contains your 3D model with a download URL. Results expire after 24 hours.

curl https://api.3daistudio.com/v1/generation-request/YOUR_TASK_ID/status/ \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "status": "FINISHED",
  "progress": 100,
  "results": [
    {
      "asset_url": null,
      "asset": "https://storage.3daistudio.com/assets/abc123.glb",
      "asset_type": "3D_MODEL",
      "thumbnail": "https://storage.3daistudio.com/thumbnails/abc123.png"
    }
  ]
}

Credits are deducted when you submit a request. If generation fails, credits are refunded automatically. Costs vary by resolution, texture mode, and texture size.

Generate a high-quality textured 3D model at 1024 resolution with a thumbnail:

# Submit generation request (30 + 2 = 32 credits)
curl -X POST https://api.3daistudio.com/v1/3d-models/trellis2/generate/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://example.com/chair.png",
    "resolution": "1024",
    "textures": true,
    "texture_size": 2048,
    "generate_thumbnail": true
  }'

# Poll until finished
curl https://api.3daistudio.com/v1/generation-request/TASK_ID/status/ \
  -H "Authorization: Bearer YOUR_API_KEY"

Processing typically takes 25–35 seconds for geometry-only output at 1024 resolution, or 50–70 seconds with PBR textures enabled. Higher resolutions (1536) may take up to 3–4 minutes with textures. Generating a thumbnail adds roughly 10 seconds. Processing times can vary depending on image complexity and the resulting mesh density. The first request after a period of inactivity may take an additional 30–60 seconds as the GPU model is loaded into memory. Subsequent requests within a few minutes will process immediately without this startup delay.

Common errors for TRELLIS.2 generation.