소개
Tripo P1은 Smart Mesh P1.0이라고도 부르는 Tripo AI의 이미지 기반 3D 모델입니다. 목표 범위는 50~20,000면이며, 깔끔한 저폴리곤 메시를 직접 생성합니다. 게임 소품, 모바일 3D, 사용자 제작 콘텐츠에 활용하며 텍스처를 GLB에 포함할 수 있습니다.
핵심 기능 및 하이라이트
적은 면으로 형태를 살립니다
주황색과 흰색 우주비행사 장난감은 4,970삼각형으로 바이저와 배낭을 유지했습니다. 기본 설정 테스트는 82초가 걸렸으며 UV와 2048픽셀 텍스처 3장을 포함한 2.67MB GLB를 반환했습니다.
직접 마감할 기본 형태를 제공합니다
목표 3,000면에 텍스처와 UV를 끈 부츠는 19초 만에 2,804삼각형, 0.07MB로 완성됐습니다. 재질은 없지만 신발 끈, 굽, 밑창 무늬는 확인할 수 있습니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
image_url | 예 | P1에서는 10MB 이하의 JPEG, PNG, WebP로 물체 하나의 전체 모습을 지정합니다. 1자 이상 |
generate_texture | 아니요 | P1에서는 기본으로 켭니다. P1에서는 색상 텍스처를 없애려면 generate_pbr도 끕니다. 기본값: |
generate_pbr | 아니요 | P1에서는 기본으로 켭니다. P1에서는 generate_texture가 꺼져 있어도 PBR 재질이 텍스처를 활성화합니다. 기본값: |
texture_quality | 아니요 | P1에서는 standard가 기본입니다. P1에서는 detailed와 extreme(8K)은 별도 추가 요금이며 fast는 v3.5를 사용해 standard와 같은 요금입니다. |
texture_version | 아니요 | P1에서는 기본 v3.0-20250812 또는 v3.5-20260815를 선택합니다. P1에서는 fast와 조명 제거는 v3.5를 사용합니다. |
remove_lighting | 아니요 | P1에서는 기본으로 켜지만 v3.5에서만 적용합니다. P1에서는 참고 이미지에 포함된 조명을 제거합니다. 기본값: |
face_limit | 아니요 | P1에서는 목표를 50~20,000면으로 지정합니다. P1에서는 생략하면 모델이 정합니다. |
image_autofix | 아니요 | P1에서는 기본으로 끕니다. P1에서는 흐리거나 저해상도인 이미지를 먼저 보정하여 처리 시간이 늘어납니다. 기본값: |
model_orientation | 아니요 | P1에서는 default는 일반 방향을 사용하며 align_image는 참고 이미지 방향에 맞춥니다. |
texture_alignment | 아니요 | P1에서는 original_image는 원본 이미지에, geometry는 생성한 형태에 텍스처를 맞춥니다. |
auto_size | 아니요 | P1에서는 기본으로 끕니다. P1에서는 실제 크기를 추정해 조정하며 텍스처 출력이 필요합니다. 기본값: |
uv_unwrap | 아니요 | P1에서는 기본으로 켭니다. P1에서는 끄면 처리와 파일 크기가 줄지만 나중에 텍스처를 입힐 UV 좌표가 없습니다. 기본값: |
seed | 아니요 | P1에서는 형태 단계 시드입니다. P1에서는 설정을 하나씩 바꾸며 비교하지만 정확한 재현은 보장하지 않습니다. |
texture_seed | 아니요 | P1에서는 텍스처 단계 비교용 시드입니다. P1에서는 동일한 표면 결과를 보장하지 않습니다. |
요금
$0.72 / 모델
P1은 모델이 전달될 때 한 번 과금합니다. 메시 기본 요금에 generate_texture 또는 generate_pbr이 켜져 있으면 텍스처 요금을 더합니다. detailed와 extreme(8K)은 각각 별도 품질 단계이며 fast는 standard와 같은 요금입니다. 텍스처가 없으면 품질 추가 요금도 없습니다. 다른 P1 설정은 요금을 바꾸지 않으며 실패한 요청에는 과금하지 않습니다.
활용 사례
모바일 게임 소품에 활용합니다
게임이나 AR 장면에 맞춰 면 수를 정하고 실제 표시 거리에서 윤곽을 확인합니다.
출력 준비의 출발점으로 사용합니다
재질 없는 메시를 받아 3D 프린팅이나 자체 텍스처 작업을 준비합니다. 제작 전 벽 두께, 구멍, 치수를 검토합니다.
프롬프트 가이드 및 실전 팁
물체 전체를 보여 줍니다
하나의 물체를 여백과 함께 담습니다. 사선 사진은 깊이를 전달하는 데 도움이 됩니다. image_url에는 10MB 이하의 JPEG, PNG, WebP를 지정합니다. 텍스트 프롬프트는 받지 않습니다.
형태와 마감을 선택합니다
face_limit을 50~20,000으로 지정하거나 생략합니다. 기본 메시에는 generate_texture와 generate_pbr을 모두 끕니다. 나중에 텍스처를 입히려면 uv_unwrap을 유지합니다.
한 번에 하나씩 비교합니다
seed와 texture_seed로 비교 조건을 관리하며 동일한 결과를 보장하지는 않습니다. remove_lighting은 v3.5-20260815에서만 적용되며 auto_size에는 텍스처 출력이 필요합니다. 뒷면과 바닥도 확인합니다.
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/p1/image-to-3d",
"input": {
"generate_pbr": true,
"generate_texture": true,
"image_url": "https://example.com/reference.png",
"model_orientation": "default",
"texture_alignment": "original_image",
"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 레퍼런스에서 확인하세요.







