메시 데시메이션

POST /v3/mesh/decimate

모델 폴리곤 수를 줄이고 하이 폴리 모델을 로우 폴리 모델로 변환합니다.

요청 매개변수

요청 헤더

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

요청 본문

매개변수	유형	필수	기본값	설명
input	문자열	예	—	모델 소스. `task_`로 시작하는 task_id 또는 `file_`로 시작하는 file_token를 허용합니다.
model	문자열	아니요	`v2.0`	리토폴로지 버전: `v3.0`(삼각형 35 크레딧 / 사각형 40, `smart_uv` 지원), `v2.0`(30 크레딧), `v1.0`(기본 감소)
face_limit	정수	아니요	적응형	목표 면 수. v3.0 / v2.0: 삼각형 500–20000, 사각형 500–10000(생략 시 자동). v1.0: 필수, 삼각형 최대 2000000, 사각형 최대 150000
quad	부울	아니요	`false`	쿼드 메시 출력
part_names	문자열[]	아니요	—	데시메이트할 부품 이름 목록
bake	부울	아니요	`true`	로우 폴리 모델에 텍스처 굽기
smart_uv	부울	아니요	`false`	리토폴로지와 함께 UV를 펼칩니다. `model=v3.0`에서만 유효하며 다른 버전은 400(1004)을 반환합니다. 추가 비용 없음

요청 예시

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

import requests

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

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

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

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

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

응답

성공적인 대응

JSON

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

응답 필드

매개변수	유형	설명
code	정수	상태 코드. `0`는 성공을 나타냅니다.
data.task_id	문자열	데시메이션 진행 상황 및 결과를 폴링하는 데 사용되는 고유 작업 식별자

오류 코드

HTTP 상태 코드	오류 코드	설명	추천
429	2000	생성 한도를 초과했습니다.	요청 속도를 줄이고 나중에 다시 시도하세요.
400	2002	지원되지 않는 요청 매개변수	요청 본문 매개변수 이름 및 값 범위 확인
400	2006	잘못된 입력 소스 작업 유형	task_id가 3D 모델 작업에 해당하는지 확인
400	2007	소스 작업 상태가 성공하지 못했습니다.	데시메이션을 시작하기 전에 소스 작업이 완료될 때까지 기다리세요.
403	2010	크레딧이 부족합니다.	크레딧을 충전하고 다시 시도하세요.