Modell-Retexturierung

POST /v3/models/texture

Texturkarten für ein vorhandenes Modell neu generieren.

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 einen task_id, der mit `task_` beginnt, einen file_token, der mit `file_` beginnt, oder einen URL, der mit `http(s)://` beginnt
model	Zeichenfolge	Nein	`v3.0-20250812`	Texturmodellversion. Unterstützte Werte: `v3.5-20260815`, `v3.0-20250812`, `v2.5-20250123`
texture_seed	ganze Zahl	Nein	Zufällig	Zufälliger Startwert für die Texturgenerierung
texture_quality	Zeichenfolge	Nein	`standard`	Texturqualität. Verfügbare Werte: `fast` (erfordert `model=v3.5-20260815`), `standard`, `detailed`, `extreme`
pbr	Boolescher Wert	Nein	`true`	Aktivieren Sie PBR-Materialien
delight	Boolescher Wert	Nein	`true`	Entfernt eingebackenes Licht aus dem Referenzbild vor dem Texturieren. Wird nur bei `model=v3.5-20260815` berücksichtigt

Fordern Sie Beispiele an

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

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 Retexturierung beginnen
403	2010	Unzureichende Credits	Guthaben aufladen und erneut versuchen