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, conservadas 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 al modificarlos.

•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 la canalización en cascada. Elige la resolución utilizada para entrenar los adaptadores LoRA proporcionados; es necesario que coincida.

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

Checkpoint LoRA opcional en formato safetensors, entrenado específicamente para el reductor de ruido de textura.

texture_size predeterminado 2048

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

Checkpoint LoRA opcional en formato safetensors, entrenado específicamente para el reductor de ruido de estructura dispersa.

Checkpoint LoRA opcional en formato safetensors, entrenado específicamente para el reductor de ruido de geometría.

predeterminado 7.5

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

predeterminado 0.7

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

predeterminado 0.6

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

predeterminado 1

Usa una fracción de reducció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 reducción de ruido durante la generación de la estructura dispersa.

predeterminado 5

Nitidez de la programación de ruido durante la generación de la estructura dispersa.

predeterminado 7.5

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

predeterminado 0.5

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

predeterminado 0.6

Fracción de reducció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 reducción de ruido no inferior a shape_slat_guidance_interval_start.

predeterminado 12

Cantidad de pasos de reducción de ruido durante la generación de la forma.

predeterminado 3

Nitidez de la programación de ruido durante la generación de la forma.

predeterminado 1

Intensidad de la 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 reducció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 reducción de ruido no inferior a tex_slat_guidance_interval_start.

predeterminado 12

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

predeterminado 3

Nitidez de la programación 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 (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
Checkpoint LoRA opcional en formato safetensors, entrenado específicamente para el reductor de ruido de estructura dispersa.
geometry_lora_urlopcional
Tipostring | null
Checkpoint LoRA opcional en formato safetensors, entrenado específicamente para el reductor de ruido de geometría.
texture_lora_urlopcional
Tipostring | null
Checkpoint LoRA opcional en formato safetensors, entrenado específicamente para el reductor 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 la canalización en cascada. Elige la resolución utilizada para entrenar los adaptadores LoRA proporcionados; es necesario que coincida.
ss_guidance_strengthopcional
Tiponumber
Predeterminado7.5
0 – 10
Intensidad de la orientación sin clasificador durante la generación de la estructura dispersa.
ss_guidance_rescaleopcional
Tiponumber
Predeterminado0.7
0 – 1
Reescalado de orientación durante la generación de la 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 reducció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 reducció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 reducción de ruido durante la generación de la estructura dispersa.
ss_rescale_topcional
Tiponumber
Predeterminado5
1 – 6
Nitidez de la programación de ruido durante la generación de la estructura dispersa.
shape_slat_guidance_strengthopcional
Tiponumber
Predeterminado7.5
0 – 10
Intensidad de la orientación sin clasificador durante la generación de la forma.
shape_slat_guidance_rescaleopcional
Tiponumber
Predeterminado0.5
0 – 1
Reescalado aplicado a la orientación durante la generación de la forma; auméntalo cuando la geometría parezca ruidosa.
shape_slat_guidance_interval_startopcional
Tiponumber
Predeterminado0.6
0 – 1
Fracción de reducció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 reducción de ruido no inferior a shape_slat_guidance_interval_start.
shape_slat_sampling_stepsopcional
Tipointeger
Predeterminado12
1 – 50
Cantidad de pasos de reducción de ruido durante la generación de la forma.
shape_slat_rescale_topcional
Tiponumber
Predeterminado3
1 – 6
Nitidez de la programación de ruido durante la generación de la forma.
tex_slat_guidance_strengthopcional
Tiponumber
Predeterminado1
0 – 10
Intensidad de la 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 reducció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 reducción de ruido no inferior a tex_slat_guidance_interval_start.
tex_slat_sampling_stepsopcional
Tipointeger
Predeterminado12
1 – 50
Cantidad de pasos de reducción de ruido durante la generación de texturas.
tex_slat_rescale_topcional
Tiponumber
Predeterminado3
1 – 6
Nitidez de la programación de ruido durante la generación de texturas.
decimation_targetopcional
Tipointeger
Predeterminado500000
5000 – 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 el autor de la llamada esté autorizado.
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: conservada para siempre (se cobra 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 vídeo 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 | nullCheckpoint LoRA de estructura dispersa utilizado durante la generación, si se aplicó alguno.
geometry_lora_url
string | nullCheckpoint LoRA de geometría utilizado durante la generación, si se aplicó alguno.
texture_lora_url
string | nullCheckpoint LoRA de textura utilizado durante la generación, si se aplicó alguno.
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á en https://doitong.com/es/developers/models/trellis-2-lora.md. Todos los modelos y guías: https://doitong.com/developers/llms.txt