# Импортировать модель
> **POST** `/v3/models/import`
Импортируйте внешний файл 3D-модели на платформу Tripo.
> Указанные ID задач приведены для примера. Замените их на ID, возвращённые API.
## Параметры запроса
### Заголовки запросов
| Параметр | Тип | Требуется | По умолчанию | Описание |
| :-: | :-: | :-: | :-: | :-: |
| Content-Type | строка | Да | - | `application/json` |
| Authorization | строка | Да | - | `Bearer {api_key}` |
### Тело запроса
| Параметр | Тип | Требуется | По умолчанию | Описание |
| :-: | :-: | :-: | :-: | :-: |
| input | строка | Да | - | Источник файла модели. Принимает file_token, начинающийся с `file_`, или URL, начинающийся с `http(s)://`. Поддерживаемые форматы: GLB, GLTF, FBX, OBJ, STL, максимум 150 MB. |
## Примеры запросов
### 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);
```
## Ответ
### Успешный ответ
```json
{
"code": 0,
"data": {
"task_id": "550e8400-e29b-41d4-a716-446655440001"
}
}
```
### Поля ответа
| Параметр | Тип | Описание |
| :-: | :-: | :-: |
| code | целое число | Код состояния. `0` указывает на успех. |
| data.task_id | строка | Уникальный идентификатор задачи, используемый для запроса хода создания и результатов. |
### Поля результата задачи
После `status=success` запрос `GET /v3/tasks/{task_id}` возвращает эти поля в `data.output`:
| Параметр | Тип | Описание |
| :-: | :-: | :-: |
| model_url | string | URL для скачивания импортированной модели |
| rendered_image_url | string | URL отрендеренного изображения предпросмотра |
| normalize_scale | number | Коэффициент равномерного масштабирования, применённый при нормализации импортированной модели: `размер после нормализации = размер до нормализации × normalize_scale`. `1.0` означает, что масштаб не менялся, но смещение всё равно могло быть применено. Разделите размер после нормализации на этот коэффициент, чтобы восстановить размер до нормализации; результат платформы остаётся нормализованным. Возвращается задачей импорта модели и задачами постобработки модели (риггинг, текстурирование, конвертация и т. д., которые сначала импортируют модель), у которых входная модель задана как `file_token` или URL; не возвращается при входе `task_id` и для задач, созданных до появления этого поля |
| normalize_translation | number[] | Вектор смещения, применённый при нормализации импортированной модели, в формате `[tx, ty, tz]` (3 числа). Используется вместе с `normalize_scale`: `координата после нормализации = координата до нормализации × normalize_scale + normalize_translation`; `координата до нормализации = (координата после нормализации - normalize_translation) / normalize_scale`. Возвращается, только если процесс импорта предоставляет это значение, теми же задачами, что и `normalize_scale`; не возвращается при входе `task_id` и для задач, созданных до появления этого поля |
## Коды ошибок
| HTTP Код состояния | Код ошибки | Описание | Рекомендация |
| :-: | :-: | :-: | :-: |
| 429 | 2000 | Превышен лимит генерации | Уменьшите частоту запросов и повторите попытку позже. |
| 400 | 1004 | Неподдерживаемые параметры запроса | Проверьте имена параметров тела запроса и диапазоны значений. |
| 400 | 2006 | Неверный тип задачи источника входных данных | Убедитесь, что формат входного файла поддерживается |
| 400 | 2007 | Исходная задача не выполнена успешно | Подтвердите, что загрузка файла завершена |
| 403 | 2010 | Недостаточно кредитов | Пополните баланс и повторите попытку. |
Импортировать модель
POST /v3/models/import
Импортируйте внешний файл 3D-модели на платформу Tripo.
Указанные ID задач приведены для примера. Замените их на ID, возвращённые API.
Параметры запроса
Заголовки запросов
| Параметр |
Тип |
Требуется |
По умолчанию |
Описание |
| Content-Type |
строка |
Да |
- |
application/json |
| Authorization |
строка |
Да |
- |
Bearer {api_key} |
Тело запроса
| Параметр |
Тип |
Требуется |
По умолчанию |
Описание |
| input |
строка |
Да |
- |
Источник файла модели. Принимает file_token, начинающийся с file_, или URL, начинающийся с http(s)://. Поддерживаемые форматы: GLB, GLTF, FBX, OBJ, STL, максимум 150 MB. |
Примеры запросов
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);
Ответ
Успешный ответ
{
"code": 0,
"data": {
"task_id": "550e8400-e29b-41d4-a716-446655440001"
}
}
Поля ответа
| Параметр |
Тип |
Описание |
| code |
целое число |
Код состояния. 0 указывает на успех. |
| data.task_id |
строка |
Уникальный идентификатор задачи, используемый для запроса хода создания и результатов. |
Поля результата задачи
После status=success запрос GET /v3/tasks/{task_id} возвращает эти поля в data.output:
| Параметр |
Тип |
Описание |
| model_url |
string |
URL для скачивания импортированной модели |
| rendered_image_url |
string |
URL отрендеренного изображения предпросмотра |
| normalize_scale |
number |
Коэффициент равномерного масштабирования, применённый при нормализации импортированной модели: размер после нормализации = размер до нормализации × normalize_scale. 1.0 означает, что масштаб не менялся, но смещение всё равно могло быть применено. Разделите размер после нормализации на этот коэффициент, чтобы восстановить размер до нормализации; результат платформы остаётся нормализованным. Возвращается задачей импорта модели и задачами постобработки модели (риггинг, текстурирование, конвертация и т. д., которые сначала импортируют модель), у которых входная модель задана как file_token или URL; не возвращается при входе task_id и для задач, созданных до появления этого поля |
| normalize_translation |
number[] |
Вектор смещения, применённый при нормализации импортированной модели, в формате [tx, ty, tz] (3 числа). Используется вместе с normalize_scale: координата после нормализации = координата до нормализации × normalize_scale + normalize_translation; координата до нормализации = (координата после нормализации - normalize_translation) / normalize_scale. Возвращается, только если процесс импорта предоставляет это значение, теми же задачами, что и normalize_scale; не возвращается при входе task_id и для задач, созданных до появления этого поля |
Коды ошибок
| HTTP Код состояния |
Код ошибки |
Описание |
Рекомендация |
| 429 |
2000 |
Превышен лимит генерации |
Уменьшите частоту запросов и повторите попытку позже. |
| 400 |
1004 |
Неподдерживаемые параметры запроса |
Проверьте имена параметров тела запроса и диапазоны значений. |
| 400 |
2006 |
Неверный тип задачи источника входных данных |
Убедитесь, что формат входного файла поддерживается |
| 400 |
2007 |
Исходная задача не выполнена успешно |
Подтвердите, что загрузка файла завершена |
| 403 |
2010 |
Недостаточно кредитов |
Пополните баланс и повторите попытку. |