# Importar modelo
> **POST** `/v3/models/import`
Importe un archivo de modelo 3D externo a la plataforma Tripo.
> Los ID de tarea mostrados son ejemplos. Sustitúyalos por los ID devueltos por la API.
## 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
```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);
```
## Respuesta
### Respuesta exitosa
```json
{
"code": 0,
"data": {
"task_id": "550e8400-e29b-41d4-a716-446655440001"
}
}
```
### 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. |
### Campos del resultado de la tarea
Tras `status=success`, `GET /v3/tasks/{task_id}` devuelve estos campos en `data.output`:
| Parámetro | Tipo | Descripción |
| :-: | :-: | :-: |
| model_url | string | URL de descarga del modelo importado |
| rendered_image_url | string | URL de la imagen de vista previa renderizada |
| normalize_scale | number | Factor de escala uniforme aplicado al normalizar el modelo importado: `tamaño normalizado = tamaño previo a la normalización × normalize_scale`. `1.0` significa que no se reescaló, aunque puede haberse aplicado una traslación. Divide el tamaño normalizado entre este factor para recuperar el tamaño previo a la normalización; la salida de la plataforma conserva el resultado normalizado. Lo devuelven Importar modelo y las tareas de posprocesamiento de modelos (rigging, texturizado, conversión, etc., que primero importan el modelo) cuya entrada de modelo es un `file_token` o una URL; no se devuelve con entrada `task_id` ni en tareas creadas antes de añadir este campo |
| normalize_translation | number[] | Vector de traslación aplicado al normalizar el modelo importado, en formato `[tx, ty, tz]` (3 números). Se usa junto con `normalize_scale`: `coordenada normalizada = coordenada previa a la normalización × normalize_scale + normalize_translation`; `coordenada previa a la normalización = (coordenada normalizada - normalize_translation) / normalize_scale`. Solo se devuelve cuando el proceso de importación proporciona este valor, en las mismas tareas que `normalize_scale`; no se devuelve con entrada `task_id` ni en tareas creadas antes de añadir este campo |
## 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 | 1004 | 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 |
Importar modelo
POST /v3/models/import
Importe un archivo de modelo 3D externo a la plataforma Tripo.
Los ID de tarea mostrados son ejemplos. Sustitúyalos por los ID devueltos por la API.
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
{
"code": 0,
"data": {
"task_id": "550e8400-e29b-41d4-a716-446655440001"
}
}
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. |
Campos del resultado de la tarea
Tras status=success, GET /v3/tasks/{task_id} devuelve estos campos en data.output:
| Parámetro |
Tipo |
Descripción |
| model_url |
string |
URL de descarga del modelo importado |
| rendered_image_url |
string |
URL de la imagen de vista previa renderizada |
| normalize_scale |
number |
Factor de escala uniforme aplicado al normalizar el modelo importado: tamaño normalizado = tamaño previo a la normalización × normalize_scale. 1.0 significa que no se reescaló, aunque puede haberse aplicado una traslación. Divide el tamaño normalizado entre este factor para recuperar el tamaño previo a la normalización; la salida de la plataforma conserva el resultado normalizado. Lo devuelven Importar modelo y las tareas de posprocesamiento de modelos (rigging, texturizado, conversión, etc., que primero importan el modelo) cuya entrada de modelo es un file_token o una URL; no se devuelve con entrada task_id ni en tareas creadas antes de añadir este campo |
| normalize_translation |
number[] |
Vector de traslación aplicado al normalizar el modelo importado, en formato [tx, ty, tz] (3 números). Se usa junto con normalize_scale: coordenada normalizada = coordenada previa a la normalización × normalize_scale + normalize_translation; coordenada previa a la normalización = (coordenada normalizada - normalize_translation) / normalize_scale. Solo se devuelve cuando el proceso de importación proporciona este valor, en las mismas tareas que normalize_scale; no se devuelve con entrada task_id ni en tareas creadas antes de añadir este campo |
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 |
1004 |
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 |