Importa modello

POST /v3/models/import

Importa un file di modello 3D esterno nella piattaforma Tripo.

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

JSON

{
  "code": 0,
  "data": {
    "task_id": "task_def456"
  }
}

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

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