Auto Split API

분할할 모델이 속한 작업의 ID입니다. 해당 작업의 상태는 SUCCEEDED여야 합니다. 다음 작업 유형을 사용할 수 있습니다:

• 이미지로 3D
• 멀티 이미지로 3D
• 텍스트로 3D의 preview 또는 refine 작업
• 리텍스처
• 리메시
• 변환
• 크기 조정

모델은 Meshy 6 또는 Meshy 7로 생성된 것이어야 합니다. 즉 ai_model이 meshy-6-lite, meshy-6, meshy-7, meshy-7.1, 또는 latest로 설정되어야 합니다. Smart Topology 모델(meshy-t2 및 meshy-t2.5)은 지원되지 않습니다. refine, 리텍스처, 리메시, 변환, 또는 크기 조정 작업의 경우, 이 규칙은 해당 작업이 시작된 원본 모델에 적용됩니다. 업로드된 모델로부터 생성된 리텍스처, 리메시, 변환, 또는 크기 조정 작업은 400을 반환합니다.

모델은 최대 8,000,000개의 면(face)을 가질 수 있습니다. 더 많은 면을 가진 모델은 400을 반환합니다. 이 경우 먼저 해당 모델에 리메시 작업을 실행한 다음, 리메시 작업의 ID를 대신 전송하세요.

텍스처가 적용된 모델도 분할할 수 있습니다. 부품에 텍스처를 유지하려면 keep_texture: true를 전송하세요.

모델을 부품으로 나누는 방법입니다.

사용 가능한 값:

• auto: Meshy가 절단 위치를 직접 결정하며 prompt는 무시합니다. 600자를 초과하는 prompt는 여전히 400을 반환합니다.
• by_parts: Meshy가 prompt에서 지정한 구조적 부품(예: 머리, 팔, 몸통)을 따라 절단합니다.
• by_color: Meshy가 prompt에서 지정한 색상 영역을 따라 절단합니다. Meshy는 입력 모델의 텍스처가 아니라 원본 이미지에서 해당 영역을 찾습니다. 입력은 업로드된 이미지로부터 이미지로 3D 또는 멀티 이미지로 3D를 통해 생성된 것이어야 합니다. 그 외의 입력은 400을 반환합니다. 멀티 이미지로 3D의 경우, Meshy는 첫 번째 원본 이미지를 사용합니다.

생성할 파일 형식입니다. Meshy는 항상 glb를 생성하여 model_urls로 반환하며, 추가로 목록에 지정한 다른 형식도 생성합니다.

사용 가능한 값:

• glb
• obj
• fbx
• stl
• usdz
• blend
• 3mf

stl을 제외한 모든 형식은 씬 객체를 지원하며 각 부품을 별도의 객체로 보관합니다. STL 파일은 별도의 객체를 보관할 수 없으므로, Meshy는 layout에 따라 배치한 부품들을 하나의 솔리드로 결합합니다. 슬라이서에서 각 부품을 개별적으로 선택할 수 있게 하려면 3mf를 요청하세요.

keep_texture: true인 경우, 다음 형식은 텍스처를 보관합니다:

• glb, fbx, usdz, blend: 텍스처가 파일 내에 포함됩니다.
• obj: 텍스처는 머티리얼 파일에 포함되며, model_urls에서 mtl로 반환됩니다.
• stl 및 3mf: 파일에는 텍스처 없이 지오메트리만 포함됩니다.

Meshy가 모든 파일 형식 및 썸네일에서 부품을 배치하는 방식입니다.

사용 가능한 값:

• assembled: Meshy가 원본 모델에 있던 위치 그대로 부품을 유지합니다.
• on_plate: Meshy가 부품을 평평하게 눕혀 빌드 플레이트 위에 펼쳐 놓아 바로 슬라이싱할 수 있게 합니다. 이는 웹 앱의 On Plate 보기와 동일한 배치입니다.

