프린팅 가능성 복구 API

model_url을 보내지 않는 한 필수입니다. 복구할 모델이 속한 작업의 ID로, 예를 들어 이미지로 3D, 멀티 이미지로 3D, 텍스트로 3D, 리메시, 리텍스처, 또는 프린팅 가능성 분석 작업입니다. 이 작업은 API로 생성했고 상태가 SUCCEEDED이며 GLB 모델을 가진 작업이어야 합니다.

벽 두께를 확인한 프린팅 가능성 분석 작업은 해당 프린터와 크기도 함께 전달합니다. 이 경우 어느 쪽도 보내지 않아도 복구 과정에서 벽 두께를 확인하고 얇은 벽을 두껍게 만듭니다. 전송한 printer_type 또는 출력 크기는 분석에서 가져온 값을 대체합니다. model_url에서 가져온 .stl, .fbx, .gltf 파일의 프린팅 가능성 분석 작업은 작동하지 않습니다. 대신 해당 파일을 model_url로 보내세요.

input_task_id를 보내지 않는 한 필수입니다. 복구할 모델을 공개 URL 또는 data URI로 지정합니다. 둘 다 보내면 Meshy는 input_task_id를 사용합니다.

http 또는 https URL의 경우, 모델은 최대 400MB의 .glb, .gltf, .obj, .fbx, .stl 파일이어야 합니다. data URI는 최대 100MB의 base64 GLB(data:model/gltf-binary;base64,...) 또는 glTF(data:model/gltf+json;base64,...) 파일만 담을 수 있습니다. .obj, .fbx, .stl 파일은 http 또는 https URL로 보내세요.

100MB를 초과하는 파일은 다음 규칙도 따라야 합니다:

• GLB, glTF, FBX, OBJ 파일은 최대 10,000,000개의 면을 가질 수 있습니다. Meshy는 면을 삼각형 기준으로 계산하므로, 사각형은 2개로 계산되고 여러 번 그려진 메시는 복사본마다 한 번씩 계산됩니다.
• FBX 파일은 바이너리 FBX 7.1 이상이어야 합니다.
• GLB 또는 glTF 파일은 Draco 압축을 사용하면 안 됩니다.

Meshy 다운로드 URL(assets.meshy.ai/…?Expires=…&Signature=…)은 서명되어 있으며 해당 작업의 expires_at에 도달하면 작동을 멈춥니다. 작업을 다시 조회해도 갱신되지 않습니다. Meshy로 만든 모델의 경우 대신 input_task_id를 보내세요. 이는 Meshy가 소스 작업을 보존하는 동안 작동합니다(에셋 보존 참고). 그 이후에도 모델을 사용하려면 expires_at 이전에 다운로드한 후 직접 보유한 사본을 보내세요.

투명 배경(RGBA)이 적용된 미리보기도 함께 렌더링할지 여부입니다. 작업을 조회할 때 alpha_thumbnail_url로 반환됩니다. thumbnail_url은 변경되지 않습니다.

사용하려는 프린터입니다. 이 값은 복구 작업이 목표로 하는 최소 벽 두께를 설정합니다. printer_type 없이 출력 크기를 보내면, input_task_id의 프린팅 가능성 분석 작업이 프린터 정보를 제공하지 않는 한 Meshy는 fdm을 사용합니다.

사용 가능한 값:

• fdm: 필라멘트, 최소 벽 두께 1.0mm
• sla: 레진, 최소 벽 두께 0.8mm
• full_color: 풀컬러, 최소 벽 두께 2.0mm

다른 값을 보내면 400이 반환됩니다.

출력물의 높이(밀리미터)로, 1에서 1000 사이입니다. 범위를 벗어난 값은 400을 반환합니다. 이 값 또는 intended_print_longest_side_mm 중 하나만 보내세요.

GLB 입력에서만 작동합니다. .glb 파일이 아닌 model_url의 경우 대신 intended_print_longest_side_mm을 보내세요.

출력물의 가장 긴 변 길이(밀리미터)로, 1에서 1000 사이입니다. 범위를 벗어난 값은 400을 반환합니다. 모든 입력 형식에서 작동합니다.

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

