API Reference3D Generation

Generate a 3D asset

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.

Autenticación

AuthorizationBearer

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

Solicitud

This endpoint expects an object.
modelstringRequerido
imagestringOpcional

Reference image for image-to-3D generation.

image_urlstringOpcionalformat: "uri"

Alias for image when passing a public URL.

resolutionenumOpcionalValor predeterminado: 1024
Valores permitidos:
seedintegerOpcional0-2147483647Valor predeterminado: 42
texture_sizeenumOpcionalValor predeterminado: 2048
Valores permitidos:
decimation_targetintegerOpcional10000-1000000Valor predeterminado: 500000
remeshbooleanOpcionalValor predeterminado: true
max_num_tokensintegerOpcional1024-131072Valor predeterminado: 49152
response_formatenumOpcionalValor predeterminado: url
Valores permitidos:

Respuesta

Job created. Poll the jobs endpoint for the result.
job_idstring
statusenum
poll_urlstring
created_atdatetime