Modellformatkonvertierung

POST /v3/models/convert

Konvertieren Sie ein 3D-Modell in ein anderes Format.

Anforderungsparameter

Anforderungsheader

Parameter	Typ	Erforderlich	Standard	Beschreibung
Content-Type	Zeichenfolge	Ja	-	`application/json`
Authorization	Zeichenfolge	Ja	-	`Bearer {api_key}`

Anforderungstext

Grundparameter

Parameter	Typ	Erforderlich	Standard	Beschreibung
input	Zeichenfolge	Ja	-	Modellquelle. Akzeptiert einen task_id, der mit `task_` beginnt, oder einen file_token, der mit `file_` beginnt
format	Zeichenfolge	Ja	-	Zielformat. Verfügbare Werte: `GLTF`, `USDZ`, `FBX`, `OBJ`, `STL`, `3MF`. 3MF: 3D mit einer einzigen Farbe.

Mesh-Optionen

Parameter	Typ	Erforderlich	Standard	Beschreibung
quad	Boolescher Wert	Nein	`false`	Quad-Neuvernetzung
force_symmetry	Boolescher Wert	Nein	`false`	Kräftesymmetrie. Nur gültig, wenn `quad` `true` ist
face_limit	ganze Zahl	Nein	-	Maximale Polyanzahl. Wenn es weggelassen wird, bleibt die ursprüngliche Anzahl der Gesichter erhalten
flatten_bottom	Boolescher Wert	Nein	`false`	Boden abflachen
flatten_bottom_threshold	schweben	Nein	`0.01`	Schwellenwert für die Abflachungstiefe

Texturoptionen

Parameter	Typ	Erforderlich	Standard	Beschreibung
texture_size	ganze Zahl	Nein	`4096`	Größe der diffusen Textur in Pixeln
texture_format	Zeichenfolge	Nein	`JPEG`	Texturformat. Verfügbare Werte: `BMP`, `DPX`, `HDR`, `JPEG`, `PNG`, `TARGA`, `TIFF`, `WEBP`
bake	Boolescher Wert	Nein	`true`	Backen Sie fortschrittliche Materialien in Basistexturen
pack_uv	Boolescher Wert	Nein	`false`	Packen Sie alle UVs in ein einheitliches Layout
export_vertex_colors	Boolescher Wert	Nein	`false`	Scheitelpunktfarben einbeziehen. Nur gültig für die Formate `OBJ` und `GLTF`

Exportoptionen

Parameter	Typ	Erforderlich	Standard	Beschreibung
pivot_to_center_bottom	Boolescher Wert	Nein	`false`	Bewegen Sie den Drehpunkt nach unten in die Mitte
scale_factor	schweben	Nein	`1`	Skalierungsfaktor
with_animation	Boolescher Wert	Nein	`true`	Beziehen Sie Skelett- und Animationsdaten ein
animate_in_place	Boolescher Wert	Nein	`false`	Animation vor Ort
part_names	string[]	Nein	-	Namen der zu exportierenden Teile aus mesh/segment-Daten
export_orientation	Zeichenfolge	Nein	`+x`	Exportausrichtung. Verfügbare Werte: `-x`, `-y`, `+y`
fbx_preset	Zeichenfolge	Nein	`blender`	FBX aus Kompatibilitätsgründen voreingestellt. Verfügbare Werte: `blender`, `3dsmax`, `mixamo`, `bake_scale`

Fordern Sie Beispiele an

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

Antwort

Erfolgreiche Antwort

JSON

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

Antwortfelder

Parameter	Typ	Beschreibung
code	ganze Zahl	Statuscode. `0` zeigt Erfolg an
data.task_id	Zeichenfolge	Eindeutiger Aufgabenbezeichner, der zum Abfragen des Generierungsfortschritts und der Ergebnisse verwendet wird

Fehlercodes

HTTP Statuscode	Fehlercode	Beschreibung	Empfehlung
429	2000	Generationslimit überschritten	Reduzieren Sie die Anforderungsrate und versuchen Sie es später erneut
400	2002	Nicht unterstützte Anforderungsparameter	Überprüfen Sie die Parameternamen und Wertebereiche des Anforderungshauptteils
400	2006	Ungültiger Aufgabentyp der Eingabequelle	Bestätigen Sie, dass der Aufgabentyp für `task_id` korrekt ist
400	2007	Die Quellaufgabe wurde nicht erfolgreich abgeschlossen	Warten Sie, bis die Quellaufgabe abgeschlossen ist, bevor Sie mit der Konvertierung beginnen
403	2010	Unzureichende Credits	Guthaben aufladen und erneut versuchen