블로그

사용 가이드

Tripo H3.1 시작 가이드: 세 가지 입력 방식, 파라미터와 가격 선택법

개발자를 위한 3D 생성 연동 의사결정과 비용 제어 실무

Nov 20, 2026
비스듬한 빛 아래 콘크리트 기하학 평면을 담은 추상 커버 이미지로, 회색 바탕에 슬레이트 블루 그림자와 가느다란 세이지색 이음선이 있습니다.
이 페이지에서

Tripo H3.1이 할 수 있는 일과 경계

Tripo H3.1은 3D 생성 모델로, HiAPI.ai의 통합 인터페이스 아래 연결되어 API key 하나로 호출할 수 있습니다. 세 가지 입력 형태를 지원합니다: 자연어 설명(text-to-3d), 단일 객체 이미지(image-to-3d), 그리고 동일 객체의 2–4장 멀티뷰 이미지(multiview-to-3d)입니다.

출력은 고정된 산출물 조합입니다: GLB 모델 파일 하나 + 미리보기 이미지 한 장. 추가 머티리얼 텍스처 패키지도, 프로젝트 파일도, 스켈레톤 바인딩이나 애니메이션도 없습니다. GLB는 범용 포맷이므로 받은 후 Blender, Three.js, Unity 또는 glTF를 지원하는 어떤 파이프라인에도 바로 넣을 수 있습니다.

경계도 분명히 짚어야 합니다:

  • 객체 단위 생성이지 장면 단위 생성이 아닙니다. 의자 이미지를 입력하면 의자가 나오지, 의자가 놓인 방이 나오지 않습니다. 장면이 필요하면 여러 모델을 직접 조합해야 합니다.
  • "동작"을 이해하지 못합니다. 정적 에셋이 주 활용 영역이며, 바인딩, 스키닝, 동작 시퀀스는 역량 범위 밖입니다.
  • 소재 품질이 곧 출력 상한입니다. 흐릿하거나, 여러 객체가 있거나, 복잡하게 가려진 입력 이미지는 기하 품질을 크게 떨어뜨리며, 이는 세 경로 모두에 해당합니다.
  • 과금은 호출당이며, 한 번의 호출이 모델 하나를 산출하고, 토큰당이나 초당 과금 같은 중간 상태가 없습니다. 이 특성은 비용 예측에 유리합니다—호출 횟수가 곧 과금 단위입니다.

이 범위를 이해해야 다음 선택이 의미를 가집니다: 세 경로는 같은 것의 세 가지 입구가 아니라, 단가, 소재 진입 장벽, 적용 시나리오가 모두 다릅니다.

세 가지 입력이 같은 깔때기를 거쳐 단일 모델과 미리보기 출력으로 수렴하며, 경계도 그 수렴 지점에서 드러납니다.

세 가지 입력 경로 선택법

경로 선택의 첫 원칙은 "어느 것이 효과가 좋은가"가 아니라 당신에게 어떤 소재가 있는가입니다.

텍스트 설명만 있음 → 텍스트 3D. 개념 탐색, 임시 에셋, 초기 프로토타입에 적합합니다. 생성 방향을 완전히 통제할 수 있지만 모든 불확실성도 떠안습니다: 모델이 면 수와 형태를 추론하는 근거는 전적으로 당신의 설명어입니다. 시작 가격대가 가장 낮아 대량 시행착오에 적합합니다.

깨끗한 제품 이미지나 객체 사진 한 장이 있음 → 이미지 3D. 대다수 개발자가 실제로 택하는 경로입니다. 객체를 정면으로 담고 배경이 깨끗한 이미지 한 장은 텍스트 설명보다 정보량이 훨씬 많아 기하 재현도가 눈에 띄게 안정적입니다. 소재 진입 장벽도 높지 않습니다: 한 장 찍고 배경만 따면 됩니다.

서로 다른 각도의 이미지 2–4장이 있음 → 멀티뷰 3D. 이미 다각도 소재(예: 제품 촬영 스튜디오의 표준 4면 뷰, 또는 기존 3D 에셋에서 렌더링한 턴테이블 프레임)가 있을 때 멀티뷰는 정밀도 상한이 가장 높은 단계입니다. 단일 이미지 생성의 "뒷면은 추측"이라는 구조적 문제를 해결합니다.