두 레이아웃 모두에서 Meshy는 내보내기 전에 절단으로 생긴 찌그러진 조각이나 점과 같은 파편을 제거하므로, 받은 모든 부품은 출력 가능합니다. 씬 객체를 지원하는 형식은 부품당 하나의 객체를 가지며, stl은 부품들을 하나의 솔리드로 결합합니다.

입력 모델의 텍스처를 부품에 유지할지 여부입니다. true로 설정하면 모든 부품에 입력의 텍스처가 적용되고, 작업은 texture_urls로 맵을 반환합니다. false로 설정하면 각 부품에 단색 정점 색상이 적용됩니다.

true로 설정하면 작업 시간이 약 두 배로 늘어나며, 크레딧 비용은 변하지 않습니다. 텍스처가 없는 입력은 false일 때와 동일하게 분할됩니다. Meshy가 텍스처를 유지할 수 없는 경우, 작업은 오류 코드 textured_split_refused와 함께 실패합니다. 오류를 참고하세요.

인쇄된 부품이 서로 맞물리도록 각 절단면에 장부맞춤(mortise-and-tenon) 커넥터를 추가할지 여부입니다.

요청을 실행할 수 없습니다. 오류 메시지에 어떤 문제가 발견되었는지 나와 있습니다. 예를 들면:

• prompt 누락: mode가 by_parts 또는 by_color인데 prompt가 없습니다.
• 분할을 요청하지 않거나 부품이 너무 많은 prompt: prompt가 모델을 하나로 유지하라고 요청하거나, 10개를 초과하는 부품을 지정합니다. by_parts와 by_color는 1개에서 10개까지의 이름 지정된 부품을 허용합니다. Meshy는 이 요청에 대해 과금하지 않습니다.
• 지원되지 않는 입력 작업: input_task_id가 성공한 지원 대상 유형의 작업이 아니거나, Meshy 6 또는 Meshy 7로 생성되지 않았습니다.
• 참조 이미지 없음: mode가 by_color인데, 입력이 업로드된 이미지로부터 생성되지 않았습니다.
• 범위를 벗어난 커넥터: connector_size 또는 connector_height가 0.1에서 0.8 범위를 벗어났습니다.

요청을 수정한 후 다시 전송하세요. 오류를 참고하세요.

API 키가 없거나 유효하지 않습니다. Authorization 헤더를 확인하세요.

예를 들면:

• 크레딧 부족: 계정에 이 작업을 수행할 충분한 크레딧이 없거나, 계정이 크레딧 한도에 도달했습니다. 크레딧 잔액을 확인한 후 다시 시도하세요.
• 무료 플랜: 작업을 생성하려면 유료 플랜이 필요합니다. 구독 설정에서 플랜을 업그레이드한 후 다시 시도하세요.

다음 중 하나가 해당됩니다:

• 콘텐츠 moderation이 prompt를 차단했습니다. 메시지는 explicit content 또는 prohibited content입니다. prompt를 수정한 후 다시 시도하세요.
• input_task_id가 양각(bas-relief) 모델이며, 이 엔드포인트는 이를 분할할 수 없습니다. 메시지는 This model type does not support this operation입니다. 다른 모델을 전송하세요.

input_task_id가 존재하지 않거나 사용자의 계정에 속하지 않습니다. ID를 확인하고, 해당 작업을 생성한 계정의 API 키를 사용하세요.

속도 제한을 초과했습니다. 잠시 기다린 후 다시 시도하세요. 속도 제한을 참고하세요.

by_parts 및 by_color 요청은 계정당 분당 12건의 prompt 읽기 한도를 공유합니다.

prompt에 의한 분할(by_parts 및 by_color)이 일시적으로 사용할 수 없습니다. 나중에 다시 시도하거나, 여전히 동작하는 mode: "auto"를 전송하세요. Meshy는 이 요청에 대해 과금하지 않습니다.

생성 응답에서 받은 작업 ID입니다.

삭제할 작업의 ID입니다.

반환할 페이지 번호입니다. 1부터 시작하며 기본값은 1입니다.

페이지당 작업 수이며 최대 100까지 가능합니다. 기본값은 10입니다. Meshy는 이보다 큰 값을 100으로 처리합니다.

