TRELLIS.2 4B API

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.

MicrosoftGeração 3DInferência nativa

Sobre TRELLIS.2 4B

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

image to 3dglb outputpbr materialsseed controlcommercial ready

Especificações de TRELLIS.2 4B

ID do modelo
trellis-2-4b
Provedor
Microsoft
Categoria
Geração 3D
Lançado
-
Entrada
Imagem
Saída
3D
Endpoints
POST/v1/3d/generations
IDs de modelo alternativos
microsoft/trellis.2-4btrellis-2

Preços da API TRELLIS.2 4BEconomize até 90%

Tarifas pay-as-you-go ao vivo do catálogo EmpirioLabs. Você paga só pelo que usa, sem mínimo mensal.

Tipo
Especificação
Tarifa
512 activos
por pedido
$0.25$0.025
1024 activos
por pedido
$0.30$0.249
1536 activo
por pedido
$0.499
Comparar na página completa de preços

Como chamar a API TRELLIS.2 4B

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: enviar o job
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: consultar o resultado
curl https://api.empiriolabs.ai/v1/jobs/JOB_ID \
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"
Python
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)
Referência completa da API TRELLIS.2 4B

Parâmetros da API TRELLIS.2 4B

Parâmetros de requisição suportados pela API TRELLIS.2 4B na EmpirioLabs. Os padrões valem quando um campo é omitido.

ParâmetroTipoPadrãoIntervalo / valoresDescrição
imageimage--URL da imagem de referência, URI de dados ou objeto de imagem enviado.
resolutionenum1024512, 1024, 1536Resolução da grade voxel. Valores mais altos são mais lentos e detalhados.
pipeline_typeenum1024_cascade512, 1024_cascade, 1536_cascadePipeline TRELLIS explícito. Deixe em cascata 1024, a menos que precise do caminho 512 ou 1536.
seedinteger420 a 2147483647Semente aleatória para gerações reproduzíveis.
preprocess_imagebooleantrue-Remova o fundo e normalize a imagem de referência antes da geração.
max_num_tokensinteger491521024 a 131072Tokens máximos de esparsos usados para geração em cascata.
ss_sampling_stepsinteger121 a 64Passos do sampler para geração de estruturas esparsas.
ss_guidance_strengthnumber7.50 a 20Resistência de orientação para geração de estruturas esparsas.
ss_guidance_rescalenumber0.70 a 2Reescalonamento de orientação para geração de estruturas esparsas.
ss_guidance_interval_startnumber0.60 a 1Início do intervalo de orientação de estrutura esparsa.
ss_guidance_interval_endnumber10 a 1Fim do intervalo de orientação de estrutura esparsa.
ss_rescale_tnumber50 a 20Reescalar a temperatura para geração de estruturas esparsas.
shape_slat_sampling_stepsinteger121 a 64Passos de amostragem para geração latente estruturada em forma.
shape_slat_guidance_strengthnumber7.50 a 20Força de orientação para geração latente estruturada em forma.
21 parâmetros a mais na documentação

Bom saber

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.

API TRELLIS.2 4B: perguntas frequentes

Quanto custa a API TRELLIS.2 4B?

Na EmpirioLabs, TRELLIS.2 4B é cobrado por uso. A tabela de tarifas ao vivo desta página sempre corresponde ao que a API cobra.

Qual endpoint TRELLIS.2 4B usa?

TRELLIS.2 4B é servido por POST /v1/3d/generations em api.empiriolabs.ai com autenticação padrão por token Bearer.

Posso testar TRELLIS.2 4B no navegador antes de integrar?

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.

Como consigo uma chave de API TRELLIS.2 4B?

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.

Pronto para usar endpoints melhores?

Confira nossos preços ou entre em contato se quiser que seu próprio modelo seja implementado em nossa pilha.