주목할 가격 사실: 이미지와 멀티뷰는 같은 가격이며 텍스트 3D가 더 저렴합니다. 따라서 소재가 갖춰진 전제라면 멀티뷰에 추가 프리미엄이 없습니다—소재가 있으면 멀티뷰를 쓰면 되고, 단일 이미지로 돌아갈 이유가 없습니다.

결정은 한 문장으로 단순화됩니다: 소재가 멀티뷰에 충분하면 멀티뷰를, 좋은 이미지 한 장이 있으면 이미지 3D를, 아무것도 없을 때만 텍스트 3D를 쓰면 됩니다.

입력 파라미터와 소재 준비 핵심

세 경로의 입력 필드는 각각 다르며, 혼용하면 바로 실패합니다.

텍스트 3D(모델 페이지)는 자연어 설명을 받습니다. prompt를 잘 쓰는 요점은 구체화입니다: 객체 유형, 재질 경향, 형태 특징이 형용사 나열보다 효과적입니다.

이미지 3D(모델 페이지)는 image_url, 즉 HTTPS 이미지 한 장을 사용합니다. 소재 요건:

  • 단일 객체, 여러 객체가 한 프레임에 있으면 안 됨
  • 배경이 깨끗해야 하며, 주체와 같은 색의 어수선한 환경은 피할 것
  • 객체 주체가 화면을 최대한 채우도록 할 것
  • URL은 공개 접근 가능해야 하며(HTTPS), 인증이 필요한 사설 주소를 넘기지 말 것

멀티뷰 3D(모델 페이지)는 image_urls, 즉 동일 객체의 2–4장 이미지를 사용하며, 순서는 정면, 좌측, 후면, 우측으로 고정입니다. 순서 뒤바뀜은 가장 흔한 실패 원인 중 하나입니다: 모델은 위치에 따라 시점을 가정하므로, 이미지가 잘못된 위치에 놓이면 잘못된 기하 제약을 준 셈입니다.

소재 준비에는 두 가지 일반 권장 사항이 있습니다. 첫째, 멀티뷰의 여러 이미지는 조명과 스케일을 최대한 일치시켜야 합니다. 서로 다른 출처의 사진을 혼용하면 모델이 접합부에서 모호성을 겪습니다. 둘째, 이미지 해상도를 극단적으로 높일 필요는 없으며, 선명하고 주체가 명확한 것이 픽셀 수보다 중요합니다.

파라미터가 유효하지 않은(필드 누락, URL 형식 오류, 뷰 수 범위 초과) 요청은 바로 거부되며 과금되지 않습니다—이 점은 다음 절의 문제 해결 체크리스트에서도 다시 쓰입니다.

face_limit과 기하 품질: 모델 복잡도 제어

face_limit는 출력 면 수를 제어하는 핵심 파라미터이며, 범위는 1000–1,500,000입니다. geometry_quality가 detailed로 설정되면 상한이 2,000,000으로 완화됩니다.

핵심 설계는 이 파라미터를 생략할 수 있다는 점입니다. 생략하면 모델이 면 수를 적응적으로 결정하며, 보통 객체 복잡도에 맞는 합리적인 값을 제시합니다. 다운스트림의 면 수 예산을 명확히 알고 있을 때만 수동으로 지정하면 됩니다:

  • 모바일 또는 Web 실시간 렌더링: 낮은 구간, 수만 면 이내로 제어
  • 게임 내 중경 에셋: 중간 구간
  • 영상급 또는 오프라인 렌더링: 상한에 가깝게, 정밀 기하와 함께

geometry_quality는 두 가지 값을 가집니다: standard(표준 기하, 기본값)와 detailed(정밀 기하). detailed는 더 높은 기하 디테일과 더 높은 면 수 상한을 제공하지만 추가 과금되는 옵션이며, 세 경로 모두 마찬가지입니다. 판단 기준은 간단합니다: 이 에셋이 근거리에서 보이거나 디테일 자체가 판매 포인트일 때만 켤 가치가 있으며, 원경이나 임시 에셋에 detailed를 켜는 것은 순전한 낭비입니다.

둘의 조합에 대한 실무 권장: 먼저 기본 설정( face_limit 생략, geometry_quality는 standard)으로 한 버전 돌려 결과를 본 뒤, 구체적인 에셋에 맞춰 파라미터를 조정하세요. 시작부터 파라미터를 최대로 채우지 마세요. 돈만 더 들고 더 나은 결과를 얻는다는 보장도 없습니다.

