TRELLIS.2 4B API

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.

MicrosoftGeneración 3DInferencia nativa

Acerca de TRELLIS.2 4B

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.

También conocido como Microsoft TRELLIS.2 4B, TRELLIS.2-4B, trellis-2-4b

image to 3dglb outputpbr materialsseed controlcommercial ready

Especificaciones de TRELLIS.2 4B

ID del modelo
trellis-2-4b
Proveedor
Microsoft
Categoría
Generación 3D
Lanzado
-
Entrada
Imagen
Salida
3D
Endpoints
POST/v1/3d/generations
IDs de modelo alternativos
microsoft/trellis.2-4btrellis-2

Precios de la API de TRELLIS.2 4BAhorra hasta 90%

Tarifas de pago por uso en vivo del catálogo de EmpirioLabs. Solo pagas por lo que usas, sin mínimo mensual.

Tipo
Especificación
Tarifa
Activo 512
por solicitud
$0.25$0.025
Activo 1024
por solicitud
$0.30$0.249
Activo de 1536
por solicitud
$0.499
Comparar en la página completa de precios

Cómo llamar a la API de TRELLIS.2 4B

TRELLIS.2 4B funciona a través de POST /v1/3d/generations. La solicitud devuelve un job_id de inmediato; consulta GET /v1/jobs/{job_id} hasta que el trabajo termine y lee las URLs de salida del resultado. Consigue una clave de API en el panel de EmpirioLabs.

cURL: enviar el trabajo
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 el 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)
Referencia completa de la API de TRELLIS.2 4B

Parámetros de la API de TRELLIS.2 4B

Parámetros de solicitud compatibles con la API de TRELLIS.2 4B en EmpirioLabs. Los valores por defecto se aplican cuando se omite un campo.

ParámetroTipoPredeterminadoRango / valoresDescripción
imageimage--URL de imagen de referencia, URI de datos o objeto de imagen subido.
resolutionenum1024512, 1024, 1536Resolución de la cuadrícula voxel. Los valores más altos son más lentos y detallados.
pipeline_typeenum1024_cascade512, 1024_cascade, 1536_cascadePipeline TRELLIS explícito. Sal en cascada 1024 a menos que necesites la ruta 512 o 1536.
seedinteger420 a 2147483647Semilla aleatoria para generaciones reproducibles.
preprocess_imagebooleantrue-Elimina el fondo y normaliza la imagen de referencia antes de la generación.
max_num_tokensinteger491521024 a 131072Tokens máximos de dispersión usados para la generación en cascada.
ss_sampling_stepsinteger121 a 64Pasos de muestreador para la generación de estructuras dispersas.
ss_guidance_strengthnumber7.50 a 20Resistencia de guiado para generación de estructuras dispersas.
ss_guidance_rescalenumber0.70 a 2Guía de reescalado para generación de estructuras dispersas.
ss_guidance_interval_startnumber0.60 a 1Inicio del intervalo de guía de estructura dispersa.
ss_guidance_interval_endnumber10 a 1Fin del intervalo de guía de estructura dispersa.
ss_rescale_tnumber50 a 20Reescala la temperatura para la generación de estructuras dispersas.
shape_slat_sampling_stepsinteger121 a 64Pasos de muestreo para la generación latente estructurada en forma.
shape_slat_guidance_strengthnumber7.50 a 20Resistencia de guiado para la generación latente estructurada de forma.
21 parámetros más en la documentación

Información útil

Valores predeterminados - 1024 cascade pipeline - 12 pasos de sampler por etapa - 2048 tamaño de textura - 500k objetivo de decimación - Salida GLB Controles Soporta URL de imagen o subida, resolución 512/1024/1536, semilla, tipo de pipeline, controles de guidance/interval/reescalado del sampler, tamaño de textura, decimación de malla, remallado, ajuste UV de despliegue y salida URL o base64. La facturación se realiza por activo 3D generado.

API de TRELLIS.2 4B: preguntas frecuentes

¿Cuánto cuesta la API de TRELLIS.2 4B?

En EmpirioLabs, TRELLIS.2 4B se factura por uso. La tabla de tarifas en vivo de esta página siempre coincide con lo que cobra la API.

¿Qué endpoint usa TRELLIS.2 4B?

TRELLIS.2 4B se sirve a través de POST /v1/3d/generations en api.empiriolabs.ai con autenticación estándar de token Bearer.

¿Puedo probar TRELLIS.2 4B en el navegador antes de integrar?

Sí. El playground de EmpirioLabs ejecuta TRELLIS.2 4B en el navegador con los mismos parámetros que expone la API, para que pruebes prompts antes de escribir código.

¿Cómo consigo una clave de API de TRELLIS.2 4B?

Crea una cuenta de EmpirioLabs y genera una clave en API Keys en el panel. La facturación es con créditos de pago por uso, así que solo pagas por las solicitudes que haces.

¿Listo para usar mejores endpoints?

Consulta nuestros precios o contacta con nosotros si quieres que tu propio modelo se implemente en nuestra pila.