Trellis 2

Integrar

ID del modelo trellis-2

# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/trellis-2?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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

const API = "https://api.doitong.ru/v1";
const headers = {
  "Authorization": "Bearer " + process.env.DOITONG_API_KEY,
  "Content-Type": "application/json",
};

// Run the model; wait up to 20 s for the finished result in the same call
let res = await fetch(API + "/run/trellis-2?wait=20", {
  method: "POST",
  headers,
  body: JSON.stringify({
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }),
});
let request = await res.json();
if (!res.ok) throw new Error(request.error.code + ": " + request.error.message);

// Not finished yet: long-poll until it is
while (request.status === "queued" || request.status === "running") {
  res = await fetch(API + "/requests/" + request.id + "?wait=20", { headers });
  request = await res.json();
}
if (request.status !== "succeeded") throw new Error(JSON.stringify(request.error));
console.log(request.outputs.map((o) => o.url), request.cost.credits + " API credits ($" + request.cost.usd + ")");

import os
import requests

API = "https://api.doitong.ru/v1"
headers = {"Authorization": "Bearer " + os.environ["DOITONG_API_KEY"]}

payload = {
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
}

# Run the model; wait up to 20 s for the finished result in the same call
r = requests.post(API + "/run/trellis-2", params={"wait": 20}, json=payload, headers=headers)
request = r.json()
if not r.ok:
    raise RuntimeError(request["error"]["code"] + ": " + request["error"]["message"])

# Not finished yet: long-poll until it is
while request["status"] in ("queued", "running"):
    request = requests.get(API + "/requests/" + request["id"], params={"wait": 20}, headers=headers).json()
if request["status"] != "succeeded":
    raise RuntimeError(request["error"])
print([o["url"] for o in request["outputs"]], request["cost"]["credits"], "API credits", "$" + request["cost"]["usd"])

# 1. Connect once (Claude Code; Cursor, VS Code, Claude Desktop: https://doitong.com/es-ES/developers/docs/mcp)
claude mcp add --transport http doitong-models https://api.doitong.ru/v1/mcp \
  --header "Authorization: Bearer $DOITONG_API_KEY"

# 2. Your agent calls the "run" tool with:
{
  "model_id": "trellis-2",
  "input": {
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }
}

Llama al modelo Trellis 2 (trellis-2) a través de Doitong API. Documentación para agentes: https://doitong.com/es-ES/developers/models/trellis-2.md

POST https://api.doitong.ru/v1/run/trellis-2?wait=20
Authorization: Bearer $DOITONG_API_KEY
Content-Type: application/json

{
  "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
}

Si el estado de la respuesta es "queued" o "running", consulta GET https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20 hasta que sea "succeeded"; los archivos están en outputs[].url. POST https://api.doitong.ru/v1/quote/trellis-2 con el mismo cuerpo devuelve el precio exacto antes de la ejecución.

Esta solicitud: 0,30 $ 300 créditos de API · ≈ 31,97 ₽ Ejecutar en esta página

Obtener clave de API

Microsoft Imagen a 3D #image-to-3d

Convierte una sola imagen en una malla 3D GLB texturizada con ajustes configurables de estructura, forma, textura y UV

OpenAPI Markdown

Microsoft · 3D

Tu primer resultado aparecerá aquí

Crea una solicitud a continuación 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.

image •obligatorio image_url

Suelta un archivo o

URL que apunta a la imagen de origen para la conversión 3D.

resolution predeterminado 1024

Resolución de la salida; aumentarla añade detalles, pero requiere más tiempo.

Avanzado texture_size · 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 · remesh_band · remesh_project · uv_unwrap_angle_threshold_deg · uv_unwrap_refine_iterations · uv_unwrap_global_iterations · uv_unwrap_smooth_strength · seed · remesh

texture_size predeterminado 2048

Resolución de textura de la malla para el baking. Una mayor resolución aporta más detalles de superficie, pero genera archivos más grandes.

ss_guidance_strength predeterminado 7.5

Control de fidelidad de la estructura 3D inicial: aumentarlo favorece una mayor correspondencia con la imagen de entrada, a costa de un posible ruido adicional.

ss_guidance_rescale predeterminado 0.7

Control de artefactos de guía de la etapa 1: los valores bajos intensifican los efectos de la guía y los altos producen una salida más estable.

ss_guidance_interval_start predeterminado 0.6

Límite inicial de la ventana de guía sin clasificador en la etapa 1 (estructura dispersa), expresado como fracción de reducción de ruido. Los valores bajos comienzan la guía antes; solo el intervalo de interval_start a interval_end usa guía, mientras que el resto se procesa sin ella.

