Введение
Tripo Convert меняет формат файла 3D-модели и при необходимости корректирует её. Это завершающий этап после генерации, риггинга или анимации: одного персонажа можно сохранить как GLB для браузерной игры, FBX для Blender или игрового движка либо STL для принтера. По умолчанию скелет и клипы анимации остаются в модели.
Ключевые возможности и особенности
Скелет и клипы сохраняются при преобразовании
Мы экспортировали анимированного космонавта в FBX и преобразовали этот FBX обратно в GLB. В результате остались 78 суставов, три карты текстур и клип walk, который сразу воспроизвёлся в веб-просмотрщике.
Дополнительная обработка
face_limit уменьшает число полигонов, quad_mesh перестраивает поверхность в четырёхугольники для программ моделирования, texture_size и texture_format уменьшают или меняют карты текстур. Параметры pivot_to_bottom, flatten_bottom и scale_factor готовят модель к размещению или печати. Любая из этих настроек переводит запуск на повышенный тариф.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
mesh_url | Да | Модель для конвертации: GLB, бинарный FBX, OBJ или STL до 90 МБ. Подходят и файлы со скелетом и анимацией. Не менее 1 символов |
output_format | Да | Обязательно. glb для браузеров и веб-игр, fbx для программ анимации и движков, stl для 3D-печати (только геометрия). |
quad_mesh | Нет | По умолчанию выключено. Перестраивает сетку в четырёхугольники: около 10 000 граней, если не задан |
face_limit | Нет | Необязательное максимальное число граней: от 48 до 2 000 000. Оставьте пустым для сохранения исходного количества. |
texture_size | Нет | Размер диффузной текстуры в пикселях: от 128 до 8192, по умолчанию 4096. Любое другое значение повышает тариф. |
texture_format | Нет | jpeg (по умолчанию), png или webp для экспортируемых текстур. Выбор png или webp повышает тариф. |
pivot_to_bottom | Нет | По умолчанию выключено. Переносит точку опоры в центр основания, чтобы при размещении модель стояла на земле. По умолчанию: |
scale_factor | Нет | Единый коэффициент масштаба при экспорте, по умолчанию 1. Любое другое значение повышает тариф. |
flatten_bottom | Нет | По умолчанию выключено. Делает нижнюю поверхность плоской, что полезно перед 3D-печатью. По умолчанию: |
forward_axis | Нет | Направление модели в экспортируемом файле: +x (по умолчанию), -x, +y или -y. На цену не влияет. |
fbx_preset | Нет | Пресет совместимости при экспорте FBX: blender (по умолчанию), 3dsmax, mixamo или |
bake_textures | Нет | По умолчанию включено: сложные материалы запекаются в базовые текстуры. На цену не влияет. По умолчанию: |
keep_animation | Нет | По умолчанию включено: скелет и клипы анимации записываются в новый файл. Выключите для статичной сетки. По умолчанию: |
in_place | Нет | По умолчанию выключено. Убирает перемещение вперёд из клипов анимации при экспорте. По умолчанию: |
Стоимость
$0.072 / конвертация
Простая смена формата оплачивается по базовому тарифу. Повышенный тариф действует при любой настройке изменения модели: quad_mesh, face_limit, flatten_bottom, pivot_to_bottom, texture_size со значением не 4096, texture_format со значением не jpeg или scale_factor со значением не 1. Неудачные запуски не оплачиваются.
Сценарии использования
Из FBX в GLB для браузера
Программы анимации, а также Rig или Animate с выбранным FBX создают файлы, которые браузер не откроет. Преобразуйте их в GLB и загрузите в three.js, Babylon.js или движок веб-игры.
Распечатайте персонажа в нужной позе
Задайте персонажу позу или анимацию, экспортируйте STL с включённым flatten_bottom и отправьте файл в слайсер. STL содержит лишь геометрию, поэтому цвет и движение не сохраняются.
Руководство по промптам и практические советы
Выбирайте формат под задачу
Промпт не используется. Установите output_format в glb, fbx или stl. Параметр quad_mesh всегда создаёт FBX, поэтому для запроса четырёхугольной сетки требуется output_format со значением fbx.
Для простой конвертации оставьте базовые настройки
Если менять только формат, forward_axis, fbx_preset, bake_textures, keep_animation и in_place, действует базовый тариф. Оставьте texture_size равным 4096, texture_format — jpeg, а scale_factor — 1, если их изменение не требуется.
Быстрый старт API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "tripo/tools/convert",
"input": {
"fbx_preset": "blender",
"flatten_bottom": false,
"forward_axis": "+x",
"mesh_url": "https://example.com/reference.png",
"output_format": "glb",
"pivot_to_bottom": false,
"quad_mesh": false
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Аутентификация, полная схема, опрос статуса и обработка ошибок описаны в справочнике API.





