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 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 referencia utilizada para texturizar.

resolution predeterminado 1024

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

•obligatorio

URL de origen para volver a texturizar una malla 3D sin texturas 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 horneado. Una mayor resolución aporta detalles de superficie más finos, pero genera archivos más grandes.

predeterminado 1

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

predeterminado 0

Aumente 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 orientación sin clasificador para la generación de texturas. Expresado como fracción del progreso de reducción de ruido, establece interval_start; la orientación opera solo dentro de la ventana delimitada por interval_start y interval_end.

predeterminado 0.9

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

predeterminado 12

Cantidad de pasos de eliminación de ruido utilizados para generar texturas. Aumentarla tarda más, pero puede producir texturas más limpias.

predeterminado 3

Establezca 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 cotización → 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 se guarda (localStorage) únicamente si marcas Recordar. Obtener una clave de API

Acerca de Trellis 2 · Retexture

Aplica una textura nueva 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 etapa de textura. La geometría no se regenera.

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 referencia utilizada para texturizar.
mesh_urlobligatorio
Tipostring
URL de origen para volver a texturizar una malla 3D sin texturas en formato GLB, OBJ, PLY o STL.
seedopcional
Tipointeger | null
Semilla utilizada para una generación aleatoria reproducible.
resolutionopcional
Tipoenum
Predeterminado1024
5121024
Los detalles de la textura y la velocidad de procesamiento dependen de esta resolución interna de generación: 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 adhesión a los colores de la imagen de entrada aumenta la viveza, pero puede causar sobresaturación.
tex_slat_guidance_rescaleopcional
Tiponumber
Predeterminado0
0 – 1
Aumente 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 orientación sin clasificador para la generación de texturas. Expresado como fracción del progreso de reducción de ruido, establece interval_start; la orientación opera solo dentro de la ventana delimitada por interval_start y interval_end.
tex_slat_guidance_interval_endopcional
Tiponumber
Predeterminado0.9
0 – 1
Límite de detención de la orientación sin clasificador de la etapa de textura, 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
Cantidad de pasos de eliminación de ruido utilizados para generar texturas. Aumentarla tarda más, pero puede producir texturas más limpias.
tex_slat_rescale_topcional
Tiponumber
Predeterminado3
1 – 6
Establezca 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 horneado. Una mayor resolución aporta detalles de superficie más finos, 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 carga. 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 (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}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/developers/models/trellis-2/retexture.md. Todos los modelos y guías: https://doitong.com/developers/llms.txt