정렬 순서입니다.

사용 가능한 값:

• +created_at: 오래된 순
• -created_at: 최신 순

생성 응답에서 받은 작업 ID입니다.

작업 ID입니다. 불투명한 문자열로 취급하고, 그 형식에 의존하지 마세요.

작업 유형이며, 항상 print-split입니다.

분할된 모델의 다운로드 URL이며, 요청한 포맷마다 하나씩 존재합니다. 요청하지 않은 포맷은 키가 없습니다. 씬 객체를 지원하는 포맷은 각 파트를 별도의 객체로 유지하며, stl은 파트들을 하나의 솔리드로 융합합니다.

요청한 layout으로 분할된 모델의 미리보기 이미지를 다운로드할 수 있는 URL입니다. 파트가 텍스처를 유지하는 경우, 미리보기에 이를 반영해 보여줍니다. 그렇지 않으면 각 파트는 자체 색상을 갖습니다.

분할된 모델의 텍스처 맵으로, 객체 하나로 이루어진 배열입니다. 모든 파트가 이 맵들을 공유합니다. keep_texture가 true이고 입력 모델에 텍스처가 있는 경우에만 존재합니다.

배경이 투명한(RGBA) thumbnail_url 버전을 다운로드할 수 있는 URL입니다. 작업이 성공하고 Meshy가 투명 미리보기를 렌더링한 경우에만 존재합니다.

Meshy가 prompt를 무시했는지 여부입니다. by_parts 또는 by_color 요청의 prompt가 어떤 파트도 지정하지 않아서 Meshy가 대신 모델을 자동으로 분할한 경우 true가 됩니다. 이 경우 결과물의 파트 이름은 사용자가 지정한 것이 아니라 Meshy가 지정한 것입니다. PENDING부터 존재합니다. auto 작업이거나 Meshy가 prompt를 따른 경우에는 Meshy가 이 필드를 생략합니다.

분할로 생성된 인쇄 가능한 파트의 수입니다. 씬 객체를 지원하는 포맷은 파트당 하나의 객체를 가집니다. stl은 파트들을 하나의 솔리드로 융합하지만, part_count는 여전히 이를 개수로 포함합니다. 내보내기 전에 Meshy는 인쇄 가능한 파트가 될 수 없는 붕괴된 얇은 조각을 제거하며, 이는 개수에 포함하지 않습니다.

작업이 얼마나 진행되었는지를 백분율로 나타냅니다. 작업이 시작되기 전까지는 0이고, 성공하면 100입니다.

작업 상태이며, PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED 중 하나입니다.

대기열에서 이 작업보다 앞에 있는 작업의 수입니다. 이 값은 작업이 PENDING 상태일 때만 의미가 있습니다.

작업이 생성된 시간으로, 유닉스 밀리초 단위입니다.

작업이 시작된 시간으로, 유닉스 밀리초 단위입니다. 작업이 시작되기 전까지는 0입니다.

작업이 종료된 시간으로, 유닉스 밀리초 단위입니다. 작업이 종료되기 전까지는 0입니다.

작업 결과가 만료되는 시간으로, 유닉스 밀리초 단위입니다. 작업이 종료되기 전까지는 0입니다.

작업이 실패했을 때의 오류 세부 정보입니다. 오류를 참조하세요.

안전성 검사가 입력 모델을 거부하면, 작업은 task_error.type이 invalid_input으로, task_error.code가 provider_content_refused로 설정된 채 실패합니다. 다른 모델을 보내세요. 오류를 참조하세요.

keep_texture: true인 경우, Meshy가 텍스처를 유지할 수 없으면 작업은 task_error.code가 textured_split_refused로 설정된 채 실패합니다. 오류를 참조하세요.

작업에 사용된 크레딧의 수입니다. 항상 존재합니다. Meshy가 작업을 수락한 후에는 10이며, FAILED 작업의 경우에는 0인데, 이는 작업이 실패하면 Meshy가 크레딧을 환불하기 때문입니다. PENDING 작업을 삭제해도 환불됩니다.