TRELLIS.2 4B | EmpirioLabs AI Docs

Microsoft · 3D Generation

POST /v1/3d/generations

TRELLIS.2 modelo de imagen a 3D que convierte una imagen de referencia en un recurso GLB texturizado con controles de resolución, semilla, malla, textura y exportación.

A simple vista

Campo	Valor
ID de modelo	`trellis-2-4b`
Fecha de lanzamiento del modelo	-
Modalidades de entrada	Imagen
Modalidades de salida	3D
Ventana de contexto	-
Precisión del peso	Mixta BF16/FP16
Características	image_to_3d, glb_output, pbr_materials, seed_control, commercial_ready
Inferencia nativa	Sí
Nuevo	Sí
Puntos finales soportados	`POST /v1/3d/generations`

Precios

Carga	Especificaciones	Tarifa
Activo 512	por petición	$0.025 (era $0.25)
Activo 1024	por petición	$0.249 (era $0.30)
Activo de 1536	por petición	$0.499

Solicitud de ejemplo

$ curl https://api.empiriolabs.ai/v1/3d/generations \
>   -H 'Authorization: Bearer $EMPIRIOLABS_API_KEY' \
>   -H 'Content-Type: application/json' \
>   -d '{"model": "trellis-2-4b", "image_url": "https://example.com/product-photo.png", "resolution": "1024", "texture_size": "2048"}'

Parámetros

Parámetro	Tipo	Obligatorio	Default	Descripción
`image`	Imagen	Sí	-	URL de imagen de referencia, URI de datos o objeto de imagen subido.
`resolution`	enum	no	`"1024"`	Resolución de la cuadrícula voxel. Los valores más altos son más lentos y detallados. · Permitidos: `512`, `1024`, `1536`
`pipeline_type`	enum	no	`"1024_cascade"`	Pipeline TRELLIS explícito. Sal en cascada 1024 a menos que necesites la ruta 512 o 1536. · Permitidos: `512`, `1024_cascade`, `1536_cascade`
`seed`	enteros	no	`42`	Semilla aleatoria para generaciones reproducibles. · Rango: 0 – 2147483647
`preprocess_image`	Booleano	no	Cierto	Elimina el fondo y normaliza la imagen de referencia antes de la generación.
`max_num_tokens`	enteros	no	`49152`	Tokens máximos de dispersión usados para la generación en cascada. · Rango: 1024 – 131072
`ss_sampling_steps`	enteros	no	`12`	Pasos de muestreador para la generación de estructuras dispersas. · Rango: 1 – 64
`ss_guidance_strength`	Número	no	`7.5`	Resistencia de guiado para generación de estructuras dispersas. · Rango: 0 – 20
`ss_guidance_rescale`	Número	no	`0.7`	Guía de reescalado para generación de estructuras dispersas. · Rango: 0 – 2
`ss_guidance_interval_start`	Número	no	`0.6`	Inicio del intervalo de guía de estructura dispersa. · Rango: 0 – 1
`ss_guidance_interval_end`	Número	no	`1`	Fin del intervalo de guía de estructura dispersa. · Rango: 0 – 1
`ss_rescale_t`	Número	no	`5`	Reescala la temperatura para la generación de estructuras dispersas. · Rango: 0 – 20
`shape_slat_sampling_steps`	enteros	no	`12`	Pasos de muestreo para la generación latente estructurada en forma. · Rango: 1 – 64
`shape_slat_guidance_strength`	Número	no	`7.5`	Resistencia de guiado para la generación latente estructurada de forma. · Rango: 0 – 20
`shape_slat_guidance_rescale`	Número	no	`0.5`	Reescalado de guía para la generación latente estructurada de forma. · Rango: 0 – 2
`shape_slat_guidance_interval_start`	Número	no	`0.6`	Inicio del intervalo de guía SLat de la forma. · Rango: 0 – 1
`shape_slat_guidance_interval_end`	Número	no	`1`	Intervalo de guía SLat al final de la forma. · Rango: 0 – 1
`shape_slat_rescale_t`	Número	no	`3`	Reescala la temperatura para la generación latente estructurada de la forma. · Rango: 0 – 20
`tex_slat_sampling_steps`	enteros	no	`12`	Pasos de sampler para la generación latente estructurada en texturas. · Rango: 1 – 64
`tex_slat_guidance_strength`	Número	no	`1`	Resistencia de guía para la generación latente estructurada de texturas. · Rango: 0 – 20
`tex_slat_guidance_rescale`	Número	no	`0`	Guía de reescalado para la generación latente estructurada por texturas. · Rango: 0 – 2
`tex_slat_guidance_interval_start`	Número	no	`0.6`	Inicio del intervalo de guía de textura SLat. · Rango: 0 – 1
`tex_slat_guidance_interval_end`	Número	no	`0.9`	Fin del intervalo de guía SLat de texturas. · Rango: 0 – 1
`tex_slat_rescale_t`	Número	no	`3`	Reescala la temperatura para la generación latente estructurada por texturas. · Rango: 0 – 20
`texture_size`	enum	no	`"2048"`	Resolución de textura horneada sobre el material GLB. · Permitidos: `1024`, `2048`, `4096`
`decimation_target`	enteros	no	`500000`	Conteo aproximado de vértices objetivo para la malla exportada. · Rango: 10000 – 1000000
`remesh`	Booleano	no	Cierto	Reconstruye la topología de la malla antes de desenrollar UV y hacer un horneado de texturas.
`remesh_band`	Número	no	`1`	Remallar el tamaño de la banda. · Rango: 0 – 5
`remesh_project`	Número	no	`0.9`	Factor de proyección utilizado durante el remallado. · Rango: 0 – 1
`uv_unwrap_angle_threshold_deg`	Número	no	`90`	Umbral de semiángulo de cono usado para el agrupamiento UV de desenrollamiento. · Rango: 1 – 180
`uv_unwrap_refine_iterations`	enteros	no	`0`	Iteraciones de refinamiento de clustering UV. · Rango: 0 – 10
`uv_unwrap_global_iterations`	enteros	no	`1`	Iteraciones globales de clústering UV. · Rango: 0 – 10
`uv_unwrap_smooth_strength`	Número	no	`1`	Resistencia al suavizado de los grupos UV. · Rango: 0 – 10
`response_format`	enum	no	`"url"`	Devuelve las URLs de medios firmadas por defecto, o el JSON base64 en línea cuando se solicite. · Permitidos: `url`, `b64_json`
`verbose`	Booleano	no	falso	Activa el registro de exportación de mallas verbose.

Notas

Defaults

Tubería en cascada 1024
12 pasos de sampler por etapa
Tamaño de textura 2048
Objetivo de decimación de 500k
Salida GLB

Controles

Soporta URL o subida de imagen, resolución 512/1024/1536, semilla, tipo de pipeline, controles de guidance/interval/reescalado del sampler, tamaño de textura, decimación de mallas, remallado, ajuste UV desenrollado y salida URL o base64. La facturación se realiza por activo 3D generado.

Machine-legible esquema: GET https://api.empiriolabs.ai/v1/models/trellis-2-4b.