소개
Tripo Auto Rig는 움직임이 없는 3D 모델에 스켈레톤을 구성합니다. 사람, 동물, 판타지 크리처에 사용할 수 있으며 메시와 텍스처를 보존합니다. 결과는 자체 도구에서 포즈와 애니메이션을 작업할 수 있는 GLB 또는 FBX로 받습니다. 본만 필요할 때 사용하며, 한 요청에서 동작까지 얻으려면 Tripo 3D Tools의 Animate 엔드포인트를 사용합니다.
핵심 기능 및 하이라이트
스켈레톤 유형 9개를 제공합니다
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을 지원하며 최대 90MB입니다. 1자 이상 |
rig_type | 아니요 | 스켈레톤 유형입니다. 기본값 auto는 형태를 보고 결정합니다. |
bone_naming | 아니요 | biped 스켈레톤의 본 이름입니다. 기본값 tripo 또는 mixamo, actorcore, unity, unreal, vrm을 선택합니다. |
output_format | 아니요 | 기본값 glb는 브라우저와 웹 엔진용이며 fbx는 데스크톱 애니메이션 소프트웨어용입니다. 형식에 따른 요금 차이는 없습니다. |
요금
$0.36 / 리깅
결과가 전달되면 스켈레톤 유형, 본 이름, 출력 형식에 관계없이 건당 고정 요금을 부과합니다. 지원하지 않는 파일로 인한 실패를 포함해 실패한 실행은 과금 대상에서 제외합니다.
활용 사례
생성한 캐릭터의 포즈를 잡습니다
이미지 기반 3D 도구로 만든 모델을 리깅한 뒤 Blender나 웹 뷰어에서 포즈를 지정합니다. 스틸 이미지, 썸네일, 역동적인 자세의 3D 프린팅에 활용합니다.
아바타와 NPC를 준비합니다
Unity, Unreal, VRM의 본 이름으로 리깅하면 기존 애니메이션 세트나 아바타 파이프라인에 캐릭터를 넣을 수 있습니다.
프롬프트 가이드 및 실전 팁
실루엣이 분명한 모델을 사용합니다
텍스트 prompt는 사용하지 않습니다. 팔을 몸통에서 약간 떼고 다리를 벌린 채 똑바로 선 모델이 가장 깔끔하게 리깅됩니다. 팔다리가 붙어 있거나 팔짱을 낀 자세는 관절 배치를 어렵게 합니다.
다음 작업에 맞춰 형식을 선택합니다
웹에서 사용하거나 Convert 엔드포인트로 보낼 때는 output_format을 glb로 유지합니다. 데스크톱 소프트웨어에는 fbx를 선택합니다. GLB, 바이너리 FBX, OBJ, STL은 최대 90MB까지 업로드합니다. 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 레퍼런스에서 확인하세요.





