소개
Tripo H3.1 Text to 3D는 물체 설명을 보통 텍스처가 있는 GLB로 변환합니다. 먼저 참고 이미지를 만들고 그 이미지로 메시를 생성합니다. image_seed는 첫 이미지 단계에 해당하며 형태와 텍스처에는 별도 시드를 사용합니다.
핵심 기능 및 하이라이트
말로 금속 표면을 지정합니다
오래된 잠수 헬멧은 기본 설정에서 141초, 46.9MB, 약 149만삼각형과 2048픽셀 맵 3장을 생성했습니다. 리벳, 녹청, 둥근 유리창이 보입니다.
구조별로 검토합니다
장난감 로봇은 118초 만에 1.48MB GLB로 나왔으며 텍스처 없는 17노드와 48,411삼각형을 포함합니다. generate_parts는 텍스처와 쿼드를 무시합니다. 그 외에는 quad_mesh가 FBX를 출력합니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 텍스트 입력에서는 물체 설명을 필수로 입력합니다. 텍스트 입력에서는 1,024자 이내로 전체 형태, 재질, 색, 스타일, 크기를 적습니다. 1자 이상 · 1024자 이하 |
negative_prompt | 아니요 | 텍스트 입력에서는 받침대 등 제외할 요소를 255자 이내로 간단히 입력합니다. 255자 이하 |
generate_texture | 아니요 | 텍스트 입력에서는 기본으로 켭니다. 텍스트 입력에서는 색상 텍스처를 없애려면 generate_pbr도 끕니다. 기본값: |
generate_pbr | 아니요 | 텍스트 입력에서는 기본으로 켭니다. 텍스트 입력에서는 generate_texture가 꺼져 있어도 PBR 재질이 텍스처를 활성화합니다. 기본값: |
texture_quality | 아니요 | 텍스트 입력에서는 standard가 기본입니다. 텍스트 입력에서는 detailed와 extreme(8K)은 별도 추가 요금이며 fast는 v3.5를 사용해 standard와 같은 요금입니다. |
texture_version | 아니요 | 텍스트 입력에서는 기본 v3.0-20250812 또는 v3.5-20260815를 선택합니다. 텍스트 입력에서는 fast와 조명 제거는 v3.5를 사용합니다. |
remove_lighting | 아니요 | 텍스트 입력에서는 기본으로 켜지만 v3.5에서만 적용합니다. 텍스트 입력에서는 참고 이미지에 포함된 조명을 제거합니다. 기본값: |
geometry_quality | 아니요 | 텍스트 입력에서는 standard 또는 detailed를 선택합니다. 텍스트 입력에서는 detailed는 형상 세부 처리와 추가 요금이 적용됩니다. |
quad_mesh | 아니요 | 텍스트 입력에서는 GLB 대신 사각 면 FBX를 출력합니다. 텍스트 입력에서는 generate_parts에서는 무시하며 추가 요금도 없습니다. 기본값: |
low_poly | 아니요 | 텍스트 입력에서는 수작업 느낌의 로우폴리 처리로 별도 요금을 적용합니다. 텍스트 입력에서는 face_limit은 20,000 이하를 권장합니다. 기본값: |
generate_parts | 아니요 | 텍스트 입력에서는 텍스처 없는 삼각형 부품으로 나눕니다. 텍스트 입력에서는 텍스처와 쿼드 설정 및 요금을 빼고 부품 분리 요금을 적용합니다. 기본값: |
face_limit | 아니요 | 텍스트 입력에서는 텍스트로 만드는 메시는 1,000~2,000,000면을 지정합니다. 텍스트 입력에서는 low_poly에서는 20,000 이하를 권장합니다. |
auto_size | 아니요 | 텍스트 입력에서는 기본으로 끕니다. 텍스트 입력에서는 실제 크기를 추정해 조정하며 텍스처 출력이 필요합니다. 기본값: |
uv_unwrap | 아니요 | 텍스트 입력에서는 기본으로 켭니다. 텍스트 입력에서는 끄면 처리와 파일 크기가 줄지만 나중에 텍스처를 입힐 UV 좌표가 없습니다. 기본값: |
seed | 아니요 | 텍스트 입력에서는 형태 단계 시드입니다. 텍스트 입력에서는 설정을 하나씩 바꾸며 비교하지만 정확한 재현은 보장하지 않습니다. |
image_seed | 아니요 | 텍스트 입력에서는 3D 재구성 전 참고 이미지 단계의 시드입니다. 텍스트 입력에서는 비교에 사용하지만 정확한 재현은 보장하지 않습니다. |
texture_seed | 아니요 | 텍스트 입력에서는 텍스처 단계 비교용 시드입니다. 텍스트 입력에서는 동일한 표면 결과를 보장하지 않습니다. |
요금
$0.288 / 모델
텍스트 요청은 H3.1 이미지 요청보다 메시 기본 요금이 낮으며 텍스처, detailed 또는 8K, 상세 지오메트리, 쿼드, 로우폴리의 추가 요금 구조는 같습니다. generate_parts는 텍스처와 쿼드 요금을 빼고 부품 분리 요금을 적용합니다. 실패한 요청에는 과금하지 않습니다.
활용 사례
사진 없이 소품을 구상합니다
헬멧, 주전자, 장난감을 설명하고 먼저 비율과 색상, 재질 방향을 평가합니다.
편집할 구조를 준비합니다
분리된 부품을 편집기에서 확인하고 직접 재질을 지정합니다. 출력 전에는 지오메트리와 치수를 검토합니다.
프롬프트 가이드 및 실전 팁
주된 형태부터 설명합니다
전체가 보이는 물체 하나에 형태, 재질, 색, 스타일, 크기를 적습니다. prompt는 1,024자, 간단한 제외 목록인 negative_prompt는 255자까지 입력합니다.
복잡한 비유는 단순해질 수 있습니다
여우 요소는 일부만 구현됐습니다. 주황색 유약 주전자의 주둥이에는 뾰족한 귀, 코, 눈이 있는 작은 여우 머리가 있으며, 뒷면에는 귀나 꼬리 같은 주황색 돌기가 있습니다. 웅크려 잠든 여우의 몸통과 꼬리로 만든 손잡이는 구현되지 않았으며, 손잡이는 일반적인 높은 고리 형태입니다. 실측 결과 91초가 걸렸으며 59,722삼각형, 3.38MB 파일이 생성됐습니다.
출력을 조정합니다
face_limit은 1,000~2,000,000이며 low_poly에서는 20,000 이하를 권장합니다. 세 시드로 한 단계씩 비교하되 정확한 재현을 기대하지 않습니다. 가려진 면과 구멍도 확인합니다.
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/text-to-3d",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"low_poly": false,
"quad_mesh": false,
"generate_pbr": true,
"generate_parts": false,
"texture_quality": "standard"
}
}'
# 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 레퍼런스에서 확인하세요.










