# Modell importieren
> **POST** `/v3/models/import`
Importieren Sie eine externe 3D-Modelldatei in die Tripo-Plattform.
> Die gezeigten Aufgaben-IDs sind Beispiele. Ersetzen Sie sie durch die von der API zurückgegebenen IDs.
## 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 | - | Modelldateiquelle. Akzeptiert einen file_token, der mit `file_` beginnt, oder einen URL, der mit `http(s)://` beginnt. Unterstützte Formate: GLB, GLTF, FBX, OBJ, STL, maximal 150 MB |
## Fordern Sie Beispiele an
### curl
```bash
curl -X POST https://openapi.tripo3d.ai/v3/models/import \
-H "Content-Type: application/json" \
-H "Authorization: Bearer {api_key}" \
-d '{
"input": "file_abc123"
}'
```
### Python
```python
import requests
url = "https://openapi.tripo3d.ai/v3/models/import"
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer {api_key}"
}
payload = {
"input": "file_abc123"
}
response = requests.post(url, headers=headers, json=payload)
print(response.json())
```
### JavaScript
```javascript
const url = "https://openapi.tripo3d.ai/v3/models/import";
const response = await fetch(url, {
method: "POST",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer {api_key}"
},
body: JSON.stringify({
input: "file_abc123"
})
});
const data = await response.json();
console.log(data);
```
## Antwort
### Erfolgreiche Antwort
```json
{
"code": 0,
"data": {
"task_id": "550e8400-e29b-41d4-a716-446655440001"
}
}
```
### 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 |
### Felder des Aufgabenergebnisses
Nach `status=success` liefert `GET /v3/tasks/{task_id}` diese Felder in `data.output`:
| Parameter | Typ | Beschreibung |
| :-: | :-: | :-: |
| model_url | string | Download-URL des importierten Modells |
| rendered_image_url | string | URL des gerenderten Vorschaubilds |
| normalize_scale | number | Gleichmäßiger Skalierungsfaktor, der bei der Normalisierung des importierten Modells angewendet wurde: `Größe nach Normalisierung = Größe vor Normalisierung × normalize_scale`. `1.0` bedeutet nicht skaliert, eine Verschiebung kann dennoch erfolgt sein. Teilt man die normalisierte Größe durch diesen Faktor, erhält man die Größe vor der Normalisierung; die Ausgabe der Plattform behält das normalisierte Ergebnis bei. Wird von Modell importieren sowie von Modell-Nachbearbeitungsaufgaben (Rigging, Texturierung, Konvertierung usw., die das Modell zuerst importieren) zurückgegeben, deren Modelleingabe ein `file_token` oder eine URL ist; nicht zurückgegeben für Eingaben per `task_id` und für Aufgaben, die vor Einführung dieses Felds erstellt wurden |
| normalize_translation | number[] | Verschiebungsvektor, der bei der Normalisierung des importierten Modells angewendet wurde, als `[tx, ty, tz]` (3 Zahlen). Zusammen mit `normalize_scale` verwenden: `Koordinate nach Normalisierung = Koordinate vor Normalisierung × normalize_scale + normalize_translation`; `Koordinate vor Normalisierung = (Koordinate nach Normalisierung - normalize_translation) / normalize_scale`. Wird nur zurückgegeben, wenn der Importprozess diesen Wert liefert, und zwar von denselben Aufgaben wie `normalize_scale`; nicht zurückgegeben für Eingaben per `task_id` und für Aufgaben, die vor Einführung dieses Felds erstellt wurden |
## Fehlercodes
| HTTP Statuscode | Fehlercode | Beschreibung | Empfehlung |
| :-: | :-: | :-: | :-: |
| 429 | 2000 | Generationslimit überschritten | Reduzieren Sie die Anforderungsrate und versuchen Sie es später erneut |
| 400 | 1004 | Nicht unterstützte Anforderungsparameter | Überprüfen Sie die Parameternamen und Wertebereiche des Anforderungshauptteils |
| 400 | 2006 | Ungültiger Aufgabentyp der Eingabequelle | Bestätigen Sie, dass das Eingabedateiformat unterstützt wird |
| 400 | 2007 | Die Quellaufgabe wurde nicht erfolgreich abgeschlossen | Bestätigen Sie, dass der Datei-Upload abgeschlossen ist |
| 403 | 2010 | Unzureichende Credits | Guthaben aufladen und erneut versuchen |
Modell importieren
POST /v3/models/import
Importieren Sie eine externe 3D-Modelldatei in die Tripo-Plattform.
Die gezeigten Aufgaben-IDs sind Beispiele. Ersetzen Sie sie durch die von der API zurückgegebenen IDs.
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 |
- |
Modelldateiquelle. Akzeptiert einen file_token, der mit file_ beginnt, oder einen URL, der mit http(s):// beginnt. Unterstützte Formate: GLB, GLTF, FBX, OBJ, STL, maximal 150 MB |
Fordern Sie Beispiele an
curl -X POST https://openapi.tripo3d.ai/v3/models/import \
-H "Content-Type: application/json" \
-H "Authorization: Bearer {api_key}" \
-d '{
"input": "file_abc123"
}'
import requests
url = "https://openapi.tripo3d.ai/v3/models/import"
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer {api_key}"
}
payload = {
"input": "file_abc123"
}
response = requests.post(url, headers=headers, json=payload)
print(response.json())
const url = "https://openapi.tripo3d.ai/v3/models/import";
const response = await fetch(url, {
method: "POST",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer {api_key}"
},
body: JSON.stringify({
input: "file_abc123"
})
});
const data = await response.json();
console.log(data);
Antwort
Erfolgreiche Antwort
{
"code": 0,
"data": {
"task_id": "550e8400-e29b-41d4-a716-446655440001"
}
}
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 |
Felder des Aufgabenergebnisses
Nach status=success liefert GET /v3/tasks/{task_id} diese Felder in data.output:
| Parameter |
Typ |
Beschreibung |
| model_url |
string |
Download-URL des importierten Modells |
| rendered_image_url |
string |
URL des gerenderten Vorschaubilds |
| normalize_scale |
number |
Gleichmäßiger Skalierungsfaktor, der bei der Normalisierung des importierten Modells angewendet wurde: Größe nach Normalisierung = Größe vor Normalisierung × normalize_scale. 1.0 bedeutet nicht skaliert, eine Verschiebung kann dennoch erfolgt sein. Teilt man die normalisierte Größe durch diesen Faktor, erhält man die Größe vor der Normalisierung; die Ausgabe der Plattform behält das normalisierte Ergebnis bei. Wird von Modell importieren sowie von Modell-Nachbearbeitungsaufgaben (Rigging, Texturierung, Konvertierung usw., die das Modell zuerst importieren) zurückgegeben, deren Modelleingabe ein file_token oder eine URL ist; nicht zurückgegeben für Eingaben per task_id und für Aufgaben, die vor Einführung dieses Felds erstellt wurden |
| normalize_translation |
number[] |
Verschiebungsvektor, der bei der Normalisierung des importierten Modells angewendet wurde, als [tx, ty, tz] (3 Zahlen). Zusammen mit normalize_scale verwenden: Koordinate nach Normalisierung = Koordinate vor Normalisierung × normalize_scale + normalize_translation; Koordinate vor Normalisierung = (Koordinate nach Normalisierung - normalize_translation) / normalize_scale. Wird nur zurückgegeben, wenn der Importprozess diesen Wert liefert, und zwar von denselben Aufgaben wie normalize_scale; nicht zurückgegeben für Eingaben per task_id und für Aufgaben, die vor Einführung dieses Felds erstellt wurden |
Fehlercodes
| HTTP Statuscode |
Fehlercode |
Beschreibung |
Empfehlung |
| 429 |
2000 |
Generationslimit überschritten |
Reduzieren Sie die Anforderungsrate und versuchen Sie es später erneut |
| 400 |
1004 |
Nicht unterstützte Anforderungsparameter |
Überprüfen Sie die Parameternamen und Wertebereiche des Anforderungshauptteils |
| 400 |
2006 |
Ungültiger Aufgabentyp der Eingabequelle |
Bestätigen Sie, dass das Eingabedateiformat unterstützt wird |
| 400 |
2007 |
Die Quellaufgabe wurde nicht erfolgreich abgeschlossen |
Bestätigen Sie, dass der Datei-Upload abgeschlossen ist |
| 403 |
2010 |
Unzureichende Credits |
Guthaben aufladen und erneut versuchen |