Ir al contenido

Trellis 2 · Retexture

Integrar

ID del modelo trellis-2/retexture
# 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/retexture?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",
    "mesh_url": "https://example.com/your-file.glb"
  }'

# 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,24 $ 240 créditos de API Ejecutar en esta página

Obtener clave de API
Microsoft Imagen a 3D #image-to-3d

Vuelve a texturizar una malla 3D sin textura existente para que coincida con una imagen de referencia y genera GLB

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.

•obligatorio image_url
Suelta un archivo o

URL de la imagen de referencia usada para texturizar.

resolution predeterminado 1024

El detalle de la textura y la velocidad de procesamiento dependen de esta resolución de generación interna: aumentarla produce detalles más finos, pero tarda más.

•obligatorio

URL de origen para volver a texturizar una malla 3D sin textura en formato GLB, OBJ, PLY o STL.

Avanzado texture_size · 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 · seed
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.

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.

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.

predeterminado 0.6

Punto de activación de la guía sin clasificador para la generación de texturas. 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.

predeterminado 0.9

Límite de detención de la guía sin clasificador de la etapa de texturas, especificado como una fracción de reducción de ruido no inferior a tex_slat_guidance_interval_start.

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.

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.

Semilla utilizada para una generación aleatoria reproducible.

POST /run/trellis-2/retexture?wait=20 presupuesto → 0,24 $
# 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/retexture?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",
    "mesh_url": "https://example.com/your-file.glb"
  }'

# 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 solo se guarda en localStorage si marcas Recordar. Obtener una clave de API

Acerca de Trellis 2 · Retexture

Aplica una nueva textura a la malla de `mesh_url` (GLB, OBJ, PLY o STL) basándose en una `image_url` de referencia. `resolution` es 512 o 1024, y `texture_size` es 1024, 2048 o 4096. Hay controles de guía y muestreo para la fase de textura. La geometría no se regenera.

Parámetros

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

NombreTipo PredeterminadoPermitido Descripción
image_urlobligatorio image
Tipourl · image
URL de la imagen de referencia usada para texturizar.
mesh_urlobligatorio
Tipostring
URL de origen para volver a texturizar una malla 3D sin textura en formato GLB, OBJ, PLY o STL.
seedopcional
Tipointeger | null
Semilla utilizada para una generación aleatoria reproducible.
resolutionopcional
Tipoenum
Predeterminado1024
5121024
El detalle de la textura y la velocidad de procesamiento dependen de esta resolución de generación interna: aumentarla produce detalles más finos, pero tarda más.
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
Punto de activación de la guía sin clasificador para la generación de texturas. 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_endopcional
Tiponumber
Predeterminado0.9
0 – 1
Límite de detención de la guía sin clasificador de la etapa de texturas, especificado 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
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.
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.
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/retexture",
  "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": 240,
    "usd": "0.24",
    "charged": 240,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "mesh_url": "https://example.com/your-file.glb"
  },
  "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.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 (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/retexture.md. Todos los modelos y guías: https://doitong.com/developers/llms.txt