ss_guidance_interval_end predeterminado 1

Límite de guía para la etapa 1 (estructura dispersa): elige un valor al menos igual a ss_guidance_interval_start. El valor identifica la fracción de reducción de ruido alcanzada cuando se detiene la guía sin clasificador.

ss_sampling_steps predeterminado 12

Número de pasos de eliminación de ruido de la estructura inicial: las posibles mejoras de calidad de los pasos adicionales implican un procesamiento más lento.

ss_rescale_t predeterminado 5

Establece la nitidez de la transición mediante el programa de ruido de generación de la estructura: aumentar este valor hace que las transiciones sean más nítidas.

shape_slat_guidance_strength predeterminado 7.5

Control de fidelidad de la geometría detallada: aumentar la correspondencia con la imagen de entrada añade detalles, con riesgo de ruido adicional.

shape_slat_guidance_rescale predeterminado 0.5

Aumenta este valor cuando la geometría tenga ruido: reduce los artefactos causados por una guía intensa durante la etapa de forma.

shape_slat_guidance_interval_start predeterminado 0.6

Punto de activación de la guía sin clasificador para el refinamiento de formas en la etapa 2. Expresado como fracción del progreso de reducción de ruido, establece interval_start; la guía solo opera dentro de la ventana delimitada por interval_start e interval_end.

shape_slat_guidance_interval_end predeterminado 1

Límite de guía para la etapa 2 (refinamiento de formas): elige un valor al menos igual a shape_slat_guidance_interval_start. El valor identifica la fracción de reducción de ruido alcanzada cuando se detiene la guía sin clasificador.

shape_slat_sampling_steps predeterminado 12

Número de pasos de eliminación de ruido del refinamiento de forma: utilizar pasos adicionales puede producir una geometría más suave, pero reduce la velocidad.

shape_slat_rescale_t predeterminado 3

Establece la nitidez de los detalles geométricos mediante el programa de ruido del refinamiento de forma; aumentar este valor produce detalles más nítidos.

tex_slat_guidance_strength predeterminado 1

Control de fidelidad del color de la textura: una mayor correspondencia con los colores de la imagen de entrada aumenta la viveza, pero puede causar sobresaturación.

tex_slat_guidance_rescale predeterminado 0

Aumenta este valor para corregir texturas con ruido o bandas de color: reduce los artefactos causados por una guía intensa durante la etapa de textura.

tex_slat_guidance_interval_start predeterminado 0.6

Punto de activación de la guía sin clasificador para la generación de texturas en la etapa 3. Expresado como fracción del progreso de reducción de ruido, establece interval_start; la guía solo opera dentro de la ventana delimitada por interval_start e interval_end.

tex_slat_guidance_interval_end predeterminado 0.9

Límite de guía para la etapa 3 (textura): elige un valor al menos igual a tex_slat_guidance_interval_start. El valor identifica la fracción de reducción de ruido alcanzada cuando se detiene la guía sin clasificador.

tex_slat_sampling_steps predeterminado 12

Número de pasos de eliminación de ruido utilizados para generar texturas. Aumentarlo requiere más tiempo, pero puede producir texturas más limpias.

tex_slat_rescale_t predeterminado 3

Establece la nitidez de los detalles de textura mediante el programa de ruido de generación de texturas; aumentar este valor produce detalles más nítidos.

decimation_target predeterminado 500000

Objetivo de número de vértices de la malla: se recomiendan 500k para uso general y 20k–50k para web/móvil. Reducir el objetivo intercambia detalle de malla por archivos más pequeños.

remesh_band predeterminado 1

Margen de movimiento del remallado: un suavizado adicional puede sacrificar detalles finos al aumentar este valor. El ajuste limita el desplazamiento de los vértices respecto a la superficie original.

remesh_project predeterminado 0

Intensidad de proyección para devolver los vértices remallados a la superficie original: 1 conserva los detalles mediante una proyección completa, mientras que 0 desactiva la proyección para obtener un resultado más suave.

uv_unwrap_angle_threshold_deg predeterminado 90

Límite angular de los mapas UV en grados, que restringe cuánto pueden diferir las normales de caras vecinas dentro de un mapa. Aumentar el límite favorece menos mapas y más grandes, con riesgo de estiramiento; reducirlo favorece más mapas y menos distorsión.

uv_unwrap_refine_iterations predeterminado 0

Número de pasadas de refinamiento local usadas para calcular los mapas UV.

uv_unwrap_global_iterations predeterminado 1

El equilibrio de los mapas UV puede mejorar aumentando este número de pasadas de agrupación global usadas para calcularlos.

