스마트 UV

POST /v3/mesh/uv

3D 모델의 UV를 다시 펼치고 기존 텍스처, 리깅, 애니메이션을 새 레이아웃에 다시 매핑합니다.

작업당 20 크레딧입니다. 결과에는 model_url과 UV 레이아웃 미리보기 uv_render_url이 포함됩니다. 입력 모델은 등가 삼각형 80,000개를 넘을 수 없습니다(사각형 1개는 2개로 계산). 초과하면 생성 시에는 접수되지만 작업이 실패하고 크레딧이 환불됩니다.

요청 매개변수

요청 헤더

매개변수	유형	필수	기본값	설명
Content-Type	문자열	예	—	`application/json`
Authorization	문자열	예	—	`Bearer {api_key}`

요청 본문

매개변수	유형	필수	기본값	설명
input	문자열	예	—	모델 소스. task_id, file_token 또는 URL 사용 가능
model	문자열	아니요	`default`	스마트 UV 모델 버전. `default`만 지원
bake	부울	아니요	`true`	기존 텍스처를 새 UV 레이아웃에 베이크할지 여부. `false`이면 UV가 있는 지오메트리만 반환
export_orientation	문자열	아니요	—	내보낼 모델 방향: `+x`, `-x`, `+y`, `-y`
compress	문자열	아니요	—	압축 방식. `geometry`: meshopt 압축

요청 예시

curl -X POST https://openapi.tripo3d.ai/v3/mesh/uv \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {api_key}" \
  -d '{
    "input": "task_abc123",
    "bake": true
  }'

import requests

url = "https://openapi.tripo3d.ai/v3/mesh/uv"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer {api_key}"
}
payload = {
    "input": "task_abc123",
    "bake": True
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())

const url = "https://openapi.tripo3d.ai/v3/mesh/uv";

const response = await fetch(url, {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer {api_key}"
  },
  body: JSON.stringify({
    input: "task_abc123",
    bake: true
  })
});

const data = await response.json();
console.log(data);

응답

성공적인 대응

JSON

{
  "code": 0,
  "data": {
    "task_id": "task_def456"
  }
}

응답 필드

매개변수	유형	설명
code	정수	상태 코드. `0`는 성공을 나타냅니다.
data.task_id	문자열	진행 상황과 결과를 조회하는 작업 고유 ID

오류 코드

HTTP 상태 코드	오류 코드	설명	추천
429	2000	생성 한도를 초과했습니다.	요청 속도를 줄이고 나중에 다시 시도하세요.
400	1004	매개변수 또는 입력이 잘못됨	매개변수 이름, 값, 입력 소스를 확인하세요
403	2010	크레딧이 부족합니다.	크레딧을 충전하고 다시 시도하세요.