가격 구조 분석: 비용이 어느 단계에 쓰이는가

Tripo H3.1은 호출당 과금이며, 호출 한 번에 모델 + 미리보기 이미지가 산출됩니다. 가격은 네 가지 변수가 함께 결정합니다: 입력 경로, Texture 스위치, PBR 스위치, 기하 품질. 이 구조를 이해한 뒤 아래의 전체 정가표와 대조해 단계를 고르면 됩니다.

현재 테스트 환경 정가는 다음과 같으며, 호출당, 모델 하나 기준, 단위 USD입니다.

텍스트 3D(tripo-h3.1/text-to-3d)

사양표준 텍스처정밀 텍스처
PBR 끔 · Texture 끔$0.150$0.150
PBR 끔 · Texture 켬$0.290$0.430
PBR 켬$0.290$0.430

이미지 3D(tripo-h3.1/image-to-3d)와 멀티뷰 3D(tripo-h3.1/multiview-to-3d)는 동일 가격

사양표준 텍스처정밀 텍스처
PBR 끔 · Texture 끔$0.290$0.290
PBR 끔 · Texture 켬$0.430$0.580
PBR 켬$0.430$0.580

위 각 단계에서 정밀 기하를 선택하면 $0.290이 추가 부과됩니다.

첫째 층: 입력 경로. 텍스트 3D의 시작 단계가 가장 낮고, 이미지와 멀티뷰는 동일 가격이며 텍스트보다 높습니다. 이는 직관에 부합합니다: 이미지와 멀티뷰가 입력하는 정보가 더 많고, 모델이 하는 일도 더 많습니다.

둘째 층: Texture와 PBR 스위치, 이것이 가격의 주 증폭기입니다. 두 스위치를 모두 끄면 기본 단계이고, Texture를 켜면 단가가 한 단계 올라가며, PBR을 켜면 같은 단계 또는 더 높은 단계에 위치합니다. 다시 말해 "순수 기하"에서 "텍스처와 PBR을 갖춘" 완전한 에셋으로 가면 단가가 두 배 이상이 될 수 있습니다. 이것이 전체 표에서 가장 큰 가격 변수이며, 입력 경로의 차이보다 훨씬 두드러집니다.

셋째 층: 텍스처 정밀도. 텍스처를 켠 전제에서 표준 텍스처와 정밀 텍스처는 두 가지 가격입니다. 정밀 텍스처는 텍스트 경로에서 프리미엄이 특히 두드러집니다.

넷째 층: 기하 품질. detailed 정밀 기하를 선택하면 위 가격에 추가 부과되며, 세 경로의 추가 부과액은 동일합니다.

여기서 몇 가지 가격 판단이 나옵니다:

  • 다운스트림에 기하체만 필요하다면(예: 충돌체, 이후 수작업 텍스처링을 위한 베이스 모델), Texture와 PBR을 끄면 단가가 즉시 최저 단계로 내려갑니다.
  • 프로토타입 검증만 한다면 텍스트 3D + 모든 스위치 끔이 가장 저렴한 조합입니다.
  • 진짜로 비싼 것은 "정밀 텍스처 + PBR + 정밀 기하" 세트를 모두 켠 완전한 납품이며, 이는 에셋을 정식 출시하기로 확정한 뒤에야 내릴 결정이어야 합니다.
세 단계 과금의 적층 대조: 텍스처와 PBR 스위치는 단계적으로 올라가는 판처럼 1회 가격을 한 단계씩 끌어올립니다.

대표 시나리오의 권장 구성과 비용 추정

구조를 구체적인 조합에 적용해 봅니다. 아래 방안은 모두 호출 1회를 단위로 하며, 실제 비용은 호출 횟수에 따라 누적됩니다.

프로토타입과 개념 탐색

텍스트 3D, Texture 끔, PBR 끔, geometry_quality는 standard, face_limit 생략. 이는 전체 모델의 최저 단계로, 한 번에 십여 개 방향을 생성해 빠르게 선별하기에 적합합니다. 선별을 통과한 방안에 대해서는 다시 텍스처를 켠 버전으로 한 번 더 돌립니다.

이커머스 / 제품 전시 에셋

