Trellis 2 API, Trellis 3D API - AI 3D Model Generation APIs

Trellis 2 API, developers can transform product photos, concept art, and designs into production-ready 3D assets. The API streamlines 3D content creation for e-commerce, gaming, and AR/VR applications where converting existing 2D assets to 3D provides significant workflow advantages.

Get API Key

Models Version

LIMITED TIME OFFER

Get $5 Free Credit on First Payment

No strings attached — add funds and get $5 bonus instantly

Claim Your $5 →

Trellis v2 Image to Image (3D Models — Image to 3D) API Documentation

https://gateway.pixazo.ai/trellis-2-image-to-3d/v1

Authentication

All requests require an API key passed via header.

Header	Type	Required	Description
Ocp-Apim-Subscription-Key	string	Yes	Your API subscription key

Trellis 2 Image to 3D generate request - Trellis 2 Image to 3D API

Request Code

POST https://gateway.pixazo.ai/trellis-2-image-to-3d/v1/trellis-2-image-to-3d-request
Content-Type: application/json
Cache-Control: no-cache
Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY

{
  "image_url": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/f1.png",
  "resolution": 1024,
  "ss_guidance_strength": 7.5,
  "ss_guidance_rescale": 0.7,
  "ss_sampling_steps": 12,
  "ss_rescale_t": 5,
  "shape_slat_guidance_strength": 7.5,
  "shape_slat_guidance_rescale": 0.5,
  "shape_slat_sampling_steps": 12,
  "shape_slat_rescale_t": 3,
  "tex_slat_guidance_strength": 1,
  "tex_slat_sampling_steps": 12,
  "tex_slat_rescale_t": 3,
  "decimation_target": 500000,
  "texture_size": 2048,
  "remesh": true,
  "remesh_band": 1
}

import requests

url = "https://gateway.pixazo.ai/trellis-2-image-to-3d/v1/trellis-2-image-to-3d-request"
headers = {
    "Content-Type": "application/json",
    "Cache-Control": "no-cache",
    "Ocp-Apim-Subscription-Key": "YOUR_SUBSCRIPTION_KEY"
}
data = {
    "image_url": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/f1.png",
    "resolution": 1024,
    "ss_guidance_strength": 7.5,
    "ss_guidance_rescale": 0.7,
    "ss_sampling_steps": 12,
    "ss_rescale_t": 5,
    "shape_slat_guidance_strength": 7.5,
    "shape_slat_guidance_rescale": 0.5,
    "shape_slat_sampling_steps": 12,
    "shape_slat_rescale_t": 3,
    "tex_slat_guidance_strength": 1,
    "tex_slat_sampling_steps": 12,
    "tex_slat_rescale_t": 3,
    "decimation_target": 500000,
    "texture_size": 2048,
    "remesh": True,
    "remesh_band": 1
}

response = requests.post(url, json=data, headers=headers)
print(response.json())

const url = 'https://gateway.pixazo.ai/trellis-2-image-to-3d/v1/trellis-2-image-to-3d-request';

const data = {
  image_url: 'https://pub-582b7213209642b9b995c96c95a30381.r2.dev/f1.png',
  resolution: 1024,
  ss_guidance_strength: 7.5,
  ss_guidance_rescale: 0.7,
  ss_sampling_steps: 12,
  ss_rescale_t: 5,
  shape_slat_guidance_strength: 7.5,
  shape_slat_guidance_rescale: 0.5,
  shape_slat_sampling_steps: 12,
  shape_slat_rescale_t: 3,
  tex_slat_guidance_strength: 1,
  tex_slat_sampling_steps: 12,
  tex_slat_rescale_t: 3,
  decimation_target: 500000,
  texture_size: 2048,
  remesh: true,
  remesh_band: 1
};

fetch(url, {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Cache-Control': 'no-cache',
    'Ocp-Apim-Subscription-Key': 'YOUR_SUBSCRIPTION_KEY'
  },
  body: JSON.stringify(data)
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));

curl -X POST "https://gateway.pixazo.ai/trellis-2-image-to-3d/v1/trellis-2-image-to-3d-request" \
  -H "Content-Type: application/json" \
  -H "Cache-Control: no-cache" \
  -H "Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY" \
  --data-raw '{
    "image_url": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/f1.png",
    "resolution": 1024,
    "ss_guidance_strength": 7.5,
    "ss_guidance_rescale": 0.7,
    "ss_sampling_steps": 12,
    "ss_rescale_t": 5,
    "shape_slat_guidance_strength": 7.5,
    "shape_slat_guidance_rescale": 0.5,
    "shape_slat_sampling_steps": 12,
    "shape_slat_rescale_t": 3,
    "tex_slat_guidance_strength": 1,
    "tex_slat_sampling_steps": 12,
    "tex_slat_rescale_t": 3,
    "decimation_target": 500000,
    "texture_size": 2048,
    "remesh": true,
    "remesh_band": 1
  }'

Output

