Conversione del formato del modello

POST /v3/models/convert

Converti un modello 3D in un altro formato.

Richiedi parametri

Richiedi intestazioni

Parametro	Digitare	Obbligatorio	Predefinito	Descrizione
Content-Type	stringa	Sì	-	`application/json`
Authorization	stringa	Sì	-	`Bearer {api_key}`

Richiedi corpo

Parametri di base

Parametro	Digitare	Obbligatorio	Predefinito	Descrizione
input	stringa	Sì	-	Fonte del modello. Accetta uno task_id che inizia con `task_` o uno file_token che inizia con `file_`
format	stringa	Sì	-	Formato di destinazione. Valori disponibili: `GLTF`, `USDZ`, `FBX`, `OBJ`, `STL`, `3MF`. 3MF: 3D con un solo colore.

Opzioni di rete

Parametro	Digitare	Obbligatorio	Predefinito	Descrizione
quad	booleano	No	`false`	Remeshing quadruplo
force_symmetry	booleano	No	`false`	Simmetria delle forze. Valido solo quando `quad` è `true`
face_limit	intero	No	-	Numero massimo di poligoni. Se omesso, viene mantenuto il conteggio dei volti originale
flatten_bottom	booleano	No	`false`	Fondo appiattito
flatten_bottom_threshold	galleggiare	No	`0.01`	Soglia di profondità di appiattimento

Opzioni di trama

Parametro	Digitare	Obbligatorio	Predefinito	Descrizione
texture_size	intero	No	`4096`	Dimensioni della trama diffusa in pixel
texture_format	stringa	No	`JPEG`	Formato della trama. Valori disponibili: `BMP`, `DPX`, `HDR`, `JPEG`, `PNG`, `TARGA`, `TIFF`, `WEBP`
bake	booleano	No	`true`	Cuoci materiali avanzati in texture di base
pack_uv	booleano	No	`false`	Riunisci tutti gli UV in un layout unificato
export_vertex_colors	booleano	No	`false`	Includi i colori dei vertici. Valido solo per i formati `OBJ` e `GLTF`

Opzioni di esportazione

Parametro	Digitare	Obbligatorio	Predefinito	Descrizione
pivot_to_center_bottom	booleano	No	`false`	Spostare il perno in basso al centro
scale_factor	galleggiare	No	`1`	Fattore di scala
with_animation	booleano	No	`true`	Includi dati di scheletro e animazione
animate_in_place	booleano	No	`false`	Animazione sul posto
part_names	stringa[]	No	-	Nomi delle parti da esportare, dai dati mesh/segment
export_orientation	stringa	No	`+x`	Orientamento all’esportazione. Valori disponibili: `-x`, `-y`, `+y`
fbx_preset	stringa	No	`blender`	FBX preimpostato per compatibilità. Valori disponibili: `blender`, `3dsmax`, `mixamo`, `bake_scale`

Richiedi esempi

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

Risposta

Risposta riuscita

JSON

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

Campi di risposta

Parametro	Digitare	Descrizione
code	intero	Codice di stato. `0` indica successo
data.task_id	stringa	Identificatore univoco dell’attività utilizzato per interrogare l’avanzamento e i risultati della generazione

Codici di errore

HTTP Codice di stato	Codice errore	Descrizione	Raccomandazione
429	2000	Limite di generazione superato	Ridurre la frequenza delle richieste e riprovare più tardi
400	2002	Parametri di richiesta non supportati	Controllare i nomi dei parametri del corpo della richiesta e gli intervalli di valori
400	2006	Tipo di attività di origine di input non valido	Confermare che il tipo di attività per `task_id` sia corretto
400	2007	L’attività di origine non è stata completata correttamente	Attendi il completamento dell’attività di origine prima di avviare la conversione
403	2010	Crediti insufficienti	Ricaricare i crediti e riprovare