Ir al contenido

TRELLIS.2 LoRA Inference

Integrar

ID del modelo trellis-2-lora
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/trellis-2-lora?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Esta solicitud: $0.25 250 créditos de API Ejecutar en esta página

Obtener clave de API
Microsoft Imagen a 3D

Conversión de imagen a 3D de Trellis 2 que puede aplicar adaptadores LoRA personalizados para estructura, geometría y textura

Microsoft · 3D

Tu primer resultado aparecerá aquí

Crea una solicitud abajo y ejecútala con tu clave de API. Las salidas se copian en nuestro almacenamiento, donde se conservan para siempre o 7 días gratis.

Crear una solicitud

Los controles se generan a partir del esquema del modelo. El código y el precio se actualizan conforme los cambias.

•obligatorio image_url
Suelta un archivo o

URL de la imagen de origen para convertirla en un modelo 3D.

resolution predeterminado 512

Resolución de generación; 1024 selecciona el pipeline en cascada. Elige la resolución usada para entrenar los adaptadores LoRA proporcionados; se requiere coincidencia.

Avanzado texture_lora_url · texture_size · sparse_structure_lora_url · geometry_lora_url · ss_guidance_strength · ss_guidance_rescale · ss_guidance_interval_start · ss_guidance_interval_end · ss_sampling_steps · ss_rescale_t · shape_slat_guidance_strength · shape_slat_guidance_rescale · shape_slat_guidance_interval_start · shape_slat_guidance_interval_end · shape_slat_sampling_steps · shape_slat_rescale_t · tex_slat_guidance_strength · tex_slat_guidance_rescale · tex_slat_guidance_interval_start · tex_slat_guidance_interval_end · tex_slat_sampling_steps · tex_slat_rescale_t · decimation_target · seed · enable_safety_checker

Punto de control LoRA opcional en formato safetensors, entrenado específicamente para el eliminador de ruido de textura.

texture_size predeterminado 2048

Resolución de las texturas integradas en la exportación GLB.

Punto de control LoRA opcional en formato safetensors, entrenado específicamente para el eliminador de ruido de estructura dispersa.

Punto de control LoRA opcional en formato safetensors, entrenado específicamente para el eliminador de ruido de geometría.

predeterminado 7.5

Intensidad de orientación sin clasificador durante la generación de estructura dispersa.

predeterminado 0.7

Reescalado de la orientación durante la generación de estructura dispersa. Los valores mayores hacen que la salida sea más estable.

predeterminado 0.6

Fracción del progreso de eliminación de ruido en la que comienza la orientación de la estructura dispersa.

predeterminado 1

Usa una fracción de eliminación de ruido igual o superior a `ss_guidance_interval_start` para especificar cuándo se detiene la orientación de la estructura dispersa.

predeterminado 12

Cantidad de pasos de eliminación de ruido usados durante la generación de estructura dispersa.

predeterminado 5

Nitidez del programa de ruido durante la generación de estructura dispersa.

predeterminado 7.5

Intensidad de orientación sin clasificador durante la generación de formas.

predeterminado 0.5

Reescalado aplicado a la orientación durante la generación de formas; auméntalo cuando la geometría parezca ruidosa.

predeterminado 0.6

Fracción de eliminación de ruido en la que comienza la orientación de la etapa de forma.

predeterminado 1

Punto de detención de la orientación de la etapa de forma, expresado como una fracción de eliminación de ruido no menor que shape_slat_guidance_interval_start.

predeterminado 12

Cantidad de pasos de eliminación de ruido durante la generación de formas.

predeterminado 3

Nitidez del programa de ruido durante la generación de formas.

predeterminado 1

Intensidad de orientación sin clasificador durante la generación de texturas.

predeterminado 0

Reescalado aplicado a la orientación durante la generación de texturas; auméntalo cuando las texturas parezcan ruidosas.

predeterminado 0.6

Fracción de eliminación de ruido en la que comienza la orientación de la etapa de textura.

predeterminado 0.9

