소개
Tripo H3.1은 Tripo AI가 2026년 3월에 선보인, 프로덕션급 에셋을 위한 이미지-3D 모델로, 이전 H 시리즈보다 형상이 선명하고 입력 이미지에 더 충실하며 텍스처 품질이 높습니다. 이미지 한 장(image_url)을 보내면 바이너리 glTF 파일(.glb) 하나가 돌아옵니다. 스위치 하나짜리 변환기와 달리 파이프라인의 모든 단계가 열려 있습니다. 메시에 텍스처를 입힐지, PBR 맵, 고해상도 텍스처, 정밀 형상, 쿼드 토폴로지, 목표 면 수, 실제 크기 스케일, 최종 방향, 그리고 두 개의 별도 시드까지. 프롬프트는 없습니다.
핵심 기능 및 하이라이트
이미지를 따르는 형태
부츠 테스트에서 모델은 사진의 비율을 지켰고, 사진이 정면뿐이었는데도 힐 루프, 신발끈 고리, 밑창을 올바른 쪽에 붙였습니다. 텍스처 결과에는 낡은 가죽, 빨간 신발끈, 스티치가 메시 위에 옮겨졌습니다.
켜고 끄고 올릴 수 있는 텍스처
텍스처는 기본으로 켜져 있고 PBR 세트 전체로 나옵니다. 기본 설정의 파일에는 2048픽셀 베이스 컬러, 메탈릭-러프니스, 노멀 맵이 머티리얼 하나에 담겨 있었습니다. texture_quality: detailed는 더 높은 해상도의 텍스처를 요청하고, extreme은 8K 텍스처를 요청합니다. fast는 표준 크기를 유지하면서 더 빨리 끝납니다. generate_texture와 generate_pbr를 둘 다 끄면 가장 싼 단색 메시가 돌아옵니다.
토폴로지와 크기를 직접 결정
face_limit는 면 수 상한을 1,000에서 2,000,000 사이로 정하고, quad_mesh는 모델링 툴에서 편집하기 좋은 사각형 폴리곤으로 바꾸며, geometry_quality: detailed는 표면 디테일에 더 많은 공을 들입니다. auto_size는 메시를 실제 크기로 맞추고 model_orientation: align_image는 이미지에 맞게 방향을 돌립니다.
로우 폴리 메시와 파트 분리
low_poly는 밀도 높고 스캔 같은 표면을 깔끔한 로우 폴리 토폴로지로 바꿔 단순한 소품에 맞춥니다. 검증용 부츠를 face_limit: 5000으로 돌렸더니 약 3분 만에 0.38MB GLB가 나왔고, 7,675개 삼각면이었습니다. generate_parts는 대신 피사체를 하나의 GLB 안에서 이름 붙은 파트로 나눕니다. 검증용 우주비행사 장난감은 78초 만에 텍스처 없는 파트 18개, 총 47,304개 삼각면으로 나왔습니다.
실측 결과
기본 설정에서 가죽 부츠를 정면에서 찍은 1024×1024 이미지는 167초 만에 1,471,382개 삼각면과 텍스처 세 장이 담긴 45.8MB GLB가 되었습니다. 이 밀도 때문에 브라우저에서 보여 줄 것이라면 face_limit를 지정해야 합니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
image_url | 예 | 모델로 만들 이미지. JPEG, PNG, WebP, 최대 10MB. 1자 이상 |
generate_texture | 아니요 | 기본 켜짐. 메시에 텍스처를 입힙니다. 기본값: |
generate_pbr | 아니요 | 기본 켜짐. 베이스 컬러에 더해 PBR 머티리얼 맵(메탈릭-러프니스, 노멀)을 만들고, generate_texture가 꺼져 있어도 텍스처를 켭니다. 기본값: |
texture_quality | 아니요 | standard(기본값), detailed, extreme 또는 fast 중 하나입니다. detailed는 고해상도 텍스처를, extreme은 8K 텍스처를 만들며 둘 다 가격에 더해집니다. |
texture_version | 아니요 | v3.0-20250812(기본값) 또는 새 버전인 v3.5-20260815. texture_quality의 fast와 remove_lighting은 v3.5에 의존합니다. |
remove_lighting | 아니요 | 기본 켜짐. 텍스처를 입히기 전에 이미지에 구워진 하이라이트와 그림자를 제거해서, 모델이 사용자 장면의 조명에 반응하게 합니다. 기본값: |
geometry_quality | 아니요 | standard(기본값) 또는 detailed. detailed는 표면 디테일을 더 세밀하게 만들며 가장 비싼 추가 옵션입니다. |
quad_mesh | 아니요 | 기본 꺼짐. 켜면 삼각형 대신 사각형 폴리곤으로 돌려주어 모델링 툴에서 편집하기 쉽고, 이때 파일은 GLB가 아닌 FBX(텍스처 내장)로 옵니다. 기본값: |
low_poly | 아니요 | 기본 꺼짐. 켜면 깔끔하고 손으로 모델링한 듯한 토폴로지의 가벼운 메시를 만들며, 단순한 소품에 가장 적합합니다. 기본값: |
generate_parts | 아니요 | 기본 꺼짐. 켜면 모델을 하나의 GLB 안에 이름이 붙은 개별 파트로 돌려줍니다(우리 장난감 우주비행사 기준 18개 파트). 기본값: |
face_limit | 아니요 | 선택 사항인 목표 면 수, 1,000~2,000,000. 비워 두면 모델이 정하며 100만 면을 넘을 수 있습니다. |
image_autofix | 아니요 | 기본 꺼짐. 켜면 모델링 전에 흐리거나 노이즈가 많거나 저해상도인 이미지를 보정하며, 시간이 더 걸립니다. 기본값: |
model_orientation | 아니요 | default는 모델 기본 방향을 유지하고, align_image는 이미지의 시점에 맞게 결과를 회전합니다. 가격은 변하지 않습니다. |
texture_alignment | 아니요 |
|
auto_size | 아니요 | 기본 꺼짐. 켜면 추정한 실제 크기로 메시를 스케일링해 AR과 프린트에 유용합니다. 기본값: |
uv_unwrap | 아니요 | 기본 켜짐. 끄면 UV 언래핑을 건너뛰어 더 빠르고 작은 파일이 나오지만, 메시에 나중에 텍스처를 입히기 위한 텍스처 좌표가 없게 됩니다. 기본값: |
seed | 아니요 | 형상 단계의 선택 시드. 고정하면 같은 형태를 재현합니다. |
texture_seed | 아니요 | 텍스처 단계의 선택 시드. seed를 고정하고 이것을 바꾸면 같은 형태에 새 텍스처를 시험할 수 있습니다. |
요금
$0.432 / 모델
모델이 전달될 때 요청마다 한 번 과금됩니다. 메시 기본 가격에 텍스처(generate_texture 또는 generate_pbr), 고해상도 또는 8K 텍스처, 정밀 형상, 쿼드 토폴로지, 로우 폴리 토폴로지, 파트 분리의 고정 추가 요금이 붙습니다. generate_parts를 켜면 파트는 텍스처 없는 삼각형 메시이므로 텍스처와 쿼드 추가 요금은 빠집니다. 면 수, 스케일, 방향, 정렬, 텍스처 버전, 조명 제거, UV 언래핑, 이미지 보정, 시드는 가격에 영향이 없고 실패한 요청은 과금되지 않습니다.
활용 사례
게임, AR, 실시간 장면용 에셋
face_limit를 장면의 예산에 맞추고, 편집할 에셋이면 quad_mesh를 켜고, 장면 조명에 반응하도록 PBR은 켜 두세요. 소품 하나에 요청 한 번이면 에셋 세트의 통일감이 유지되고 다시 만들기도 저렴합니다.
제품 시각화와 3D 프린트
제품 뷰어에는 텍스처를 켜 두고, 라벨이나 스티치가 읽혀야 하면 texture_quality: detailed를 쓰세요. 3D 프린트나 스컬프팅에는 텍스처 스위치 두 개를 모두 끄고 auto_size로 현실적인 크기의 메시를 받으세요.
프롬프트 가이드 및 실전 팁
깨끗한 이미지로 시작하기
피사체 하나, 프레임 안에 전부, 단색 배경. 45도 각도는 정면보다 깊이에 대해 더 많이 알려 줍니다. JPEG, PNG, WebP를 10MB까지 받습니다.
필요한 것만 켜기
유료 옵션은 모두 가격에 더해집니다. 텍스처, 고해상도 또는 8K 텍스처, 정밀 형상, 쿼드 토폴로지, 로우 폴리 토폴로지, 파트 분리입니다. 먼저 기본 설정에 face_limit를 붙여 돌려 보고 부족한 단계만 올리세요.
두 시드로 반복하기
seed는 형상을, texture_seed는 텍스처를 고정합니다. seed를 유지하고 texture_seed를 바꾸면 같은 형태에 새 표면을 시험할 수 있고, texture_seed를 유지한 채 형태를 탐색할 수도 있습니다.
숨은 면 확인하기
쓰기 전에 뷰어에서 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/h3.1/image-to-3d",
"input": {
"generate_parts": false,
"generate_pbr": true,
"generate_texture": true,
"geometry_quality": "standard",
"image_url": "https://example.com/reference.png",
"low_poly": 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 레퍼런스에서 확인하세요.










