소개
Tripo Animate는 정적인 3D 캐릭터에 움직임을 부여합니다. 한 요청에서 스켈레톤을 추가하고 Tripo 프리셋 라이브러리의 동작을 최대 5개까지 적용합니다. 이미지 기반 3D 생성기로 만든 모델도 수동 리깅 없이 걷거나 달리거나 칼을 휘두를 수 있습니다. 동작마다 이름이 붙은 개별 클립을 만들어 하나의 GLB 또는 FBX에 저장합니다.
핵심 기능 및 하이라이트
다양한 몸체에 맞는 프리셋 16개를 제공합니다
사람형에는 idle, walk, run, dive, climb, jump, slash, shoot, hurt, fall, turn을 사용합니다. 다른 몸체에는 각각 quadruped:walk, hexapod:walk, octopod:walk, serpentine:march, aquatic:march 사이클을 제공합니다.
장면에 맞게 클립을 전환합니다
jump와 slash를 함께 요청한 테스트에서는 3.0MB GLB 하나에 jump 2.2초와 slash 6.6초 클립이 담겼습니다. 웹 뷰어나 게임 엔진에서 클립 이름을 확인하고 장면에 필요한 동작을 재생합니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
mesh_url | 예 | 애니메이션을 적용할 캐릭터입니다. 최대 90MB의 GLB, 바이너리 FBX, OBJ, STL을 지원합니다. 1자 이상 |
animations | 예 | 1~5개 행을 지정하며 각 행에 walk, run, jump, slash 등의 프리셋 이름을 넣습니다. 행마다 파일 안에 개별 클립을 만들고 요금을 추가합니다. 1개 이상 · 5개 이하 |
rig_type | 아니요 | 스켈레톤 유형이며 기본값은 auto입니다. 해당 walk 또는 march 프리셋을 쓸 때는 quadruped, hexapod, octopod, serpentine, aquatic 중 맞는 유형을 고릅니다. |
bone_naming | 아니요 | biped 스켈레톤에 사용할 본 이름입니다. tripo가 기본이며 mixamo, actorcore, unity, unreal, vrm도 선택합니다. |
output_format | 아니요 | glb가 기본이며 fbx도 지원합니다. 두 형식 모두 스켈레톤과 요청한 모든 클립을 포함합니다. |
in_place | 아니요 | 기본으로 꺼져 있습니다. 켜면 클립의 전진 이동을 없애 캐릭터가 제자리에서 동작합니다. 기본값: |
요금
$0.504 / 애니메이션 모델
결과 전달 건당 고정 요금에 animations에 포함한 동작별 일정 요금을 더합니다. 따라서 동작 5개는 1개보다 요금이 높습니다. 스켈레톤 유형, 본 이름, in_place, 출력 형식은 요금을 바꾸지 않습니다. 실패 시에는 과금하지 않습니다.
활용 사례
생성한 주인공을 브라우저 게임에 넣습니다
in_place를 켜고 idle, walk, jump를 요청한 뒤 GLB를 웹 엔진에 불러옵니다. 캐릭터 컨트롤러가 위치 이동을 처리하고 클립은 신체 동작을 담당합니다.
애니메이션 쇼트의 움직임을 잡습니다
walk나 run을 시작 동작으로 사용해 단순한 회색 미리보기 영상을 렌더링합니다. 이를 3D 레이아웃에 스타일을 입혀 완성된 쇼트로 만드는 영상 모델에 전달합니다.
프롬프트 가이드 및 실전 팁
몸체와 동작을 맞춥니다
텍스트 prompt 대신 animations의 각 행으로 동작을 정합니다. 두 발로 서는 캐릭터에는 사람형 프리셋을 사용합니다. 동물과 크리처에는 rig_type과 함께 해당 몸체용 walk 또는 march 프리셋을 지정합니다.
루트 모션 사용 여부를 먼저 정합니다
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 레퍼런스에서 확인하세요.





