Retexturation du modèle

POST /v3/models/texture

Régénérez les cartes de texture pour un modèle existant.

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_`, un file_token commençant par `file_`, ou un URL commençant par `http(s)://`
model	chaîne	Non	`v3.0-20250812`	Version du modèle de texture. Valeurs prises en charge : `v3.5-20260815`, `v3.0-20250812`, `v2.5-20250123`
texture_seed	entier	Non	Aléatoire	Graine aléatoire pour la génération de texture
texture_quality	chaîne	Non	`standard`	Qualité des textures. Valeurs disponibles : `fast` (nécessite `model=v3.5-20260815`), `standard`, `detailed`, `extreme`
pbr	booléen	Non	`true`	Activer les matériaux PBR
delight	booléen	Non	`true`	Supprime l’éclairage incrusté de l’image de référence avant le texturage. Pris en compte uniquement lorsque `model=v3.5-20260815`

Exemples de demande

curl -X POST https://openapi.tripo3d.ai/v3/models/texture \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {api_key}" \
  -d '{
    "input": "task_abc123",
    "texture_quality": "detailed",
    "pbr": true
  }'

import requests

url = "https://openapi.tripo3d.ai/v3/models/texture"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer {api_key}"
}
payload = {
    "input": "task_abc123",
    "texture_quality": "detailed",
    "pbr": True
}

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

const url = "https://openapi.tripo3d.ai/v3/models/texture";

const response = await fetch(url, {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer {api_key}"
  },
  body: JSON.stringify({
    input: "task_abc123",
    texture_quality: "detailed",
    pbr: 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	Identifiant de tâche unique utilisé pour interroger la progression et les résultats de la génération

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ètres 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	Confirmez que le type de tâche pour le `task_id` est correct
400	2007	La tâche source ne s’est pas terminée avec succès	Attendez que la tâche source soit terminée avant de commencer la retexturation
403	2010	Crédits insuffisants	Recharger des crédits et réessayer