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 existente sin textura 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, 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 referencia usada para aplicar texturas.

resolution predeterminado 1024

El detalle 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 aplicar nuevas texturas a 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. Un mayor detalle de superficie implica archivos más grandes cuando se aumenta esta resolución.

predeterminado 1

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

predeterminado 0

Aumenta esta configuración para corregir texturas ruidosas 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 una fracción del progreso de eliminació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 eliminación de ruido no menor que tex_slat_guidance_interval_start.

predeterminado 12

Cantidad de pasos de eliminación de ruido utilizados para generar texturas. Aumentarla 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 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 en 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 usada para aplicar texturas.
mesh_urlobligatorio
Tipostring
URL de origen para aplicar nuevas texturas a 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
El detalle 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 correspondencia con los colores de la imagen de entrada en valores altos aumenta la viveza, pero puede causar sobresaturación.
tex_slat_guidance_rescaleopcional
Tiponumber
Predeterminado0
0 – 1
Aumenta esta configuración para corregir texturas ruidosas 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 una fracción del progreso de eliminació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 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 utilizados para generar texturas. Aumentarla 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 horneado. Un mayor detalle de superficie implica archivos más grandes cuando se aumenta esta resolución.
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: 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}Modelo 3D generado en formato GLB.

Más modelos: Imagen a 3D

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