Tripo3D

Einführung in den Tripo API

Einführung in den Tripo API

Tripo3D ist eine AI–basierte 3D-Generierungsplattform, die Text-zu-3D, Bild-zu-3D, Rigging, Netzbearbeitung und andere Funktionen bietet. Mit dem Tripo API können Entwickler die Generierung hochwertiger 3D-Inhalte in ihre eigenen Produkte integrieren.

Wenn Sie aus China zugreifen, besuchen Sie bitte die China-Website: developers.tripo3d.com

Basis URL

https://openapi.tripo3d.ai/v3

Authentifizierung

Alle API-Anfragen müssen einen API Key im Anfrageheader enthalten:

Authorization: Bearer {api_key}

Sie können API Keys in der Tripo-Konsole erstellen und verwalten.

Einheitliches Antwortformat

Erfolgsantwort

JSON
{
  "code": 0,
  "data": {
    ...
  }
}

Fehlerreaktion

JSON
{
  "code": 2010,
  "status": "error",
  "message": "You don't have enough credit to create this task",
  "suggestion": "Please purchase more credit",
  "request_id": "req_abc123"
}

Gemeinsame Felder

Parameter Typ Beschreibung
code ganze Zahl Statuscode. 0 zeigt einen Erfolg an, und jeder Wert, der nicht 0 ist, weist auf einen Fehler hin
status Zeichenfolge error bei einem Fehler
data Objekt Geschäftsdaten, die nur bei Erfolg zurückgegeben werden
message Zeichenfolge Fehlerbeschreibung, wird nur bei Fehler zurückgegeben
suggestion Zeichenfolge Vorgeschlagener Fix, der nur bei einem Fehler zurückgegeben wird
request_id Zeichenfolge Eindeutige Anforderungskennung zur Fehlerbehebung, wird bei einem Fehler zurückgegeben

Asynchrones Aufgabenmuster

Die meisten APIs der Generation verwenden ein asynchrones Aufgabenmuster:

  1. Eine Aufgabe erstellen – Senden Sie eine POST-Anfrage, um eine Aufgabe zu erstellen und eine task_id zu erhalten
  2. Umfrage nach Ergebnissen – Verwenden Sie GET /v3/tasks/{task_id}, um den Aufgabenstatus und das Ergebnis abzufragen
POST /v3/generation/text-to-model  ->  {"code": 0, "data": {"task_id": "task_abc123"}}
                                                |
                                                v
GET  /v3/tasks/task_abc123          ->  {"code": 0, "data": {"status": "running", "progress": 50}}
                                                |
                                                v
GET  /v3/tasks/task_abc123          ->  {"code": 0, "data": {"status": "success", "output": {...}}}

Aufgabenstatus

Status Beschreibung
queued In der Warteschlange
running Laufen
success Erfolgreich
failed Fehlgeschlagen
cancelled Abgesagt

API-Version

Aktuelle Version: v3

Endpunktübersicht

3D-Modellgenerierung

Endpunkt Beschreibung
POST /v3/generation/text-to-model Generieren Sie ein 3D-Modell aus Text
POST /v3/generation/image-to-model Generieren Sie ein 3D-Modell aus einem Bild
POST /v3/generation/multiview-to-model Generieren Sie ein 3D-Modell aus Multiview-Bildern

Bilderzeugung

Endpunkt Beschreibung
POST /v3/generation/text-to-image Erzeugen Sie ein Bild aus Text
POST /v3/generation/image-to-image Transformieren Sie einen Bildstil
POST /v3/generation/image-to-multiview Generieren Sie Multiview-Bilder
POST /v3/generation/edit-multiview Bearbeiten Sie Multiview-Bilder

Modellverarbeitung

Endpunkt Beschreibung
POST /v3/models/texture Texturieren Sie ein Modell
POST /v3/models/convert Modellformat konvertieren
POST /v3/mesh/segment Semantische Segmentierung
POST /v3/mesh/complete Netzvervollständigung
POST /v3/mesh/decimate Retopologie

Animation

Endpunkt Beschreibung
POST /v3/animations/rig-check Prüfen Sie die Rigging-Kompatibilität
POST /v3/animations/rig Bauen Sie ein Modell auf
POST /v3/animations/retarget Retargeting einer Animation

Aufgabenverwaltung

Endpunkt Beschreibung
GET /v3/tasks/{task_id} Fragen Sie eine Aufgabe ab
POST /v3/tasks/list Aufgaben im Batch abfragen

Dateiverwaltung

Endpunkt Beschreibung
POST /v3/files Laden Sie eine Datei hoch

Konto

Endpunkt Beschreibung
GET /v3/account/balance Kontostand abfragen
Als nächstesSchnellstart