• 파라미터 누락: input_task_id와 model_url 모두 보내지 않았습니다.
• 잘못된 UUID: input_task_id가 유효한 UUID가 아닙니다.
• 잘못된 모델 URL: model_url의 형식이 올바르지 않거나, 지원되지 않는 스킴을 사용하거나, 지원되지 않는 파일 확장자를 가지고 있습니다.
• 모델 파일이 너무 큼: model_url 파일이 http 또는 https URL 기준 400MB를 초과하거나, data URI 기준 100MB를 초과합니다.
• 면 개수 초과: model_url 파일이 100MB를 초과하는 GLB, glTF, FBX, OBJ 파일이며 면 개수가 10,000,000개를 초과합니다. 면 개수를 줄인 후 파일을 다시 보내세요.
• 100MB를 초과하는 ASCII FBX: model_url 파일이 100MB를 초과하는 ASCII FBX입니다. 바이너리 FBX 또는 GLB로 보내세요.
• 읽을 수 없는 모델 파일: model_url 파일이 100MB를 초과하며, Meshy가 헤더를 읽을 수 없습니다. 예를 들어 Draco로 압축된 GLB 또는 glTF, 혹은 7.1보다 오래된 바이너리 FBX인 경우입니다.
• 모델 헤더가 너무 복잡함: model_url 파일이 100MB를 초과하며, 헤더에 확인할 메시, 노드, 레코드가 너무 많습니다. 파일 내 객체 수를 줄인 후 다시 보내세요.
• 모델 파일을 다운로드할 수 없음: model_url에서 오류가 반환되었습니다. 대개 서명된 Meshy 다운로드 URL이 만료된 경우입니다. 작업을 다시 조회해도 동일한 만료 시점을 가진 동일한 URL이 반환됩니다. 직접 보유한 파일 사본을 보내거나, Meshy가 소스 작업을 보존하는 동안 input_task_id를 보내세요.
• 작업이 완료되지 않음: input_task_id 작업이 아직 대기 중이거나, 진행 중이거나, 실패했습니다.
• GLB 누락: input_task_id 작업에 복구할 GLB 모델이 없습니다.
• 잘못된 출력 크기: intended_print_height_mm 또는 intended_print_longest_side_mm이 1에서 1000 범위를 벗어났거나, 요청에 둘 다 포함되어 있습니다.
• 알 수 없는 프린터 유형: printer_type이 fdm, sla, full_color 중 하나가 아닙니다.
• GLB가 아닌 모델에 높이 지정: 요청에 intended_print_height_mm과 .glb 파일이 아닌 model_url이 포함되어 있습니다. 대신 intended_print_longest_side_mm을 보내세요.
• 이 모델은 높이로 크기를 지정할 수 없음: 요청한 높이, 또는 기본값인 150mm 기준으로 모델의 가장 긴 변이 1~1,000mm 범위를 벗어납니다. 모델이 평평하거나 Meshy가 크기를 판단할 수 없는 경우에도 발생합니다. 대신 intended_print_longest_side_mm을 보내세요. .glb 형식의 model_url과 일부 input_task_id 작업의 경우, Meshy는 작업이 시작된 이후에야 이를 발견하며, 이 경우 작업은 FAILED로 종료됩니다.
• 사용할 수 없는 STL 크기: 요청에 크기 없이 printer_type이 포함되어 있으며, Meshy가 .stl 파일 자체의 가장 긴 변을 읽을 수 없거나 그 값이 1~1,000mm 범위를 벗어납니다. intended_print_longest_side_mm을 보내세요.

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

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

예를 들어:

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

input_task_id가 이 엔드포인트로 복구할 수 없는 저부조(bas-relief) 모델입니다. 메시지는 This model type does not support this operation입니다. 다른 모델을 보내세요.

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

속도 제한을 초과했거나, 대기 중인 작업이 너무 많습니다. 잠시 기다린 후 다시 시도하세요. 속도 제한을 참고하세요.

생성 응답에서 제공된 작업 ID입니다.

삭제할 작업의 ID입니다.

반환할 페이지 번호이며, 1부터 시작합니다.

페이지당 작업 수이며, 최대 100까지 가능합니다.

정렬 순서입니다.

사용 가능한 값:

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

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

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

태스크 유형이며, 항상 print-repair입니다.

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

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

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

태스크가 생성된 시각으로, 유닉스 밀리초 단위입니다.

태스크가 시작된 시각으로, 유닉스 밀리초 단위입니다. 태스크가 시작되기 전까지는 0입니다.

태스크가 완료된 시각으로, 유닉스 밀리초 단위입니다. 태스크가 완료되기 전까지는 0입니다.

태스크 결과가 만료되는 시각으로, 유닉스 밀리초 단위입니다. 태스크가 완료되기 전까지는 0입니다.

태스크가 실패했을 때의 오류 세부 정보입니다. 태스크가 실패하지 않았다면 null입니다. 오류를 참고하세요.

복구된 모델의 다운로드 URL입니다. 입력 형식과 일치하는 키만 존재합니다. 태스크가 생성하지 않은 형식은 빈 문자열이 아니라 키 자체가 없습니다.

복구된 모델의 미리보기 이미지를 위한 다운로드 URL입니다.

배경이 투명한(RGBA) 버전의 thumbnail_url에 대한 다운로드 URL입니다. 태스크를 생성할 때 alpha_thumbnail: true를 지정했고 Meshy가 투명 미리보기를 렌더링한 경우에만 존재합니다.

항상 빈 배열입니다. 복구 작업은 입력 지오메트리만 유지하며 텍스처를 다시 베이크하지 않습니다.

태스크가 사용한 크레딧 수입니다. 태스크가 SUCCEEDED일 때는 10이고, FAILED 태스크의 경우 0인데, 이는 태스크가 실패하면 Meshy가 크레딧을 환불하기 때문입니다.

복구에 사용된 프린터와 크기이며, 사용자가 직접 보낸 값이든 Meshy가 프린팅 가능성 분석 태스크에서 재사용한 값이든 상관없습니다. 벽 두께 복구에서는 태스크가 PENDING 상태일 때를 포함해 처음부터 존재합니다. Meshy가 아직 알지 못하는 값은 null입니다.

벽 두께 복구가 수행한 작업입니다. 벽 두께 복구가 성공한 이후에 존재합니다.