Tripo H3.1 API: 가격, 파라미터, 코드

Name: Tripo H3.1 API
SKU: tripo/h3.1/image-to-3d
Price: 0.432 USD
Availability: InStock

Tripo H3.1 소개

제품 사진 한 장으로 형태와 색이 정확한 3D 모델.

POST /jobs/createTask에서 모델 이름을 tripo/h3.1/image-to-3d(으)로 지정하면 호출할 수 있습니다. US$0.432부터.

소개

Tripo H3.1은 Tripo AI가 2026년 3월에 내놓은 이미지-투-3D 모델로, 실제 제작용 에셋을 위해 만들어졌습니다. 이전 H 시리즈보다 더 날카로운 형상, 입력 이미지와의 더 나은 정합, 더 높은 품질의 텍스처를 제공합니다. 이미지 한 장(image_url)을 보내면 바이너리 glTF 파일 한 개(.glb)를 돌려받습니다. 스위치 하나로 끝나는 변환기와 달리, 파이프라인의 모든 단계가 노출되어 있습니다. 메시에 텍스처를 입힐지, PBR 맵, HD 텍스처, 세밀한 지오메트리, 쿼드 토폴로지, 목표 면 수, 실제 크기 스케일링, 최종 방향, 그리고 두 개의 독립된 seed를 각각 설정할 수 있습니다. 프롬프트는 없습니다.

주요 특징

사진을 따르는 형태

부츠 테스트에서 모델은 사진의 비율을 유지했고, 사진이 정면만 보여 주었는데도 힐 루프, 신발끈 고리, 트레드를 올바른 쪽에 배치했습니다. 텍스처를 입힌 결과에는 닳은 가죽, 빨간 신발끈, 스티칭이 메시에 그대로 옮겨졌습니다.

켜고 올릴 수 있는 텍스처

텍스처는 기본으로 켜져 있으며 PBR 세트로 제공됩니다. 저희 기본 설정 파일에는 하나의 재질에 2048픽셀 베이스 컬러 맵, 메탈-러프니스 맵, 노멀 맵이 들어 있었습니다.

토폴로지와 크기를 직접 제어

face_limit은 면 수를 1,000에서 2,000,000 사이로 제한합니다. quad_mesh는 모델링 도구에서 편집하기 쉬운 사각형 폴리곤으로 전환합니다. geometry_quality: detailed는 미세한 표면 디테일에 더 많은 연산을 씁니다. auto_size는 메시를 실제 치수에 맞게 스케일하고, model_orientation: align_image는 사진에 맞춰 메시를 돌립니다.

저희가 측정한 결과

기본 설정에서 1024×1024 가죽 부츠 정면 사진은 167초 만에 45.8 MB GLB로 반환되었고, 1,471,382개의 삼각형과 텍스처 세 장을 담고 있었습니다. 이런 밀도 때문에 브라우저에서 보여 줄 대상에는 face_limit을 설정해야 합니다.

요청 파라미터

파라미터	필수	설명
`auto_size`	아니요	추정한 실제 치수에 맞춰 메시 크기를 조정합니다. 기본값은 꺼짐입니다. 기본값: false
`face_limit`	아니요	목표 면 수(1,000~2,000,000). 비워 두면 모델이 정합니다(종종 100만 면을 넘습니다). ≥ 1000 · ≤ 2000000
`generate_pbr`	아니요	PBR 재질 맵(금속-거칠기, 노멀)을 추가합니다. 기본값은 켜짐이며 텍스처도 함께 켜집니다. 기본값: true
`generate_texture`	아니요	메시에 텍스처를 입힙니다. 기본값은 켜짐이며, 끄더라도 generate_pbr도 꺼져 있어야 텍스처가 제거됩니다. 기본값: true
`geometry_quality`	아니요	형상 디테일: standard(기본) 또는 detailed. detailed는 표면의 더 세밀한 디테일을 만들며 비용이 더 듭니다. standard · detailed · 기본값: standard
`image_url`	예	출발점이 되는 이미지.
`model_orientation`	아니요	default는 표준 방향을 유지하고, align_image는 사진에 맞게 모델을 회전합니다. default · align_image · 기본값: default
`quad_mesh`	아니요	삼각형 대신 사각형(quad) 폴리곤으로 반환합니다. 모델링 도구에서 편집할 때 쓰며, 파일은 GLB 대신 FBX로 반환됩니다. 기본값: false
`seed`	아니요	같은 seed·설정으로 비교 조건을 맞출 수 있습니다. ≥ 0 · ≤ 2147483647
`texture_alignment`	아니요	텍스처를 원본 사진에 맞추거나(기본) 생성된 형상에 맞춥니다. original_image · geometry · 기본값: original_image
`texture_quality`	아니요	텍스처 해상도: standard(기본) 또는 detailed. detailed는 비용이 더 들며 텍스처가 있는 메시에만 적용됩니다. standard · detailed · 기본값: standard
`texture_seed`	아니요	텍스처 단계의 시드입니다. seed는 고정하고 이 값을 바꾸면 같은 형태에서 새 텍스처를 시도할 수 있습니다. ≥ 0 · ≤ 2147483647

가격

요금은 미국 달러 기준입니다. API는 별도의 미국 달러 잔액을 사용합니다. 웹사이트 크레딧은 API에 사용할 수 없으며, API 잔액과 웹사이트 크레딧 간 전환도 지원하지 않습니다. 작업이 접수되면 견적의 최대 금액을 API 잔액에서 예약합니다. 완료 후 실제 사용량으로 정산하고 남은 예약 금액을 해제합니다. 청구액은 예약 금액을 넘지 않으며, 작업이 실패하면 예약 금액을 해제합니다.

