Введение
Tripo Animate превращает статичного 3D-персонажа в движущегося. Одним запросом инструмент добавляет скелет и до пяти движений из библиотеки Tripo: модель, сгенерированная по изображению, сможет ходить, бегать или взмахивать мечом без ручного риггинга. Каждое движение записывается отдельным именованным клипом внутри одного GLB или FBX.
Ключевые возможности и особенности
Шестнадцать пресетов для разных тел
Для человекоподобных персонажей доступны idle, walk, run, dive, climb, jump, slash, shoot, hurt, fall и turn. Для других форм тела предусмотрены собственные циклы: quadruped:walk, hexapod:walk, octopod:walk, serpentine:march и aquatic:march.
Переключение между клипами
Наш запрос jump и slash дал один GLB размером 3,0 МБ с клипами jump (2,2 секунды) и slash (6,6 секунды). Веб-просмотрщик или игровой движок показывает их имена и воспроизводит нужное для сцены движение.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
mesh_url | Да | Персонаж для анимации: GLB, бинарный FBX, OBJ или STL до 90 МБ. Готовый скелет не нужен: он добавляется при том же запуске. Не менее 1 символов |
animations | Да | От одной до пяти строк с именами пресетов, например walk, run, jump или slash. Каждая строка создаёт отдельный клип в файле и увеличивает цену. Не менее 1 элементов · Не более 5 элементов |
rig_type | Нет | Тип скелета, по умолчанию auto. Для соответствующих пресетов ходьбы или марша выбирайте quadruped, hexapod, octopod, serpentine или aquatic. |
bone_naming | Нет | Имена костей скелетов biped: tripo (по умолчанию), mixamo, actorcore, unity, unreal или vrm. На цену не влияет. |
output_format | Нет | glb (по умолчанию) или fbx. Оба формата содержат скелет и все запрошенные клипы. |
in_place | Нет | По умолчанию выключено. При включении убирает перемещение вперёд из клипов: персонаж двигается на месте, как обычно нужно для игровых контроллеров. По умолчанию: |
Стоимость
$0.504 / анимированная модель
Фиксированная плата за результат плюс фиксированная сумма за каждое движение в animations: пять движений стоят дороже одного. Тип скелета, имена костей, in_place и выходной формат на цену не влияют. Неудачные запуски не оплачиваются.
Сценарии использования
Добавьте сгенерированного героя в браузерную игру
Запросите idle, walk и jump с включённым in_place, загрузите GLB в веб-движок и поручите перемещение контроллеру персонажа, а движения тела — клипам.
Наметьте движения для анимационного кадра
Возьмите walk или run для начального движения, отрендерите простой серый предпросмотр и передайте его видеомодели, которая превращает черновые 3D-сцены в готовые кадры.
Руководство по промптам и практические советы
Подбирайте движения под строение тела
Текстового промпта нет: движение определяют строки в animations. Для двуногих персонажей выбирайте человекоподобные пресеты, а для животных и существ — подходящий пресет ходьбы или марша вместе с нужным rig_type.
Заранее решите, кто перемещает персонажа
При выключенном in_place walk и run перемещают персонажа вперёд по сцене — это удобно для сюжетных вставок и предпросмотра. Включите параметр, если перемещением управляет код игры. Каждое дополнительное движение увеличивает цену, поэтому запрашивайте только нужные клипы.
Быстрый старт 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/animate",
"input": {
"animations": [
{
"name": "idle"
}
],
"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.





