Tripo Texture

v3.5-20260815

기존 3D 모델을 위한 PBR 텍스처링.

빠른 시작

최대 해상도

품질 단계

fast / standard / detailed / 8K

가이드 방식

텍스트 / 이미지 / 2~4개 뷰

입력

GLB/GLTF/FBX/OBJ/STL

출력

PBR 텍스처 적용 모델

기존 3D 모델의 PBR 텍스처를 생성하거나 다시 생성합니다. 모델은 task_id, 업로드한 파일 또는 URL로 전달하고, 텍스트, 단일 이미지 또는 다중 뷰로 결과를 가이드할 수 있습니다. 텍스처 v3.5는 조명 제어(delight), 고속 모드, 더 정밀한 지오메트리 정렬을 추가했으며 뷰 간 결과의 일관성도 높였습니다. v3.5는 명시적으로 지정해야 합니다. 텍스처 엔드포인트에서는 model을, 생성 엔드포인트에서는 texture_version을 사용하세요. 지정하지 않으면 기본값인 v3.0이 사용됩니다. 업그레이드는 새 작업에만 적용되며, 기존 모델과 텍스처는 변경되지 않습니다.

조명 제어(delight, 기본적으로 켜짐): 실사풍 게임에서는 켜 두어 Unity, Unreal, Godot 조명에서도 깨끗한 베이스 컬러를 얻고, 렌더링, VFX, CG에서는 꺼서 스타일라이즈드 조명을 유지
고속 모드: texture_quality=fast, standard와 동일한 크레딧
지오메트리 정렬 개선: 디테일이 제자리에 정확히 배치되고 뷰 간 결과의 일관성이 향상됨
텍스트, 스타일 이미지, 단일 이미지 또는 2~4개 뷰로 가이드; PBR, 파트별 리텍스처링, 8K 지원

가격

가격은 작업 유형과 특정 매개변수를 기준으로 책정됩니다. 표준 텍스처를 생성하거나 프리미엄 토폴로지 옵션을 사용하면 추가 비용이 발생합니다.

품질	크레딧
고속(fast)	10
표준(standard)	10
HD(detailed)	20
8K(extreme)	30

fast에는 텍스처 v3.5-20260815가 필요하며, 다른 텍스처 버전을 사용하면 standard로 대체되지 않고 오류 1004가 반환됩니다

생성 작업 안에서 텍스처링하면 텍스처 출력은 지오메트리만 생성할 때보다 10크레딧이 더 들고, HD는 10크레딧, 8K는 20크레딧이 추가됩니다

엔드포인트

자세한 API 문서 및 코드 예제로 바로 이동하려면 아래 엔드포인트 카드 중 하나를 클릭하세요.

텍스처

v3/models/texture

텍스트를 3D 모델로

v3/generation/text-to-model

이미지를 3D 모델로

v3/generation/image-to-model

멀티뷰에서 3D 모델로

v3/generation/multiview-to-model

매개변수

model

/v3/models/texture의 텍스처 버전: v3.0-20250812(기본값, v3.0 / v3.1 모델용), v3.5-20260815(최신; 명시적으로 지정) 또는 v2.5-20250123(v2.5 모델용)

texture_version

생성 엔드포인트의 텍스처 버전; 값은 model과 동일. 생략하면 지오메트리 모델을 따름(v2.5 → v2.5, 그 외에는 v3.0)

texture_quality

fast(v3.5 전용, 크기와 크레딧은 standard와 동일), standard(기본값), detailed(HD) 또는 extreme(8K)

delight

참조 이미지에 베이크된 조명을 제거(기본값: true). 실사풍 게임에서는 켜 두고, 렌더링 / CG에서는 꺼서 스타일라이즈드 조명을 유지; v3.5 전용이며 이전 버전에서는 무시됨

texture_prompt

텍스처 가이드: text(style_image와 함께 사용 가능), image 또는 images(정면 필수, 최소 2개 뷰. view-key 객체 형식 권장, 또는 [정면, 왼쪽, 후면, 오른쪽] 4개 위치로 전달하고 없는 뷰는 null). text / image / images는 상호 배타적

texture_alignment

original_image(기본값, 입력 이미지 색상에 맞춤) 또는 geometry(생성된 지오메트리에 맞춤)

texture_seed

무작위 시드; 같은 시드를 사용하면 동일한 텍스처가 재현됨

pbr

PBR 재질 생성(기본값: true)

part_names

메시 분할 작업의 파트 이름; 생략하면 모든 파트를 텍스처링

bake

호환성을 위해 고급 재질 효과를 기본 텍스처에 베이크(기본값: true)

compress

geometry: meshopt 압축으로 파일 크기를 줄임

비율 제한

속도 제한은 병렬 요청에 특정 한도를 적용하여 API에 대한 공정하고 안정적인 액세스를 보장합니다. 사용 등급에 따라 이러한 한도가 얼마나 높게 설정되는지가 결정됩니다.

카테고리	동시성 제한
모델 처리(형식 변환과 공유)	5개의 병렬 작업

스냅샷

스냅샷을 사용하면 모델의 특정 버전을 고정하여 성능과 동작의 일관성을 유지할 수 있습니다.

v3.5-20260815	최신: 조명 제어 및 고속 모드 지원; 명시적으로 지정
v3.0-20250812	기본값; v3.0 / v3.1로 생성된 모델용
v2.5-20250123	v2.5로 생성된 모델용