Diezmado de malla

POST /v3/mesh/decimate

Reduzca el número de polígonos del modelo y convierta un modelo con alto contenido de polígonos en un modelo con bajo nivel de polígonos.

Solicitar parámetros

Encabezados de solicitud

Parámetro	Tipo	Requerido	Predeterminado	Descripción
Content-Type	cadena	si	—	`application/json`
Authorization	cadena	si	—	`Bearer {api_key}`

Cuerpo de solicitud

Parámetro	Tipo	Requerido	Predeterminado	Descripción
input	cadena	si	—	Fuente del modelo. Acepta un task_id que comienza con `task_` o un file_token que comienza con `file_`
model	cadena	No	`v2.0`	Versión de retopología: `v3.0` (35 créditos triángulos / 40 cuadriláteros, admite `smart_uv`), `v2.0` (30 créditos), `v1.0` (decimación básica)
face_limit	entero	No	Adaptativo	Número de caras objetivo. v3.0 / v2.0: triángulos 500–20000, cuadriláteros 500–10000 (adaptativo si se omite). v1.0: obligatorio, triángulos hasta 2000000, cuadriláteros hasta 150000
quad	booleano	No	`false`	Generar una malla cuádruple
part_names	cadena []	No	—	Lista de nombres de piezas para diezmar
bake	booleano	No	`true`	Hornea texturas en el modelo low-poly.
smart_uv	booleano	No	`false`	Desplegar UV durante la retopología. Solo válido con `model=v3.0`; otras versiones devuelven 400 (1004). Sin coste adicional

Ejemplos de solicitudes

curl -X POST https://openapi.tripo3d.ai/v3/mesh/decimate \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {api_key}" \
  -d '{
    "input": "task_abc123",
    "face_limit": 5000,
    "quad": false,
    "bake": true
  }'

import requests

url = "https://openapi.tripo3d.ai/v3/mesh/decimate"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer {api_key}"
}
payload = {
    "input": "task_abc123",
    "face_limit": 5000,
    "quad": False,
    "bake": True
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())

const url = "https://openapi.tripo3d.ai/v3/mesh/decimate";

const response = await fetch(url, {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer {api_key}"
  },
  body: JSON.stringify({
    input: "task_abc123",
    face_limit: 5000,
    quad: false,
    bake: true
  })
});

const data = await response.json();
console.log(data);

Respuesta

Respuesta exitosa

JSON

{
  "code": 0,
  "data": {
    "task_id": "task_def456"
  }
}

Campos de respuesta

Parámetro	Tipo	Descripción
code	entero	Código de estado. `0` indica éxito
data.task_id	cadena	Identificador de tarea único utilizado para sondear el progreso y el resultado de la decimación.

Códigos de error

Código de estado HTTP	Código de error	Descripción	Recomendación
429	2000	Límite de generación excedido	Reduzca la tasa de solicitudes y vuelva a intentarlo más tarde
400	2002	Parámetro de solicitud no admitido	Verifique los nombres de los parámetros del cuerpo de la solicitud y los rangos de valores
400	2006	Tipo de tarea de fuente de entrada no válida	Confirmar que el task_id corresponde a una tarea de modelo 3D
400	2007	El estado de la tarea de origen no es exitoso	Espere hasta que se complete la tarea de origen antes de comenzar la diezma
403	2010	Créditos insuficientes	Recarga créditos y vuelve a intentarlo