Импортировать модель

POST /v3/models/import

Импортируйте внешний файл 3D-модели на платформу Tripo.

Параметры запроса

Заголовки запросов

Параметр	Тип	Требуется	По умолчанию	Описание
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);

Ответ

Успешный ответ

JSON

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

Поля ответа

Параметр	Тип	Описание
code	целое число	Код состояния. `0` указывает на успех.
data.task_id	строка	Уникальный идентификатор задачи, используемый для запроса хода создания и результатов.

Коды ошибок

HTTP Код состояния	Код ошибки	Описание	Рекомендация
429	2000	Превышен лимит генерации	Уменьшите частоту запросов и повторите попытку позже.
400	2002	Неподдерживаемые параметры запроса	Проверьте имена параметров тела запроса и диапазоны значений.
400	2006	Неверный тип задачи источника входных данных	Убедитесь, что формат входного файла поддерживается
400	2007	Исходная задача не выполнена успешно	Подтвердите, что загрузка файла завершена
403	2010	Недостаточно кредитов	Пополните баланс и повторите попытку.