Décimation du maillage

POST /v3/mesh/decimate

Réduisez le nombre de polytypes du modèle et convertissez un modèle high-poly en un modèle low-poly.

Paramètres de la demande

En-têtes de demande

Paramètre	Tapez	Obligatoire	Par défaut	Descriptif
Content-Type	chaîne	Oui	—	`application/json`
Authorization	chaîne	Oui	—	`Bearer {api_key}`

Corps de la demande

Paramètre	Tapez	Obligatoire	Par défaut	Descriptif
input	chaîne	Oui	—	Source du modèle. Accepte un task_id commençant par `task_` ou un file_token commençant par `file_`
model	chaîne	Non	`v2.0`	Version de retopologie : `v3.0` (35 crédits triangles / 40 quads, prend en charge `smart_uv`), `v2.0` (30 crédits), `v1.0` (décimation de base)
face_limit	entier	Non	Adaptatif	Nombre de faces cible. v3.0 / v2.0 : triangles 500–20000, quads 500–10000 (adaptatif si omis). v1.0 : obligatoire, triangles jusqu’à 2000000, quads jusqu’à 150000
quad	booléen	Non	`false`	Générer un maillage quadruple
part_names	chaîne[]	Non	—	Liste des noms de pièces à décimer
bake	booléen	Non	`true`	Cuire les textures sur le modèle low-poly
smart_uv	booléen	Non	`false`	Déplier les UV pendant la retopologie. Valide uniquement avec `model=v3.0` ; les autres versions renvoient 400 (1004). Sans coût supplémentaire

Exemples de demande

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);

Réponse

Réponse réussie

JSON

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

Champs de réponse

Paramètre	Tapez	Descriptif
code	entier	Code d’état. `0` indique le succès
data.task_id	chaîne	Identificateur de tâche unique utilisé pour interroger la progression et le résultat de la décimation

Codes d’erreur

Code d’état HTTP	Code d’erreur	Descriptif	Recommandation
429	2000	Limite de génération dépassée	Réduisez le taux de demandes et réessayez plus tard
400	2002	Paramètre de requête non pris en charge	Vérifier les noms des paramètres du corps de la requête et les plages de valeurs
400	2006	Type de tâche source d’entrée non valide	Confirmer que le task_id correspond à une tâche de modèle 3D
400	2007	L’état de la tâche source n’a pas réussi	Attendez la fin de la tâche source avant de commencer la décimation
403	2010	Crédits insuffisants	Recharger les crédits et réessayer