Punto de detención de la orientación de la etapa de textura, expresado como una fracción de eliminación de ruido no menor que tex_slat_guidance_interval_start.

predeterminado 12

Cantidad de pasos de eliminación de ruido durante la generación de texturas.

predeterminado 3

Nitidez del programa de ruido durante la generación de texturas.

predeterminado 500000

Cantidad deseada de vértices en la exportación GLB.

Seed aleatorio que hace reproducible la generación.

POST /run/trellis-2-lora?wait=20 cotización → $0.25
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/trellis-2-lora?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Ejecutar esta solicitud

Tu clave permanece en este navegador: solo se envía a la Doitong API y se guarda en localStorage únicamente si marcas Recordar. Obtener una clave de API

Acerca de TRELLIS.2 LoRA Inference

Genera un GLB a partir de `image_url`, aplicando opcionalmente LoRA safetensors mediante `sparse_structure_lora_url`, `geometry_lora_url` y `texture_lora_url`. `resolution` es 512 o 1024 y debe coincidir con la resolución de entrenamiento de los adaptadores. También expone controles de guía y pasos por etapa, `decimation_target` y `texture_size`.

Parámetros

Envía el nombre canónico o el nombre nativo, no ambos. Nombres canónicos

NombreTipo PredeterminadoPermitido Descripción
image_urlobligatorio image
Tipourl · image
URL de la imagen de origen para convertirla en un modelo 3D.
sparse_structure_lora_urlopcional
Tipostring | null
Punto de control LoRA opcional en formato safetensors, entrenado específicamente para el eliminador de ruido de estructura dispersa.
geometry_lora_urlopcional
Tipostring | null
Punto de control LoRA opcional en formato safetensors, entrenado específicamente para el eliminador de ruido de geometría.
texture_lora_urlopcional
Tipostring | null
Punto de control LoRA opcional en formato safetensors, entrenado específicamente para el eliminador de ruido de textura.
seedopcional
Tipointeger | null
Seed aleatorio que hace reproducible la generación.
resolutionopcional
Tipoenum
Predeterminado512
5121024
Resolución de generación; 1024 selecciona el pipeline en cascada. Elige la resolución usada para entrenar los adaptadores LoRA proporcionados; se requiere coincidencia.
ss_guidance_strengthopcional
Tiponumber
Predeterminado7.5
0 – 10
Intensidad de orientación sin clasificador durante la generación de estructura dispersa.
ss_guidance_rescaleopcional
Tiponumber
Predeterminado0.7
0 – 1
Reescalado de la orientación durante la generación de estructura dispersa. Los valores mayores hacen que la salida sea más estable.
ss_guidance_interval_startopcional
Tiponumber
Predeterminado0.6
0 – 1
Fracción del progreso de eliminación de ruido en la que comienza la orientación de la estructura dispersa.
ss_guidance_interval_endopcional
Tiponumber
Predeterminado1
0 – 1
Usa una fracción de eliminación de ruido igual o superior a `ss_guidance_interval_start` para especificar cuándo se detiene la orientación de la estructura dispersa.
ss_sampling_stepsopcional
Tipointeger
Predeterminado12
1 – 50
Cantidad de pasos de eliminación de ruido usados durante la generación de estructura dispersa.
ss_rescale_topcional
Tiponumber
Predeterminado5
1 – 6
Nitidez del programa de ruido durante la generación de estructura dispersa.
shape_slat_guidance_strengthopcional
Tiponumber
Predeterminado7.5
0 – 10
Intensidad de orientación sin clasificador durante la generación de formas.
shape_slat_guidance_rescaleopcional
Tiponumber
Predeterminado0.5
0 – 1
Reescalado aplicado a la orientación durante la generación de formas; auméntalo cuando la geometría parezca ruidosa.
shape_slat_guidance_interval_startopcional
Tiponumber
Predeterminado0.6
0 – 1
Fracción de eliminación de ruido en la que comienza la orientación de la etapa de forma.
shape_slat_guidance_interval_endopcional
Tiponumber
Predeterminado1
0 – 1
Punto de detención de la orientación de la etapa de forma, expresado como una fracción de eliminación de ruido no menor que shape_slat_guidance_interval_start.
shape_slat_sampling_stepsopcional
Tipointeger
Predeterminado12
1 – 50
Cantidad de pasos de eliminación de ruido durante la generación de formas.
shape_slat_rescale_topcional
Tiponumber
Predeterminado3
1 – 6
Nitidez del programa de ruido durante la generación de formas.
tex_slat_guidance_strengthopcional
Tiponumber
Predeterminado1
0 – 10
Intensidad de orientación sin clasificador durante la generación de texturas.
tex_slat_guidance_rescaleopcional
Tiponumber
Predeterminado0
0 – 1
Reescalado aplicado a la orientación durante la generación de texturas; auméntalo cuando las texturas parezcan ruidosas.
tex_slat_guidance_interval_startopcional
Tiponumber
Predeterminado0.6
0 – 1
Fracción de eliminación de ruido en la que comienza la orientación de la etapa de textura.
tex_slat_guidance_interval_endopcional
Tiponumber
Predeterminado0.9
0 – 1
Punto de detención de la orientación de la etapa de textura, expresado como una fracción de eliminación de ruido no menor que tex_slat_guidance_interval_start.
tex_slat_sampling_stepsopcional
Tipointeger
Predeterminado12
1 – 50
Cantidad de pasos de eliminación de ruido durante la generación de texturas.
tex_slat_rescale_topcional
Tiponumber
Predeterminado3
1 – 6
Nitidez del programa de ruido durante la generación de texturas.
decimation_targetopcional
Tipointeger
Predeterminado500000
5,000 – 2,000,000
Cantidad deseada de vértices en la exportación GLB.
texture_sizeopcional
Tipoenum
Predeterminado2048
102420484096
Resolución de las texturas integradas en la exportación GLB.
enable_safety_checkeropcional
Tipoboolean
Predeterminadotrue
La moderación puede relajarse estableciendo false, siempre que la persona que llama esté autorizada.
obligatorio Nombre canónico, también aceptado