{
  "request_id": "trellis-2-image-to-3d_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "QUEUED",
  "polling_url": "https://gateway.pixazo.ai/v2/requests/status/trellis-2-image-to-3d_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

Try Now

Webhook (Optional)

Add the X-Webhook-URL header to your generate request to receive a POST callback instead of polling.

X-Webhook-URL: https://your-server.com/webhook/callback

Request Parameters - Trellis 2 Image to 3D generate request

Parameter	Required	Type	Description
image_url	Yes	string	URL of the input 2D image to convert into a 3D model. Must be publicly accessible.
resolution	No	integer	Resolution of the initial 3D generation pass. Higher values yield finer detail but longer processing.
ss_guidance_strength	No	number	Strength of shape guidance during the initial shape generation stage. Higher values enforce structure fidelity.
ss_guidance_rescale	No	number	Rescaling factor applied to shape guidance to prevent overfitting. Helps balance creativity and structure.
ss_sampling_steps	No	integer	Number of denoising steps during shape generation. More steps improve quality but increase latency.
ss_rescale_t	No	integer	Time rescaling parameter for shape generation. Modulates how guidance changes over time steps.
shape_slat_guidance_strength	No	number	Strength of shape SLAT (Spatial Latent Attention) guidance during refinement.
shape_slat_guidance_rescale	No	number	Rescaling factor for shape SLAT guidance to smooth output.
shape_slat_sampling_steps	No	integer	Number of denoising steps in the shape SLAT refinement stage.
shape_slat_rescale_t	No	integer	Time rescaling value for shape SLAT refinement.
tex_slat_guidance_strength	No	number	Strength of texture SLAT guidance during texturing pass. Controls detail in surface appearance.
tex_slat_sampling_steps	No	integer	Number of denoising steps during texture generation.
tex_slat_rescale_t	No	integer	Time rescaling value for texture SLAT generation.
decimation_target	No	integer	Target number of polygons in the final mesh. Reduces mesh complexity for performance.
texture_size	No	integer	Resolution of the generated texture map (e.g., 1024, 2048). Higher values improve texture quality.
remesh	No	boolean	Whether to apply topology-preserving remeshing to improve mesh quality.
remesh_band	No	integer	Bandwidth parameter for remeshing. Controls edge preservation during topology optimization.

Example Request

{
  "image_url": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/f1.png",
  "resolution": 1024,
  "ss_guidance_strength": 7.5,
  "ss_guidance_rescale": 0.7,
  "ss_sampling_steps": 12,
  "ss_rescale_t": 5,
  "shape_slat_guidance_strength": 7.5,
  "shape_slat_guidance_rescale": 0.5,
  "shape_slat_sampling_steps": 12,
  "shape_slat_rescale_t": 3,
  "tex_slat_guidance_strength": 1,
  "tex_slat_sampling_steps": 12,
  "tex_slat_rescale_t": 3,
  "decimation_target": 500000,
  "texture_size": 2048,
  "remesh": true,
  "remesh_band": 1
}

Response

{
  "request_id": "trellis-2-image-to-3d_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "QUEUED",
  "polling_url": "https://gateway.pixazo.ai/v2/requests/status/trellis-2-image-to-3d_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

Request Headers

Header	Value
Content-Type	application/json
Cache-Control	no-cache
Ocp-Apim-Subscription-Key	YOUR_SUBSCRIPTION_KEY

Response Handling

Common status codes.

Code	Meaning
202	Accepted — Request queued
400	Bad Request
401	Unauthorized
402	Insufficient Balance
403	Forbidden
429	Too Many Requests
500	Internal Server Error

Error Responses

Queue system errors and model validation errors.

Queue System Errors

// 402 — Insufficient balance
{
  "error": "Insufficient Balance",
  "message": "Your wallet does not have enough balance."
}

// 400 — Model not found
{
  "error": "Model not found",
  "message": "Model 'trellis-2-image-to-3d' not found or is disabled"
}

Error via Status/Webhook

{
  "request_id": "trellis-2-image-to-3d_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "ERROR",
  "model_id": "trellis-2-image-to-3d",
  "error": "Description of the error",
  "output": null
}

Retrieving Results

Poll the universal status endpoint to check progress and retrieve results.

Endpoint

GET https://gateway.pixazo.ai/v2/requests/status/{request_id}
Ocp-Apim-Subscription-Key: YOUR_API_KEY

cURL Example

curl -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  "https://gateway.pixazo.ai/v2/requests/status/trellis-2-image-to-3d_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

Response (Completed)

{
  "request_id": "trellis-2-image-to-3d_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "COMPLETED",
  "model_id": "trellis-2-image-to-3d",
  "error": null,
  "output": {
    "media_url": [
      "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/trellis-2-image-to-3d_019dxxxx-xxxx/output.ext"
    ],
    "media_type": "application/octet-stream"
  },
  "created_at": "2026-03-31T10:00:00.000Z",
  "updated_at": "2026-03-31T10:00:15.000Z",
  "completed_at": "2026-03-31T10:00:15.000Z"
}

Response Fields

Field	Type	Description
request_id	string	Unique request identifier
status	string	QUEUED, PROCESSING, COMPLETED, FAILED, or ERROR
model_id	string	Model that processed the request
error	string\|null	Error message if failed
output.media_url	array	URLs to generated media (R2 CDN)
output.media_type	string	MIME type of the output
created_at	string	When request was created
completed_at	string\|null	When request completed
polling_url	string	Status URL (initial response only)

Status Values

Status	Description
QUEUED	Request accepted, waiting to be processed
PROCESSING	Being processed by the model
COMPLETED	Done — output contains the result
FAILED	Failed — check error field
ERROR	System error — not charged

Status Flow

QUEUED → PROCESSING → COMPLETED
                    → FAILED
                    → ERROR

Typical Workflow

Send a generate request to the API endpoint
Save the request_id from the response
Poll every 5-10 seconds: GET /v2/requests/status/{request_id}
When status is "COMPLETED", download from output.media_url

Tip: Use X-Webhook-URL header to get a callback instead of polling.

Trellis v2 Image to Image (3D Models — Image to 3D) API Pricing

Resolution	Price (USD)
All Resolution	$0.35