Введение
Tripo Auto Rig снабжает статичную 3D-модель скелетом. Инструмент работает с людьми, животными и фантастическими существами, оставляет сетку и текстуры без изменений и возвращает GLB или FBX для позирования и анимации в ваших программах. Выберите его, если нужны только кости; для добавления движений тем же запросом используйте эндпоинт Animate в Tripo 3D Tools.
Ключевые возможности и особенности
Девять типов скелета
В rig_type доступны biped, quadruped, hexapod, octopod, avian, serpentine, aquatic и others, а режим auto подбирает тип по форме. Для нашего стоящего прямо игрушечного космонавта auto выбрал человекоподобный скелет из 78 суставов, включая отдельные пальцы рук.
Знакомые движку имена костей
Для скелетов biped параметр bone_naming позволяет выбрать собственные имена Tripo или соглашения Mixamo, ActorCore, Unity, Unreal и VRM. Так инструменты переноса анимации и системы аватаров распознают кости без ручного переименования.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
mesh_url | Да | Модель для риггинга: GLB, бинарный FBX, OBJ или STL до 90 МБ. Прямая ссылка должна заканчиваться соответствующим расширением. Не менее 1 символов |
rig_type | Нет | Тип скелета. auto (по умолчанию) выбирает его по форме; также доступны biped, quadruped, hexapod, octopod, avian, serpentine, aquatic и others. |
bone_naming | Нет | Имена костей для скелетов biped: tripo (по умолчанию), mixamo, actorcore, unity, unreal или vrm. Для других типов скелета игнорируется. |
output_format | Нет | glb (по умолчанию) для браузеров и веб-движков, fbx для настольных программ анимации. На цену не влияет. |
Стоимость
$0.36 / риг
За каждый успешно полученный результат взимается фиксированная плата независимо от типа скелета, имён костей и выходного формата. Неудачные запуски, включая неподдерживаемые файлы, не оплачиваются.
Сценарии использования
Задайте позу сгенерированному персонажу
Добавьте скелет модели, созданной по изображению, и настройте позу в Blender или веб-просмотрщике для статичного кадра, миниатюры или 3D-печати в динамичной стойке.
Подготовьте аватаров и NPC
Выберите имена костей Unity, Unreal или VRM, чтобы использовать персонажа с существующим набором анимаций или в процессе подготовки аватаров.
Руководство по промптам и практические советы
Обеспечьте ясный силуэт
Текстовый промпт не используется. Чище всего скелет строится у модели, стоящей прямо, со слегка отведёнными руками и расставленными ногами; слитые конечности и скрещённые руки затрудняют размещение суставов.
Выберите файл для следующего этапа
Оставьте output_format равным glb для веба и эндпоинта Convert или выберите fbx для настольных программ. Загружайте GLB, бинарный FBX, OBJ или STL до 90 МБ; файлы JSON .gltf сначала экспортируйте в .glb.
Быстрый старт 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/rig",
"input": {
"bone_naming": "tripo",
"mesh_url": "https://example.com/reference.png",
"output_format": "glb",
"rig_type": "auto"
}
}'
# 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.





