TRELLIS.2 4B | EmpirioLabs AI Docs

Microsoft · 3D Generation

POST /v1/3d/generations

TRELLIS.2 modelo imagem-para-3D que transforma uma imagem de referência em um asset GLB texturizado com controles de resolução, semente, malha, textura e exportação.

De um olhar

Campo	Valor
ID do modelo	`trellis-2-4b`
Data de lançamento do modelo	-
Modalidades de entrada	Imagem
Modalidades de saída	3D
Janela de contexto	-
Precisão do peso	Misto BF16/FP16
Características	image_to_3d, glb_output, pbr_materials, seed_control, commercial_ready
Inferência nativa	Sim
Novo	Sim
Endpoints suportados	`POST /v1/3d/generations`

Precificação

Carga	Especificação	Taxa
Ativo 512	por pedido	$0.025 (era $0.25)
Ativo 1024	por pedido	$0.249 (era $0.30)
Ativo de 1536	por pedido	$0.499

Exemplo de pedido

$ 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	Obrigatório	Padrão	Descrição
`image`	Imagem	sim	-	URL da imagem de referência, URI de dados ou objeto de imagem enviado.
`resolution`	enum	Não	`"1024"`	Resolução da grade voxel. Valores mais altos são mais lentos e detalhados. · Permitido: `512`, `1024`, `1536`
`pipeline_type`	enum	Não	`"1024_cascade"`	Pipeline TRELLIS explícito. Deixe em cascata 1024, a menos que precise do caminho 512 ou 1536. · Permitido: `512`, `1024_cascade`, `1536_cascade`
`seed`	inteiro	Não	`42`	Semente aleatória para gerações reproduzíveis. · Intervalo: 0 – 2147483647
`preprocess_image`	Booleano	Não	Verdade	Remova o fundo e normalize a imagem de referência antes da geração.
`max_num_tokens`	inteiro	Não	`49152`	Tokens máximos de esparsos usados para geração em cascata. · Intervalo: 1024 – 131072
`ss_sampling_steps`	inteiro	Não	`12`	Passos do sampler para geração de estruturas esparsas. · Intervalo: 1 – 64
`ss_guidance_strength`	Número	Não	`7.5`	Resistência de orientação para geração de estruturas esparsas. · Intervalo: 0 – 20
`ss_guidance_rescale`	Número	Não	`0.7`	Reescalonamento de orientação para geração de estruturas esparsas. · Intervalo: 0 – 2
`ss_guidance_interval_start`	Número	Não	`0.6`	Início do intervalo de orientação de estrutura esparsa. · Intervalo: 0 – 1
`ss_guidance_interval_end`	Número	Não	`1`	Fim do intervalo de orientação de estrutura esparsa. · Intervalo: 0 – 1
`ss_rescale_t`	Número	Não	`5`	Reescalar a temperatura para geração de estruturas esparsas. · Intervalo: 0 – 20
`shape_slat_sampling_steps`	inteiro	Não	`12`	Passos de amostragem para geração latente estruturada em forma. · Intervalo: 1 – 64
`shape_slat_guidance_strength`	Número	Não	`7.5`	Força de orientação para geração latente estruturada em forma. · Intervalo: 0 – 20
`shape_slat_guidance_rescale`	Número	Não	`0.5`	Orientação de reescala para geração latente estruturada por forma. · Intervalo: 0 – 2
`shape_slat_guidance_interval_start`	Número	Não	`0.6`	Início do intervalo de orientação SLat da forma. · Intervalo: 0 – 1
`shape_slat_guidance_interval_end`	Número	Não	`1`	Intervalo de orientação SLat no final da forma. · Intervalo: 0 – 1
`shape_slat_rescale_t`	Número	Não	`3`	Reescalar a temperatura para a geração latente estruturada por forma. · Intervalo: 0 – 20
`tex_slat_sampling_steps`	inteiro	Não	`12`	Passos de sampler para geração latente estruturada por texturas. · Intervalo: 1 – 64
`tex_slat_guidance_strength`	Número	Não	`1`	Força de orientação para geração latente estruturada por textura. · Intervalo: 0 – 20
`tex_slat_guidance_rescale`	Número	Não	`0`	Orientação de reescalonamento para geração latente estruturada por textura. · Intervalo: 0 – 2
`tex_slat_guidance_interval_start`	Número	Não	`0.6`	Início do intervalo de orientação SLat de textura. · Intervalo: 0 – 1
`tex_slat_guidance_interval_end`	Número	Não	`0.9`	Fim do intervalo de orientação SLat de textura. · Intervalo: 0 – 1
`tex_slat_rescale_t`	Número	Não	`3`	Reescalar a temperatura para geração latente estruturada pela textura. · Intervalo: 0 – 20
`texture_size`	enum	Não	`"2048"`	Resolução de textura assada sobre o material GLB. · Permitido: `1024`, `2048`, `4096`
`decimation_target`	inteiro	Não	`500000`	Contagem aproximada de vértices alvo para a malha exportada. · Alcance: 10000 – 1000000
`remesh`	Booleano	Não	Verdade	Reconstrua a topologia da malha antes do desembrulho UV e do bake de textura.
`remesh_band`	Número	Não	`1`	Tamanho da banda remeshing. · Intervalo: 0 – 5
`remesh_project`	Número	Não	`0.9`	Fator de projeção usado durante o remalhamento. · Intervalo: 0 – 1
`uv_unwrap_angle_threshold_deg`	Número	Não	`90`	Limiar de meio ângulo do cone usado para agrupamento de desdobramento UV. · Intervalo: 1 – 180
`uv_unwrap_refine_iterations`	inteiro	Não	`0`	Iterações de refinamento por clustering UV. · Intervalo: 0 – 10
`uv_unwrap_global_iterations`	inteiro	Não	`1`	Iterações globais de clustering UV. · Intervalo: 0 – 10
`uv_unwrap_smooth_strength`	Número	Não	`1`	Força de suavizamento de clusters UV. · Intervalo: 0 – 10
`response_format`	enum	Não	`"url"`	Devolva URLs de mídia assinadas por padrão, ou JSON base64 inline quando solicitado. · Permitido: `url`, `b64_json`
`verbose`	Booleano	Não	falso	Ative o registro de exportação de malhas verbose.

Notas

Padrão

Pipeline em cascata 1024
12 passos de sampler por estágio
Tamanho de textura 2048
Meta de 500k de dizimação
Saída GLB

Controles

Suporta URL ou upload de imagem, resolução 512/1024/1536, seed, tipo de pipeline, controles de guidance/interval/reescalamento do sampler, tamanho de textura, dizimação de malha, remeshing, ajuste UV de desdobramento e saída de URL ou base64. A faturação é feita por ativo 3D gerado.

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