uv_unwrap_smooth_strength predeterminado 1

Ajusta la intensidad con la que se suavizan los bordes de los mapas UV; unos ajustes más altos producen costuras menos visibles, pero con riesgo de distorsión UV.

seed

Semilla utilizada para una generación aleatoria reproducible.

POST /run/trellis-2?wait=20 presupuesto → 0,30 $

# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/trellis-2?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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

const API = "https://api.doitong.ru/v1";
const headers = {
  "Authorization": "Bearer " + process.env.DOITONG_API_KEY,
  "Content-Type": "application/json",
};

// Run the model; wait up to 20 s for the finished result in the same call
let res = await fetch(API + "/run/trellis-2?wait=20", {
  method: "POST",
  headers,
  body: JSON.stringify({
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }),
});
let request = await res.json();
if (!res.ok) throw new Error(request.error.code + ": " + request.error.message);

// Not finished yet: long-poll until it is
while (request.status === "queued" || request.status === "running") {
  res = await fetch(API + "/requests/" + request.id + "?wait=20", { headers });
  request = await res.json();
}
if (request.status !== "succeeded") throw new Error(JSON.stringify(request.error));
console.log(request.outputs.map((o) => o.url), request.cost.credits + " API credits ($" + request.cost.usd + ")");

import os
import requests

API = "https://api.doitong.ru/v1"
headers = {"Authorization": "Bearer " + os.environ["DOITONG_API_KEY"]}

payload = {
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
}

# Run the model; wait up to 20 s for the finished result in the same call
r = requests.post(API + "/run/trellis-2", params={"wait": 20}, json=payload, headers=headers)
request = r.json()
if not r.ok:
    raise RuntimeError(request["error"]["code"] + ": " + request["error"]["message"])

# Not finished yet: long-poll until it is
while request["status"] in ("queued", "running"):
    request = requests.get(API + "/requests/" + request["id"], params={"wait": 20}, headers=headers).json()
if request["status"] != "succeeded":
    raise RuntimeError(request["error"])
print([o["url"] for o in request["outputs"]], request["cost"]["credits"], "API credits", "$" + request["cost"]["usd"])

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "run",
    "arguments": {
      "model_id": "trellis-2",
      "input": {
        "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
      },
      "wait_seconds": 20
    }
  }
}

Ejecutar esta solicitud

Clave de API

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

Acerca de Trellis 2

Crea un recurso 3D a partir de una imagen (`image_url`) y devuelve un archivo GLB. `resolution` es 512, 1024 o 1536, y `texture_size` es 1024, 2048 o 4096. Cada una de las tres fases (estructura, forma y textura) tiene sus propios controles de guía y pasos de muestreo. `decimation_target` establece el número de vértices de la malla (5,000 a 2,000,000), y se ofrecen opciones de remallado y desenvoltura UV.

Parámetros

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

NombreTipo PredeterminadoPermitido Descripción

seedopcional

Tipointeger | null

Semilla utilizada para una generación aleatoria reproducible.

resolutionopcional

Tipoenum

Predeterminado1024

51210241536

Resolución de la salida; aumentarla añade detalles, pero requiere más tiempo.

ss_guidance_strengthopcional

Tiponumber

Predeterminado7.5

0 – 10

Control de fidelidad de la estructura 3D inicial: aumentarlo favorece una mayor correspondencia con la imagen de entrada, a costa de un posible ruido adicional.

ss_guidance_rescaleopcional

Tiponumber

Predeterminado0.7

0 – 1

Control de artefactos de guía de la etapa 1: los valores bajos intensifican los efectos de la guía y los altos producen una salida más estable.

ss_guidance_interval_startopcional

Tiponumber

Predeterminado0.6

0 – 1

ss_guidance_interval_endopcional

Tiponumber

Predeterminado1

0 – 1

ss_sampling_stepsopcional

Tipointeger

Predeterminado12

1 – 50

Número de pasos de eliminación de ruido de la estructura inicial: las posibles mejoras de calidad de los pasos adicionales implican un procesamiento más lento.

ss_rescale_topcional

Tiponumber

Predeterminado5

1 – 6

Establece la nitidez de la transición mediante el programa de ruido de generación de la estructura: aumentar este valor hace que las transiciones sean más nítidas.

shape_slat_guidance_strengthopcional

Tiponumber

Predeterminado7.5

0 – 10

Control de fidelidad de la geometría detallada: aumentar la correspondencia con la imagen de entrada añade detalles, con riesgo de ruido adicional.

shape_slat_guidance_rescaleopcional

