# Modèle d'importation
> **POST** `/v3/models/import`
Importez un fichier de modèle 3D externe dans la plateforme Tripo.
> Les ID de tâche indiqués sont des exemples. Remplacez-les par les ID renvoyés par l’API.
## Paramètres de la demande
### En-têtes de demande
| Paramètre | Tapez | Obligatoire | Par défaut | Descriptif |
| :-: | :-: | :-: | :-: | :-: |
| Content-Type | chaîne | Oui | - | `application/json` |
| Authorization | chaîne | Oui | - | `Bearer {api_key}` |
### Corps de la demande
| Paramètre | Tapez | Obligatoire | Par défaut | Descriptif |
| :-: | :-: | :-: | :-: | :-: |
| input | chaîne | Oui | - | Source du fichier modèle. Accepte un file_token commençant par `file_` ou un URL commençant par `http(s)://`. Formats pris en charge : GLB, GLTF, FBX, OBJ, STL, maximum 150 MB |
## Exemples de demande
### 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);
```
## Réponse
### Réponse réussie
```json
{
"code": 0,
"data": {
"task_id": "550e8400-e29b-41d4-a716-446655440001"
}
}
```
### Champs de réponse
| Paramètre | Tapez | Descriptif |
| :-: | :-: | :-: |
| code | entier | Code d'état. `0` indique le succès |
| data.task_id | chaîne | Identifiant de tâche unique utilisé pour interroger la progression et les résultats de la génération |
### Champs du résultat de la tâche
Après `status=success`, `GET /v3/tasks/{task_id}` renvoie ces champs dans `data.output` :
| Paramètre | Tapez | Descriptif |
| :-: | :-: | :-: |
| model_url | string | URL de téléchargement du modèle importé |
| rendered_image_url | string | URL de l'image d'aperçu rendue |
| normalize_scale | number | Facteur d'échelle uniforme appliqué lors de la normalisation du modèle importé : `taille après normalisation = taille avant normalisation × normalize_scale`. `1.0` signifie aucune mise à l'échelle, mais une translation peut tout de même avoir eu lieu. Divisez la taille normalisée par ce facteur pour retrouver la taille avant normalisation ; la sortie de la plateforme conserve le résultat normalisé. Renvoyé par Importer un modèle et par les tâches de post-traitement de modèle (rigging, texturation, conversion, etc., qui importent d'abord le modèle) dont le modèle d'entrée est un `file_token` ou une URL ; non renvoyé pour une entrée `task_id` ni pour les tâches créées avant l'ajout de ce champ |
| normalize_translation | number[] | Vecteur de translation appliqué lors de la normalisation du modèle importé, sous la forme `[tx, ty, tz]` (3 nombres). À utiliser avec `normalize_scale` : `coordonnée après normalisation = coordonnée avant normalisation × normalize_scale + normalize_translation` ; `coordonnée avant normalisation = (coordonnée après normalisation - normalize_translation) / normalize_scale`. Renvoyé uniquement lorsque le processus d'import fournit cette valeur, par les mêmes tâches que `normalize_scale` ; non renvoyé pour une entrée `task_id` ni pour les tâches créées avant l'ajout de ce champ |
## Codes d'erreur
| Code d'état HTTP | Code d'erreur | Descriptif | Recommandation |
| :-: | :-: | :-: | :-: |
| 429 | 2000 | Limite de génération dépassée | Réduisez le taux de demandes et réessayez plus tard |
| 400 | 1004 | Paramètres de requête non pris en charge | Vérifier les noms des paramètres du corps de la requête et les plages de valeurs |
| 400 | 2006 | Type de tâche source d'entrée non valide | Confirmez que le format du fichier d'entrée est pris en charge |
| 400 | 2007 | La tâche source ne s'est pas terminée avec succès | Confirmez que le téléchargement du fichier est terminé |
| 403 | 2010 | Crédits insuffisants | Recharger des crédits et réessayer |
Modèle d’importation
POST /v3/models/import
Importez un fichier de modèle 3D externe dans la plateforme Tripo.
Les ID de tâche indiqués sont des exemples. Remplacez-les par les ID renvoyés par l’API.
Paramètres de la demande
En-têtes de demande
| Paramètre |
Tapez |
Obligatoire |
Par défaut |
Descriptif |
| Content-Type |
chaîne |
Oui |
- |
application/json |
| Authorization |
chaîne |
Oui |
- |
Bearer {api_key} |
Corps de la demande
| Paramètre |
Tapez |
Obligatoire |
Par défaut |
Descriptif |
| input |
chaîne |
Oui |
- |
Source du fichier modèle. Accepte un file_token commençant par file_ ou un URL commençant par http(s)://. Formats pris en charge : GLB, GLTF, FBX, OBJ, STL, maximum 150 MB |
Exemples de demande
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);
Réponse
Réponse réussie
{
"code": 0,
"data": {
"task_id": "550e8400-e29b-41d4-a716-446655440001"
}
}
Champs de réponse
| Paramètre |
Tapez |
Descriptif |
| code |
entier |
Code d’état. 0 indique le succès |
| data.task_id |
chaîne |
Identifiant de tâche unique utilisé pour interroger la progression et les résultats de la génération |
Champs du résultat de la tâche
Après status=success, GET /v3/tasks/{task_id} renvoie ces champs dans data.output :
| Paramètre |
Tapez |
Descriptif |
| model_url |
string |
URL de téléchargement du modèle importé |
| rendered_image_url |
string |
URL de l’image d’aperçu rendue |
| normalize_scale |
number |
Facteur d’échelle uniforme appliqué lors de la normalisation du modèle importé : taille après normalisation = taille avant normalisation × normalize_scale. 1.0 signifie aucune mise à l’échelle, mais une translation peut tout de même avoir eu lieu. Divisez la taille normalisée par ce facteur pour retrouver la taille avant normalisation ; la sortie de la plateforme conserve le résultat normalisé. Renvoyé par Importer un modèle et par les tâches de post-traitement de modèle (rigging, texturation, conversion, etc., qui importent d’abord le modèle) dont le modèle d’entrée est un file_token ou une URL ; non renvoyé pour une entrée task_id ni pour les tâches créées avant l’ajout de ce champ |
| normalize_translation |
number[] |
Vecteur de translation appliqué lors de la normalisation du modèle importé, sous la forme [tx, ty, tz] (3 nombres). À utiliser avec normalize_scale : coordonnée après normalisation = coordonnée avant normalisation × normalize_scale + normalize_translation ; coordonnée avant normalisation = (coordonnée après normalisation - normalize_translation) / normalize_scale. Renvoyé uniquement lorsque le processus d’import fournit cette valeur, par les mêmes tâches que normalize_scale ; non renvoyé pour une entrée task_id ni pour les tâches créées avant l’ajout de ce champ |
Codes d’erreur
| Code d’état HTTP |
Code d’erreur |
Descriptif |
Recommandation |
| 429 |
2000 |
Limite de génération dépassée |
Réduisez le taux de demandes et réessayez plus tard |
| 400 |
1004 |
Paramètres de requête non pris en charge |
Vérifier les noms des paramètres du corps de la requête et les plages de valeurs |
| 400 |
2006 |
Type de tâche source d’entrée non valide |
Confirmez que le format du fichier d’entrée est pris en charge |
| 400 |
2007 |
La tâche source ne s’est pas terminée avec succès |
Confirmez que le téléchargement du fichier est terminé |
| 403 |
2010 |
Crédits insuffisants |
Recharger des crédits et réessayer |