Smart UV

POST /v3/mesh/uv

Wickelt die UVs eines 3D-Modells neu ab und überträgt vorhandene Texturen, Rigging und Animationen auf das neue Layout.

Jede Aufgabe kostet 20 Credits. Das Ergebnis enthält model_url sowie eine UV-Layout-Vorschau uv_render_url. Das Eingabemodell darf 80.000 äquivalente Dreiecke nicht überschreiten (ein Viereck zählt als zwei); größere Modelle werden angenommen, die Aufgabe schlägt jedoch fehl und die Credits werden erstattet.

Anforderungsparameter

Anforderungsheader

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

Anforderungstext

Parameter	Typ	Erforderlich	Standard	Beschreibung
input	Zeichenfolge	Ja	—	Modellquelle. Akzeptiert eine task_id, ein file_token oder eine URL
model	Zeichenfolge	Nein	`default`	Smart-UV-Modellversion. Nur `default` wird unterstützt
bake	Boolescher Wert	Nein	`true`	Vorhandene Texturen auf das neue UV-Layout backen. Mit `false` wird nur die Geometrie mit UVs zurückgegeben
export_orientation	Zeichenfolge	Nein	—	Ausrichtung des exportierten Modells: `+x`, `-x`, `+y` oder `-y`
compress	Zeichenfolge	Nein	—	Komprimierungstyp. `geometry`: meshopt-Komprimierung

Fordern Sie Beispiele an

curl -X POST https://openapi.tripo3d.ai/v3/mesh/uv \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {api_key}" \
  -d '{
    "input": "task_abc123",
    "bake": true
  }'

import requests

url = "https://openapi.tripo3d.ai/v3/mesh/uv"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer {api_key}"
}
payload = {
    "input": "task_abc123",
    "bake": True
}

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

const url = "https://openapi.tripo3d.ai/v3/mesh/uv";

const response = await fetch(url, {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer {api_key}"
  },
  body: JSON.stringify({
    input: "task_abc123",
    bake: true
  })
});

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	Eindeutige Aufgabenkennung zum Abfragen von Fortschritt und Ergebnis

Fehlercodes

HTTP Statuscode	Fehlercode	Beschreibung	Empfehlung
429	2000	Generationslimit überschritten	Reduzieren Sie die Anforderungsrate und versuchen Sie es später erneut
400	1004	Ungültiger Parameter oder ungültige Eingabe	Parameternamen, Werte und Eingabequelle prüfen
403	2010	Unzureichende Credits	Guthaben aufladen und erneut versuchen