Importar modelo

POST /v3/models/import

Importe un archivo de modelo 3D externo a la plataforma Tripo.

Solicitar parámetros

Encabezados de solicitud

Parámetro	Tipo	Requerido	Predeterminado	Descripción
Content-Type	cadena	si	-	`application/json`
Authorization	cadena	si	-	`Bearer {api_key}`

Cuerpo de solicitud

Parámetro	Tipo	Requerido	Predeterminado	Descripción
input	cadena	si	-	Fuente del archivo del modelo. Acepta un file_token que comienza con `file_` o un URL que comienza con `http(s)://`. Formatos admitidos: GLB, GLTF, FBX, OBJ, STL, máximo 150 MB

Ejemplos de solicitudes

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);

Respuesta

Respuesta exitosa

JSON

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

Campos de respuesta

Parámetro	Tipo	Descripción
code	entero	Código de estado. `0` indica éxito
data.task_id	cadena	Identificador de tarea único utilizado para consultar el progreso y los resultados de la generación.

Códigos de error

Código de estado HTTP	Código de error	Descripción	Recomendación
429	2000	Límite de generación excedido	Reduzca la tasa de solicitudes y vuelva a intentarlo más tarde
400	2002	Parámetros de solicitud no admitidos	Verifique los nombres de los parámetros del cuerpo de la solicitud y los rangos de valores
400	2006	Tipo de tarea de fuente de entrada no válida	Confirme que el formato del archivo de entrada sea compatible
400	2007	La tarea de origen no se completó correctamente	Confirme que la carga del archivo se haya completado
403	2010	Créditos insuficientes	Recarga créditos y vuelve a intentarlo