# Importa modello
> **POST** `/v3/models/import`
Importa un file di modello 3D esterno nella piattaforma Tripo.
> Gli ID attività mostrati sono esempi. Sostituiscili con gli ID restituiti dall’API.
## Richiedi parametri
### Richiedi intestazioni
| Parametro | Digitare | Obbligatorio | Predefinito | Descrizione |
| :-: | :-: | :-: | :-: | :-: |
| Content-Type | stringa | Sì | - | `application/json` |
| Authorization | stringa | Sì | - | `Bearer {api_key}` |
### Richiedi corpo
| Parametro | Digitare | Obbligatorio | Predefinito | Descrizione |
| :-: | :-: | :-: | :-: | :-: |
| input | stringa | Sì | - | Origine del file del modello. Accetta uno file_token che inizia con `file_` o uno URL che inizia con `http(s)://`. Formati supportati: GLB, GLTF, FBX, OBJ, STL, massimo 150 MB |
## Richiedi esempi
### 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);
```
## Risposta
### Risposta riuscita
```json
{
"code": 0,
"data": {
"task_id": "550e8400-e29b-41d4-a716-446655440001"
}
}
```
### Campi di risposta
| Parametro | Digitare | Descrizione |
| :-: | :-: | :-: |
| code | intero | Codice di stato. `0` indica successo |
| data.task_id | stringa | Identificatore univoco dell'attività utilizzato per interrogare l'avanzamento e i risultati della generazione |
### Campi del risultato dell'attività
Dopo `status=success`, `GET /v3/tasks/{task_id}` restituisce questi campi in `data.output`:
| Parametro | Digitare | Descrizione |
| :-: | :-: | :-: |
| model_url | string | URL di download del modello importato |
| rendered_image_url | string | URL dell'immagine di anteprima renderizzata |
| normalize_scale | number | Fattore di scala uniforme applicato durante la normalizzazione del modello importato: `dimensione dopo la normalizzazione = dimensione prima della normalizzazione × normalize_scale`. `1.0` indica nessun ridimensionamento, anche se può esserci stata una traslazione. Dividendo la dimensione normalizzata per questo fattore si ottiene la dimensione prima della normalizzazione; l'output della piattaforma mantiene il risultato normalizzato. Restituito da Importa modello e dalle attività di post-elaborazione del modello (rigging, texturing, conversione, ecc., che importano prima il modello) con modello in input come `file_token` o URL; non restituito per input `task_id` né per le attività create prima dell'introduzione di questo campo |
| normalize_translation | number[] | Vettore di traslazione applicato durante la normalizzazione del modello importato, nel formato `[tx, ty, tz]` (3 numeri). Si usa insieme a `normalize_scale`: `coordinata dopo la normalizzazione = coordinata prima della normalizzazione × normalize_scale + normalize_translation`; `coordinata prima della normalizzazione = (coordinata dopo la normalizzazione - normalize_translation) / normalize_scale`. Restituito solo quando il processo di importazione fornisce questo valore, dalle stesse attività di `normalize_scale`; non restituito per input `task_id` né per le attività create prima dell'introduzione di questo campo |
## Codici di errore
| HTTP Codice di stato | Codice errore | Descrizione | Raccomandazione |
| :-: | :-: | :-: | :-: |
| 429 | 2000 | Limite di generazione superato | Ridurre la frequenza delle richieste e riprovare più tardi |
| 400 | 1004 | Parametri di richiesta non supportati | Controllare i nomi dei parametri del corpo della richiesta e gli intervalli di valori |
| 400 | 2006 | Tipo di attività di origine di input non valido | Confermare che il formato del file di input sia supportato |
| 400 | 2007 | L'attività di origine non è stata completata correttamente | Conferma che il caricamento del file è stato completato |
| 403 | 2010 | Crediti insufficienti | Ricaricare i crediti e riprovare |
Importa modello
POST /v3/models/import
Importa un file di modello 3D esterno nella piattaforma Tripo.
Gli ID attività mostrati sono esempi. Sostituiscili con gli ID restituiti dall’API.
Richiedi parametri
Richiedi intestazioni
| Parametro |
Digitare |
Obbligatorio |
Predefinito |
Descrizione |
| Content-Type |
stringa |
Sì |
- |
application/json |
| Authorization |
stringa |
Sì |
- |
Bearer {api_key} |
Richiedi corpo
| Parametro |
Digitare |
Obbligatorio |
Predefinito |
Descrizione |
| input |
stringa |
Sì |
- |
Origine del file del modello. Accetta uno file_token che inizia con file_ o uno URL che inizia con http(s)://. Formati supportati: GLB, GLTF, FBX, OBJ, STL, massimo 150 MB |
Richiedi esempi
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);
Risposta
Risposta riuscita
{
"code": 0,
"data": {
"task_id": "550e8400-e29b-41d4-a716-446655440001"
}
}
Campi di risposta
| Parametro |
Digitare |
Descrizione |
| code |
intero |
Codice di stato. 0 indica successo |
| data.task_id |
stringa |
Identificatore univoco dell’attività utilizzato per interrogare l’avanzamento e i risultati della generazione |
Campi del risultato dell’attività
Dopo status=success, GET /v3/tasks/{task_id} restituisce questi campi in data.output:
| Parametro |
Digitare |
Descrizione |
| model_url |
string |
URL di download del modello importato |
| rendered_image_url |
string |
URL dell’immagine di anteprima renderizzata |
| normalize_scale |
number |
Fattore di scala uniforme applicato durante la normalizzazione del modello importato: dimensione dopo la normalizzazione = dimensione prima della normalizzazione × normalize_scale. 1.0 indica nessun ridimensionamento, anche se può esserci stata una traslazione. Dividendo la dimensione normalizzata per questo fattore si ottiene la dimensione prima della normalizzazione; l’output della piattaforma mantiene il risultato normalizzato. Restituito da Importa modello e dalle attività di post-elaborazione del modello (rigging, texturing, conversione, ecc., che importano prima il modello) con modello in input come file_token o URL; non restituito per input task_id né per le attività create prima dell’introduzione di questo campo |
| normalize_translation |
number[] |
Vettore di traslazione applicato durante la normalizzazione del modello importato, nel formato [tx, ty, tz] (3 numeri). Si usa insieme a normalize_scale: coordinata dopo la normalizzazione = coordinata prima della normalizzazione × normalize_scale + normalize_translation; coordinata prima della normalizzazione = (coordinata dopo la normalizzazione - normalize_translation) / normalize_scale. Restituito solo quando il processo di importazione fornisce questo valore, dalle stesse attività di normalize_scale; non restituito per input task_id né per le attività create prima dell’introduzione di questo campo |
Codici di errore
| HTTP Codice di stato |
Codice errore |
Descrizione |
Raccomandazione |
| 429 |
2000 |
Limite di generazione superato |
Ridurre la frequenza delle richieste e riprovare più tardi |
| 400 |
1004 |
Parametri di richiesta non supportati |
Controllare i nomi dei parametri del corpo della richiesta e gli intervalli di valori |
| 400 |
2006 |
Tipo di attività di origine di input non valido |
Confermare che il formato del file di input sia supportato |
| 400 |
2007 |
L’attività di origine non è stata completata correttamente |
Conferma che il caricamento del file è stato completato |
| 403 |
2010 |
Crediti insufficienti |
Ricaricare i crediti e riprovare |