
TRELLIS.2 modelo imagem-para-3D que transforma uma imagem de referência em um ativo GLB texturizado com resolução, semente, malha, textura e controles de exportação.
TRELLIS.2 modelo imagem-para-3D que transforma uma imagem de referência em um ativo GLB texturizado com resolução, semente, malha, textura e controles de exportação.
Também conhecido como Microsoft TRELLIS.2 4B, TRELLIS.2-4B, trellis-2-4b
trellis-2-4b/v1/3d/generationsmicrosoft/trellis.2-4btrellis-2Tarifas pay-as-you-go ao vivo do catálogo EmpirioLabs. Você paga só pelo que usa, sem mínimo mensal.
TRELLIS.2 4B roda por POST /v1/3d/generations. A requisição retorna um job_id na hora; consulte GET /v1/jobs/{job_id} até o job terminar e leia as URLs de saída do resultado. Obtenha uma chave de API no painel EmpirioLabs.
curl https://api.empiriolabs.ai/v1/3d/generations \
-H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "trellis-2-4b",
"prompt": "Describe what you want TRELLIS.2 4B to generate."
}'curl https://api.empiriolabs.ai/v1/jobs/JOB_ID \
-H "Authorization: Bearer $EMPIRIOLABS_API_KEY"import requests
response = requests.post(
"https://api.empiriolabs.ai/v1/3d/generations",
headers={"Authorization": "Bearer YOUR_EMPIRIOLABS_API_KEY"},
json={
"model": "trellis-2-4b",
"prompt": "Describe what you want TRELLIS.2 4B to generate.",
},
)
job = response.json()
# Generation runs as an async job. Poll until it completes.
import time
while True:
status = requests.get(
f"https://api.empiriolabs.ai/v1/jobs/{job['job_id']}",
headers={"Authorization": "Bearer YOUR_EMPIRIOLABS_API_KEY"},
).json()
if status.get("status") in ("completed", "failed"):
print(status)
break
time.sleep(5)Parâmetros de requisição suportados pela API TRELLIS.2 4B na EmpirioLabs. Os padrões valem quando um campo é omitido.
| Parâmetro | Tipo | Padrão | Intervalo / valores | Descrição |
|---|---|---|---|---|
| image | image | - | - | URL da imagem de referência, URI de dados ou objeto de imagem enviado. |
| resolution | enum | 1024 | 512, 1024, 1536 | Resolução da grade voxel. Valores mais altos são mais lentos e detalhados. |
| pipeline_type | enum | 1024_cascade | 512, 1024_cascade, 1536_cascade | Pipeline TRELLIS explícito. Deixe em cascata 1024, a menos que precise do caminho 512 ou 1536. |
| seed | integer | 42 | 0 a 2147483647 | Semente aleatória para gerações reproduzíveis. |
| preprocess_image | boolean | true | - | Remova o fundo e normalize a imagem de referência antes da geração. |
| max_num_tokens | integer | 49152 | 1024 a 131072 | Tokens máximos de esparsos usados para geração em cascata. |
| ss_sampling_steps | integer | 12 | 1 a 64 | Passos do sampler para geração de estruturas esparsas. |
| ss_guidance_strength | number | 7.5 | 0 a 20 | Resistência de orientação para geração de estruturas esparsas. |
| ss_guidance_rescale | number | 0.7 | 0 a 2 | Reescalonamento de orientação para geração de estruturas esparsas. |
| ss_guidance_interval_start | number | 0.6 | 0 a 1 | Início do intervalo de orientação de estrutura esparsa. |
| ss_guidance_interval_end | number | 1 | 0 a 1 | Fim do intervalo de orientação de estrutura esparsa. |
| ss_rescale_t | number | 5 | 0 a 20 | Reescalar a temperatura para geração de estruturas esparsas. |
| shape_slat_sampling_steps | integer | 12 | 1 a 64 | Passos de amostragem para geração latente estruturada em forma. |
| shape_slat_guidance_strength | number | 7.5 | 0 a 20 | Força de orientação para geração latente estruturada em forma. |
Padrão - 1024 dutos em cascata - 12 passos de amostra por estágio - 2048 tamanho de textura - 500k alvo de dizimação - saída GLB Controles Suporta URL de imagem ou upload, resolução 512/1024 /1536, tipo de pipeline, sampler guidance/interval /rescale controles, tamanho de textura, dizimação de malha, remeshing, ajuste UV deswrap e saída URL ou base64. A cobrança é por ativo 3D gerado.
Na EmpirioLabs, TRELLIS.2 4B é cobrado por uso. A tabela de tarifas ao vivo desta página sempre corresponde ao que a API cobra.
TRELLIS.2 4B é servido por POST /v1/3d/generations em api.empiriolabs.ai com autenticação padrão por token Bearer.
Sim. O playground da EmpirioLabs executa TRELLIS.2 4B no navegador com os mesmos parâmetros que a API expõe, para você testar prompts antes de escrever código.
Crie uma conta EmpirioLabs e gere uma chave em API Keys no painel. A cobrança usa créditos pay-as-you-go, então você paga apenas pelas requisições que faz.
Confira nossos preços ou entre em contato se quiser que seu próprio modelo seja implementado em nossa pilha.