옵션	USD /회
기본	US$0.432

실행 전에 같은 요청 본문을 POST /jobs/quote로 보내면 예상 요금과 최대 요금을 미국 달러로 확인할 수 있습니다. 견적만으로는 작업이 실행되거나 요금이 청구되지 않습니다.

활용 사례

게임, AR, 실시간 장면용 에셋

face_limit을 장면의 예산에 맞추고, 에셋을 나중에 편집할 것이라면 quad_mesh를 켜세요. 장면 조명에 반응하도록 PBR은 켜 두세요.

제품 시각화와 인쇄

제품 뷰어에서는 텍스처를 켜 두고, 라벨이나 스티칭을 읽기 쉽게 유지해야 할 때 texture_quality: detailed를 쓰세요. 3D 프린팅이나 조각에는 두 텍스처 스위치를 모두 끄고, 메시가 현실적인 크기로 나오도록 auto_size를 설정하세요.

프롬프트 가이드와 고급 팁

깨끗한 사진으로 시작

피사체는 하나, 프레임에 온전히 들어오고, 배경은 단색으로. 3/4 뷰는 정면 뷰보다 깊이 정보를 더 많이 알려 줍니다. JPEG, PNG, WebP를 10 MB까지 받습니다.

필요한 것만 켜기

기본값으로 face_limit을 설정해 첫 번째 패스를 실행하고, 부족한 단계만 올리세요.

두 개의 seed로 반복하기

seed는 지오메트리를, texture_seed는 텍스처를 고정합니다. seed를 유지하고 texture_seed만 바꾸면 같은 형태에서 새 표면을 시험할 수 있고, texture_seed를 유지하면 형태를 탐색할 수 있습니다.

가려진 쪽 확인하기

사용하기 전에 뷰어에서 GLB를 열어 끝까지 돌려 보세요. 보이지 않는 쪽이 잘못되었다면, 어떤 설정보다 원본 사진의 카메라 각도를 바꾸는 편이 더 도움이 됩니다.

API 빠른 시작

Tripo H3.1 API를 3단계로 호출하기

API 키 만들기. PopNow에 로그인하고 API 콘솔에서 키를 만드세요. 키는 sk-popnow-로 시작하며 API 호출은 별도의 달러 잔액을 사용합니다.
요청 보내기. POST /jobs/createTask에 model은 tripo/h3.1/image-to-3d, input은 파라미터 표에 맞춰 보내세요. 응답으로 작업 ID가 바로 돌아옵니다.
결과 받기. 작업 ID로 GET /jobs/recordInfo를 폴링하거나 callBackUrl을 넘기면 결과를 그 주소로 보내 드립니다. 작업이 성공하면 출력 링크에서 내려받으세요.

# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "tripo/h3.1/image-to-3d",
  "input": {
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "generate_texture": true,
    "generate_pbr": true,
    "texture_quality": "standard",
    "geometry_quality": "standard",
    "model_orientation": "default"
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

프롬프트와 링크는 직접 쓰는 것으로 바꾸세요. 응답, 폴링, 콜백 참고 자료는 API 탭에 있어요.

Tripo H3.1 API 질문

Tripo H3.1 API 요금은 얼마인가요?

Tripo H3.1 가격은 US$0.432 /회입니다. API는 별도의 미국 달러 잔액을 사용합니다. 웹사이트 크레딧은 API에 사용할 수 없으며, API 잔액과 웹사이트 크레딧 간 전환도 지원하지 않습니다. 작업이 접수되면 견적의 최대 금액을 API 잔액에서 예약합니다. 완료 후 실제 사용량으로 정산하고 남은 예약 금액을 해제합니다. 청구액은 예약 금액을 넘지 않으며, 작업이 실패하면 예약 금액을 해제합니다.

API에서 Tripo H3.1의 모델 이름은 무엇인가요?

POST /jobs/createTask의 model 필드에 모델 이름 이미지를 3D로: tripo/h3.1/image-to-3d 값을 입력하세요.

GLB에는 무엇이 들어 있나요?

머티리얼이 내장된 메시 하나입니다. 기본 설정에서 파일에는 베이스 컬러, 메탈릭-러프니스, 노멀 세 장의 텍스처가 모두 2048픽셀로 들어 있었습니다. generate_texture와 generate_pbr를 끄면 맨 메시가 나옵니다.

파일을 작게 하려면?

face_limit를 지정하세요. 웹 뷰어라면 5만~20만 정도가 적당합니다. 비워 두면 모델이 정하며, 테스트에서는 100만 면을 넘었습니다.

결과를 재현할 수 있나요?

네. seed는 형상 단계를, texture_seed는 텍스처 단계를 고정하므로 형태는 두고 텍스처만 바꾸거나 그 반대로 할 수 있습니다.

Tripo H3.1 API의 제한은 무엇인가요?

최대 업로드 크기: 10 MB. 이 범위를 벗어난 요청은 청구되기 전에 거부됩니다.

Tripo H3.1 모델을 코드 없이 사용해 볼 수 있나요?

Playground에서 API 키 없이 API의 미국 달러 잔액으로 Tripo H3.1 모델을 실행할 수 있습니다. 각 실행은 해당 코드와 함께 개발자 기록에 저장됩니다.

Tripo H3.1 더 알아보기

사용해 보기: Tripo H3.1 AI 이미지 생성기 온라인 PopNow에서 Tripo H3.1(으)로 이미지 만들기
문서: API 문서의 Tripo H3.1 모델 ID와 입력 스키마 PopNow API 빠른 시작: 첫 요청 보내기 PopNow API 이미지 생성 가이드 Webhook: 폴링 없이 Tripo H3.1 결과 받기