제품 이미지가 있으면 이미지 3D를, 표준 4면 뷰 소재가 있으면 멀티뷰를 씁니다. Texture 켬, PBR 켬(PBR은 재질 질감 표현에 실질적 가치가 있으며, 전시 시나리오에서는 이 비용을 쓸 가치가 있습니다), 텍스처는 표준 단계, 기하는 standard. 상품이 클로즈업으로 보인다면 정밀 텍스처 승격을 고려합니다.

게임 / 실시간 렌더링 에셋

이미지 또는 멀티뷰, Texture 켬, PBR은 렌더링 파이프라인에 따라 결정(파이프라인이 PBR을 지원하면 켬). face_limit는 대상 플랫폼에 맞춰 수동 설정하고, 적응형에 맡기지 마세요. 기하 품질은 기본 standard—실시간 렌더링에서는 detailed의 이점이 보통 드러나지 않습니다.

기하 베이스 모델만 필요

아무 경로나, Texture와 PBR 모두 끔, 기하 품질은 필요에 따라 선택. 이는 비용을 구조적으로 최저로 누르는 방법이며, 이후 텍스처링은 아트 파이프라인에 맡깁니다.

일반적인 비용 절감 리듬: 먼저 저가 단계로 방향을 검증하고, 확정된 에셋에 대해서만 고가 단계를 켜서 다시 돌립니다. 모든 시행착오에 전액을 지불하지 마세요.

연동 문제 해결과 검증 체크리스트

연동 기간에 가장 중요한 메커니즘: 파라미터가 유효하지 않은 요청은 바로 거부되며 과금되지 않습니다. 이는 개발 단계에서 과감히 시행착오할 수 있다는 뜻입니다—필드 이름 오타, URL 형식 오류, 뷰 수 범위 초과의 대가는 청구서가 아니라 오류입니다. 이 특성을 잘 활용해 먼저 파라미터 검증을 통과시킨 뒤 효과를 논하세요.

출시 전 검증 체크리스트:

  1. URL 접근성: 익명 요청으로 image_url / image_urls를 한 번 테스트해 HTTPS이며 인증 없이 접근 가능한지 확인합니다. 로컬에서 열린다고 공인망에서 가져올 수 있는 것은 아닙니다.
  2. 멀티뷰 순서: 한 장씩 정면, 좌측, 후면, 우측인지 대조합니다. 이것이 가장 빈번한 무음 오류입니다—요청은 성공하지만 결과가 나빠지며, 원인을 귀속시키기 어렵습니다.
  3. 뷰 수: 멀티뷰는 엄격히 2–4장으로 제어합니다.
  4. face_limit 경계: 수동 지정 시 1000–1,500,000 내인지 확인하고, detailed 사용 시에만 상한이 2,000,000으로 완화됩니다. 범위를 벗어나면 거부됩니다.
  5. 스위치와 기대의 일치: Texture / PBR 스위치가 예상한 가격 단계와 맞는지 확인합니다. 기본 설정과 최종 설정 사이에서 "껐다고 생각했는데 사실 켜져 있던" 편차가 가장 쉽게 생깁니다.
  6. 산출물 검증: 호출마다 GLB 하나와 미리보기 이미지 하나를 받아야 합니다. 연동 계층에서 둘 다 존재하는지 검증한 뒤 다운스트림으로 넘깁니다.
  7. 실패 재시도 전략: "파라미터 거부"(파라미터를 고치고 재시도하지 않음)와 "네트워크/서비스 이상"(재시도 가능)을 구분해, 반드시 실패할 요청에 반복 과금 호출을 하지 않도록 합니다.

이 체크리스트를 한 번 훑으면 대다수 연동 기간의 문제를 첫 출시 전에 해결할 수 있습니다.

세 가지 입력 경로는 세 가지 소재 현황에 대응하고, 두 스위치가 가격 규모를 결정하며, face_limit는 명확한 예산이 있을 때만 건드리면 됩니다. 이 순서로 결정하면 Tripo H3.1 연동은 상당히 직관적입니다—모델 페이지에서 첫 호출을 실행하면 됩니다.

영구 AI 아티팩트로 빌드 시작하기

API 키를 받아 태스크 기반의 하나의 API로 이미지, 비디오, 오디오 모델을 호출하세요.

API 문서 보기