Conversion de format de modèle

POST /v3/models/convert

Convertissez un modèle 3D dans un autre format.

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ètres de base

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_`
format	chaîne	Oui	-	Format cible. Valeurs disponibles : `GLTF`, `USDZ`, `FBX`, `OBJ`, `STL`, `3MF`. 3MF : 3D avec une seule couleur.

Options de maillage

Paramètre	Tapez	Obligatoire	Par défaut	Descriptif
quad	booléen	Non	`false`	Remaillage quadruple
force_symmetry	booléen	Non	`false`	Symétrie des forces. Valable uniquement lorsque `quad` est `true`
face_limit	entier	Non	-	Nombre maximal de polycomptes. En cas d’omission, le nombre de visages d’origine est conservé
flatten_bottom	booléen	Non	`false`	Aplatir le fond
flatten_bottom_threshold	flotter	Non	`0.01`	Seuil de profondeur d’aplatissement

Options de textures

Paramètre	Tapez	Obligatoire	Par défaut	Descriptif
texture_size	entier	Non	`4096`	Taille de la texture diffuse en pixels
texture_format	chaîne	Non	`JPEG`	Format des textures. Valeurs disponibles : `BMP`, `DPX`, `HDR`, `JPEG`, `PNG`, `TARGA`, `TIFF`, `WEBP`
bake	booléen	Non	`true`	Intégrez des matériaux avancés dans des textures de base
pack_uv	booléen	Non	`false`	Regroupez tous les UV dans une disposition unifiée
export_vertex_colors	booléen	Non	`false`	Incluez les couleurs des sommets. Valable uniquement pour les formats `OBJ` et `GLTF`

Options d’exportation

Paramètre	Tapez	Obligatoire	Par défaut	Descriptif
pivot_to_center_bottom	booléen	Non	`false`	Déplacez le pivot en bas au centre
scale_factor	flotter	Non	`1`	Facteur d’échelle
with_animation	booléen	Non	`true`	Inclure les données de squelette et d’animation
animate_in_place	booléen	Non	`false`	Animation sur place
part_names	chaîne[]	Non	-	Noms des pièces à exporter, à partir des données mesh/segment
export_orientation	chaîne	Non	`+x`	Orientation export. Valeurs disponibles : `-x`, `-y`, `+y`
fbx_preset	chaîne	Non	`blender`	Préréglage FBX pour la compatibilité. Valeurs disponibles : `blender`, `3dsmax`, `mixamo`, `bake_scale`

Exemples de demande

curl -X POST https://openapi.tripo3d.ai/v3/models/convert \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {api_key}" \
  -d '{
    "input": "task_abc123",
    "format": "FBX",
    "quad": true,
    "face_limit": 8000,
    "texture_size": 2048,
    "texture_format": "PNG",
    "pivot_to_center_bottom": true,
    "fbx_preset": "blender"
  }'

import requests

url = "https://openapi.tripo3d.ai/v3/models/convert"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer {api_key}"
}
payload = {
    "input": "task_abc123",
    "format": "FBX",
    "quad": True,
    "face_limit": 8000,
    "texture_size": 2048,
    "texture_format": "PNG",
    "pivot_to_center_bottom": True,
    "fbx_preset": "blender"
}

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

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

const response = await fetch(url, {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer {api_key}"
  },
  body: JSON.stringify({
    input: "task_abc123",
    format: "FBX",
    quad: true,
    face_limit: 8000,
    texture_size: 2048,
    texture_format: "PNG",
    pivot_to_center_bottom: true,
    fbx_preset: "blender"
  })
});

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 lancer la conversion
403	2010	Crédits insuffisants	Recharger des crédits et réessayer