Tiponumber

Predeterminado0.5

0 – 1

Aumenta este valor cuando la geometría tenga ruido: reduce los artefactos causados por una guía intensa durante la etapa de forma.

shape_slat_guidance_interval_startopcional

Tiponumber

Predeterminado0.6

0 – 1

shape_slat_guidance_interval_endopcional

Tiponumber

Predeterminado1

0 – 1

shape_slat_sampling_stepsopcional

Tipointeger

Predeterminado12

1 – 50

Número de pasos de eliminación de ruido del refinamiento de forma: utilizar pasos adicionales puede producir una geometría más suave, pero reduce la velocidad.

shape_slat_rescale_topcional

Tiponumber

Predeterminado3

1 – 6

Establece la nitidez de los detalles geométricos mediante el programa de ruido del refinamiento de forma; aumentar este valor produce detalles más nítidos.

tex_slat_guidance_strengthopcional

Tiponumber

Predeterminado1

0 – 10

Control de fidelidad del color de la textura: una mayor correspondencia con los colores de la imagen de entrada aumenta la viveza, pero puede causar sobresaturación.

tex_slat_guidance_rescaleopcional

Tiponumber

Predeterminado0

0 – 1

Aumenta este valor para corregir texturas con ruido o bandas de color: reduce los artefactos causados por una guía intensa durante la etapa de textura.

tex_slat_guidance_interval_startopcional

Tiponumber

Predeterminado0.6

0 – 1

tex_slat_guidance_interval_endopcional

Tiponumber

Predeterminado0.9

0 – 1

tex_slat_sampling_stepsopcional

Tipointeger

Predeterminado12

1 – 50

Número de pasos de eliminación de ruido utilizados para generar texturas. Aumentarlo requiere más tiempo, pero puede producir texturas más limpias.

tex_slat_rescale_topcional

Tiponumber

Predeterminado3

1 – 6

Establece la nitidez de los detalles de textura mediante el programa de ruido de generación de texturas; aumentar este valor produce detalles más nítidos.

decimation_targetopcional

Tipointeger

Predeterminado500000

5000 – 2.000.000

Objetivo de número de vértices de la malla: se recomiendan 500k para uso general y 20k–50k para web/móvil. Reducir el objetivo intercambia detalle de malla por archivos más pequeños.

texture_sizeopcional

Tipoenum

Predeterminado2048

102420484096

Resolución de textura de la malla para el baking. Una mayor resolución aporta más detalles de superficie, pero genera archivos más grandes.

remeshopcional

Tipoboolean

Predeterminadotrue

Reconstrucción de la topología que crea triángulos de malla más limpios, normalmente mejorando la idoneidad para usos posteriores como animación o impresión 3D, a costa de un procesamiento más lento.

remesh_bandopcional

Tiponumber

Predeterminado1

0 – 4

remesh_projectopcional

Tiponumber

Predeterminado0

0 – 1

uv_unwrap_angle_threshold_degopcional

Tiponumber

Predeterminado90

0 – 180

uv_unwrap_refine_iterationsopcional

Tipointeger

Predeterminado0

0 – 10

Número de pasadas de refinamiento local usadas para calcular los mapas UV.

uv_unwrap_global_iterationsopcional

Tipointeger

Predeterminado1

1 – 10

El equilibrio de los mapas UV puede mejorar aumentando este número de pasadas de agrupación global usadas para calcularlos.

uv_unwrap_smooth_strengthopcional

Tiponumber

Predeterminado1

0 – 10

Ajusta la intensidad con la que se suavizan los bordes de los mapas UV; unos ajustes más altos producen costuras menos visibles, pero con riesgo de distorsión UV.

image_urlobligatorio image

Tipourl · image

URL que apunta a la imagen de origen para la conversión 3D.

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 subida. Archivos

Salida

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t

{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "trellis-2",
  "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": 300,
    "usd": "0.30",
    "charged": 300,
    "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
    }
  },
  "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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}

Tus archivos, tú eligesCada outputs[].url es una copia en nuestro almacenamiento: conservada para siempre (con pago 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}Modelo 3D generado en formato GLB.

Más modelos: Imagen a 3D

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

Tu primer resultado aparecerá aquí

Crear una solicitud

Ejecutar esta solicitud

Acerca de Trellis 2

Parámetros

Salida

Otras variantes de Trellis 2

Trellis 2 · Retexture Variantes: 2

Más modelos: Imagen a 3D

Trellis Variantes: 2

Trellis · Multi Variantes: 2

TRELLIS.2 LoRA Inference

Hi3D Image to 3D Variantes: 6