소개
Tripo Convert는 3D 모델의 파일 형식을 바꾸면서 필요한 정리 작업도 처리합니다. 생성, 리깅, 애니메이션 이후의 마지막 단계에서 같은 캐릭터를 브라우저 게임용 GLB, Blender나 게임 엔진용 FBX, 프린터용 STL로 내보냅니다. 기본 설정에서는 모델의 스켈레톤과 애니메이션 클립도 함께 보존합니다.
핵심 기능 및 하이라이트
변환 후에도 리그와 클립을 유지합니다
애니메이션을 적용한 우주비행사를 FBX로 내보낸 뒤 해당 FBX를 다시 GLB로 변환했습니다. 결과에는 관절 78개, 텍스처 맵 3장, walk 클립이 남았으며 웹 뷰어에서 바로 재생됐습니다.
필요한 정리 옵션을 선택합니다
face_limit은 폴리곤 수를 줄이고, quad_mesh는 모델링 소프트웨어용 사각형 메시로 표면을 재구성합니다. texture_size와 texture_format은 이미지 맵의 크기나 형식을 바꿉니다. pivot_to_bottom, flatten_bottom, scale_factor는 배치나 프린팅에 맞게 모델을 준비합니다. 이 옵션을 사용하면 더 높은 요금으로 처리합니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
mesh_url | 예 | 변환 대상 모델입니다. 최대 90MB의 GLB, 바이너리 FBX, OBJ, STL을 받으며 리깅과 애니메이션이 포함된 파일도 처리합니다. 1자 이상 |
output_format | 예 | 필수 항목입니다. 브라우저와 웹 게임은 glb, 애니메이션 소프트웨어와 엔진은 fbx, 3D 프린팅은 stl을 선택합니다. |
quad_mesh | 아니요 | 기본으로 끕니다. 켜면 사각형 폴리곤으로 리메싱하며 face_limit이 없으면 약 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입니다. 1 이외의 값은 더 높은 요금으로 처리합니다. |
flatten_bottom | 아니요 | 기본으로 꺼져 있으며 켜면 아랫면을 평평하게 만듭니다. 3D 프린팅 전처리에 유용하며 더 높은 요금이 적용됩니다. 기본값: |
forward_axis | 아니요 | 출력 파일에서 모델이 바라보는 축입니다. 기본값 +x 또는 -x, +y, -y를 선택합니다. |
fbx_preset | 아니요 | FBX 출력의 호환성 프리셋입니다. 기본값 blender 외에 3dsmax, mixamo, bake_scale을 선택합니다. |
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로 바꿉니다
애니메이션 도구나 출력 형식을 FBX로 설정한 Rig, Animate의 결과는 브라우저에서 열 수 없습니다. 이를 GLB로 변환해 three.js, Babylon.js 또는 웹 게임 엔진에 불러옵니다.
원하는 포즈를 프린팅합니다
캐릭터의 포즈를 잡거나 애니메이션을 적용한 다음 flatten_bottom을 켜고 STL로 내보내 슬라이서에 전달합니다. STL에는 지오메트리만 저장하므로 색상과 동작은 빠집니다.
프롬프트 가이드 및 실전 팁
사용할 환경에 맞춰 형식을 정합니다
prompt는 입력하지 않습니다. 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 레퍼런스에서 확인하세요.





