# 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](https://developers.tripo3d.com)

## Basis URL

```baseurl
https://openapi.tripo3d.ai/v3
```

## Authentifizierung

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

```apikey
Authorization: Bearer {api_key}
```

Sie können API Keys in der [Tripo-Konsole](/en/keys) erstellen und verwalten.

## Einheitliches Antwortformat

### Erfolgsantwort

```json
{
  "code": 0,
  "data": {
    ...
  }
}
```

### Fehlerreaktion

```json
{
  "code": 2010,
  "message": "Insufficient credits",
  "suggestion": "Please top up your account"
}
```

### 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 |
| 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 |

## 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`](/en/docs/generation-text-to-model) | Generieren Sie ein 3D-Modell aus Text |
| [`POST /v3/generation/image-to-model`](/en/docs/generation-image-to-model) | Generieren Sie ein 3D-Modell aus einem Bild |
| [`POST /v3/generation/multiview-to-model`](/en/docs/generation-multiview-to-model) | Generieren Sie ein 3D-Modell aus Multiview-Bildern |

### Bilderzeugung

| Endpunkt | Beschreibung |
| :-: | :-: |
| [`POST /v3/generation/text-to-image`](/en/docs/generation-text-to-image) | Erzeugen Sie ein Bild aus Text |
| [`POST /v3/generation/image-to-image`](/en/docs/generation-image-to-image) | Transformieren Sie einen Bildstil |
| [`POST /v3/generation/image-to-multiview`](/en/docs/generation-image-to-multiview) | Generieren Sie Multiview-Bilder |
| [`POST /v3/generation/edit-multiview`](/en/docs/generation-edit-multiview) | Bearbeiten Sie Multiview-Bilder |

### Modellverarbeitung

| Endpunkt | Beschreibung |
| :-: | :-: |
| [`POST /v3/models/texture`](/en/docs/models-texture) | Texturieren Sie ein Modell |
| [`POST /v3/models/convert`](/en/docs/models-convert) | Modellformat konvertieren |
| [`POST /v3/mesh/segment`](/en/docs/mesh-segment) | Semantische Segmentierung |
| [`POST /v3/mesh/complete`](/en/docs/mesh-complete) | Netzvervollständigung |
| [`POST /v3/mesh/decimate`](/en/docs/mesh-decimate) | Retopologie |

### Animation

| Endpunkt | Beschreibung |
| :-: | :-: |
| [`POST /v3/animations/rig-check`](/en/docs/animations-rig-check) | Prüfen Sie die Rigging-Kompatibilität |
| [`POST /v3/animations/rig`](/en/docs/animations-rig) | Bauen Sie ein Modell auf |
| [`POST /v3/animations/retarget`](/en/docs/animations-retarget) | Retargeting einer Animation |

### Aufgabenverwaltung

| Endpunkt | Beschreibung |
| :-: | :-: |
| [`GET /v3/tasks/{task_id}`](/en/docs/task-query) | Fragen Sie eine Aufgabe ab |
| [`POST /v3/tasks/list`](/en/docs/task-batch-query) | Aufgaben im Batch abfragen |

### Dateiverwaltung

| Endpunkt | Beschreibung |
| :-: | :-: |
| [`POST /v3/files`](/en/docs/files) | Laden Sie eine Datei hoch |

### Konto

| Endpunkt | Beschreibung |
| :-: | :-: |
| [`GET /v3/account/balance`](/en/docs/account) | Kontostand abfragen |