Los parámetros de archivo aceptan una URL pública https://, un URI data: de hasta 10 MB o el file_url de una carga. Archivos

Salida

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "trellis-2-lora",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 250,
    "usd": "0.25",
    "charged": 250,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "model_glb": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "seed": 42,
    "resolution": 1,
    "sparse_structure_lora_url": "string",
    "geometry_lora_url": "string",
    "texture_lora_url": "string",
    "decimation_target": 1,
    "texture_size": 1
  },
  "outputs": [
    {
      "type": "file",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Tus archivos, tú eligesCada outputs[].url es una copia en nuestro almacenamiento: se conserva para siempre (con cobro por GB-mes) o 7 días gratis, según la configuración de tu cuenta o ?storage=.
La misma estructura en todos los modelostype, url, content_type, width, height y duration, tanto para imágenes como para video y audio. output es el objeto de resultado propio del modelo.
Campos de salida
model_glb
object {url, content_type, file_name, file_size}Archivo GLB que contiene el modelo 3D generado.
seed
integerSeed aplicado durante la generación.
resolution
integerResolución a la que se realizó la generación.
sparse_structure_lora_url
string | nullPunto de control LoRA de estructura dispersa usado durante la generación, si se aplicó.
geometry_lora_url
string | nullPunto de control LoRA de geometría usado durante la generación, si se aplicó.
texture_lora_url
string | nullPunto de control LoRA de textura usado durante la generación, si se aplicó.
decimation_target
integerObjetivo de cantidad de vértices aplicado a la exportación GLB.
texture_size
integerResolución de las texturas integradas en la exportación GLB.

Para agentes de IA: esta página en Markdown está disponible en https://doitong.com/es-MX/developers/models/trellis-2-lora.md. Todos los modelos y guías: https://doitong.com/developers/llms.txt