Generate a 3D asset | EmpirioLabs AI Docs

Image-to-3D generation. Returns a job_id and polling URL immediately; poll GET /v1/jobs/<job-id> for the final signed GLB asset URL.

trellis-2-4b accepts an input image plus resolution, seed, sampler, texture, and mesh export controls. See the model page for the full parameter surface.

Authentication

AuthorizationBearer

Pass your EmpirioLabs API key as a bearer token. The Anthropic-style x-api-key header is also accepted on every endpoint.

Request

This endpoint expects an object.

modelstringRequired

imagestringOptional

Reference image for image-to-3D generation.

image_urlstringOptionalformat: "uri"

Alias for image when passing a public URL.

resolutionenumOptionalDefaults to 1024

Allowed values:

seedintegerOptional0-2147483647Defaults to 42

texture_sizeenumOptionalDefaults to 2048

Allowed values:

decimation_targetintegerOptional10000-1000000Defaults to 500000

remeshbooleanOptionalDefaults to true

max_num_tokensintegerOptional1024-131072Defaults to 49152

response_formatenumOptionalDefaults to url

Allowed values:

Response

Job created. Poll the jobs endpoint for the result.

job_idstringOptional

statusenumOptional

poll_urlstringOptional

created_atdatetimeOptional

1	{
2	"job_id": "job_01HV3KABCDE",
3	"status": "processing",
4	"poll_url": "/v1/jobs/job_01HV3KABCDE",
5	"created_at": "2026-05-07T16:20:00Z"
6	}